Website/App Overlay Guide for Editing Zesty.io Content
Requires node version ^16.x.x
Using NPM
npm install @zesty-io/live-editor
Using Yarn
yarn add @zesty-io/live-editor
Using jsDelivr CDN
<script
type="text/javascript"
src="https://cdn.jsdelivr.net/gh/zesty-io/live-editor@latest/dist/live-editor.production.js"
defer="defer"
></script>
Note, if your website has a strict content security policy or x-frame-options, you will need to add this url to your white list
https://cdn.jsdelivr.net/gh/zesty-io/live-editor@latest/dist/live-editor.production.js
Using React, place this code in your app.js or app loading file
import { ZestyLiveEditor } from "@zesty-io/live-editor"
React.useEffect(() => {
ZestyLiveEditor(data)
}, [])
Using Nextjs, place this in ZestyView.js
, or for custom builds, _document.js
or _app.js
// outside the component near imports
const initLiveEditor = async (data) => {
const { ZestyLiveEditor } = await import("@zesty-io/live-editor")
ZestyLiveEditor(data)
}
// inside the component's function just before the return statement
React.useEffect(() => {
initLiveEditor(props.content)
}, [])
Using Vuejs
<script>
import { ZestyLiveEditor } from "@zesty-io/live-editor"
methods:{
initLiveEditor: function(data) {
ZestyLiveEditor(data)
}
},
beforeMount(){
this.initLiveEditor(data)
},
</script>
Is that the explorer will be a website overlay tool that will guide the user around the data that loads on the page relative to the zesty content management system. The tool will have tabs for searchable on page data, full site navigation, inline editing, website and page health, metadata explorer, image optimization scanning, broken link scanning.
The tool should be built in compiled JavaScript and execute in plain JavaScript so it can run over any installation of zesty, whether it's parsley templating, next js, nuxt, or any custom build.
It should be distributed over npm package manager and yarn, it should also be able to be manually installed from a CDN link.
- Manually:
npm run manual-publish
- Github flow: any merge to main will run a release and publish flow
Zesty is an application that can make any website or text base document on the internet editable. It runs as javascript application and is powered by a Zesty's multi-tenant cloud based API. It would by piping any directing any live domain with a website through WebEngine. Webengine serves the application through and inject content with Parsley, a templating language that connects to the the Zesty API.
##π‘ Design
Figma file https://www.figma.com/file/TsOMa4gbWHgMzWyXH8MXpt/Explorer?node-id=0%3A1
A domain is pointed to Zesty Webengine, and the Zesty Overlay Editor is injected into the page when it renders. The overlay tool lets the user select portions of the page they need to edit, and also gives the user the option to add sections into the page. This is made possible by storing a document which HTML markup and Parlsey is written to. When the document is served, WebEngine will render it by processing and compiling Parsley into a final web document, injecting SEO and webpage needed functionality.
A tablar view of the content editable on the page, when an item is selected, it scrolls you the approate area, highlights it on page, and allows the user to change and save the page. When the content view is selected, a user may select an area on page where they would like to edit contnet, or add a new block to the page (like a image and text block).
Blocks are premade design expeirences. They have premade connections to load content. Blocks will be served from a Parsley HTML repo or served into headless app from a React based npm package managed by Zesty (open-source). A user can preview blocks from a block browser, and select which on they want to inject in page.
Headless applications only need the markup name <Zesty/>
to render on their finished page, and have their application hosted somewhere remote with a URL that can be plugged into Zesty WebEngine, there are two envirnoment for this, Production and Stage. Pages or URLs get registered in Zesty, and the URL is how the page is resolved, which injects into the page where the <Zesty/>
tag is. <Zesty>
can load remotely through a React component, or if the app is loaded through WebEngine only the string <Zesty/>
needs to be present.
The parlsey tag {{current_view}}
and <Zesty/>
function the same. The difference is when Zesty runs the loader
file in zesty runs and controls the page build, which is automated through WebEngine.
loader file explantation
<html> (automated from webengine)
<head></head> (automated from webengine)
<body> (loader wraps the body)
{{current_view}} (injects the view rendered relative to the URL)
</body>
</html> (automated from webengine)
Zesty Overlay using the Rest API (instances-api) to write both content and files.
A view of the pages SEO and meta values which can be edited, this is not limited to SEO meta tags, but open graph tags, scripts, and other head tags. Head tags are injected into the page though WebEngine, prior to Search Engines reading it.
Check here on how to run locally
Check here
- All successfull merge to main will create a release and publish to npm
git checkout main && npm run release
- run
npm run dev
to start the application locally - Open /test/index.html in your browser
- Remove index.html from the browser file path
- use this override domain
https://qzp3zx5t-dev.webEngine.zesty.io/