<ev:editable>
Define a region on a page where content may be edited within Evance's CMS editor.
Evance allows you to define any number of editable regions on a template. Each is identified by a unique reference scoped locally or globally.
Local scope
A local scope indicates that the content within the region is associated with the current page (Page, Product or Category) either as the full description or as an additional content fragment. For this reason, locally scoped editable regions are supported on Page, Product and Category templates only, and are not supported in layouts.
<ev:editable local ref="fullDescription" />
or
<ev:editable scope="local" ref="fullDescription" />
Global scope
<ev:editable global ref="fullDescription" />
or
<ev:editable scope="global" ref="fullDescription" />
Attributes |
---|
color
Optional
|
global
Optional
|
local
Optional
|
ref
Required
All editable regions require a Locally scoped references must be unique to the template and should not be duplicated.
Page, Product and Category templates may contain any number of additional locally scoped editable regions (as few as possible). Globally scoped references must be unique site-wide. References should adhere to the following naming conventions:
|
scope
Optional
|
Template support
The following templates support locally scoped editable regions ( <ev:editable local>):
Placeholder content is not recommended for locally scoped editable regions, but is better supported by globally scoped regions.
When creating a template you may include default content per editable region. This helps you experiment with your templates without having to use the CMS editor to edit and preview content.
For example you could create a page with the following content:
<ev:editable ref="main">
<h1>Hello, welcome to our store</h1>
<p>Perhaps you'd like to browse our awesome range of products.</p>
</ev:editable>
This allows you to be a little creative and when your theme is installed for the first time users aren't met with a blank space.
Tag nesting
Do NOT nest other <ev:tags>
within an <ev:editable>
tag.