The following are the currently available attributes for Fred Elements.
This defines a Drop Zone where Fred Elements can be dragged from the sidebar and dropped into to create pages. This attribute cannot be empty and must be unique within an Element. While you can create an unlimited number of Dropzones, more than a few might become cumbersome and fragile. Good use cases for multiple Dropzones includes alternate layouts like full width, split pages, pages with sidebars, etc.
<div data-fred-dropzone="left" class="left-content"></div> <div data-fred-dropzone="right" class="right-content"></div>
This is a unique name for each Element, the contents of which should be editable. Elements with this attribute will be saved and processed by Fred. By default, Elements with a
data-fred-name attribute are automatically editable by end users, unless a
contentedtiable="false" is explicitly declared (see next).
The value of this attribute has to be unique in each Element, but you can have multiple instances of an Element on the page and different Elements can share common
data-fred-name attributes without problem.
Note: Because Fred wraps all Elements in a
<div>, you cannot currently use Fred to build elements that would break HTML validation such as table rows, list items, definition lists, etc. This will be solved in a future release.
<!-- Simple editable paragraph --> <p data-fred-name="description">Default value</p> <!-- Editable image --> <img src="http://via.placeholder.com/450x150" data-fred-name="header-image">
When set to
false the content inside of the HTML Element will not be editable for end users, including any nested Dropzone content. This attribute only works when used with
<p data-fred-name="description" data-fred-editable="false" data-fred-target="description">The value from the description field goes here</p>
Defines other HTML attributes (comma separated) to save with the content of the HTML element where supported by the editor, such as alt and title attributes with images.
<img src="http://via.placeholder.com/450x150" alt="Default Alt" data-fred-name="header-image" data-fred-attrs="alt,title">
This allows developers to create user-friendly, self-documenting Elements that inform users what they need to do in order to create content. When set to
false these Element only appear when Fred is active.
<p data-fred-render="false" class="editor-instructions">Add a *Link Location* setting for this Element to make a call to action button appear. (This block is only visible when using Fred.)</p>
This defines the Resource field or TV in which to store content. Content of the Element will be stored in regular Content field and additionally in the specified target. This attribute can’t be used on a dropzone.
- Template Variables (TVs)
Note: using TV targets only stores in text or textarea inputs only, as the actual data is stored as a JSON object. As such, some TV input types defined in the MODX Manager such as select inputs, Google Map Markers, etc., will not work. All TV names must be prefixed with
tv_ in order to save to a TV.
<h1 data-fred-name="title" data-fred-target="pagetitle">Default Page Title</h1>
<h1 data-fred-name="my-tv" data-fred-target="tv_job-title">Targets the "job-title" TV field</h1>
If set to
true the Rich Text Editor will be loaded for editing the content inside this Element.
<div data-fred-name="rte-content" data-fred-rte="true">Default Content</div>
This is useful when you need a limited or expanded set of rich text editor controls than provided by the default configuration, allowing you to specify an overriding alternate RTE config than the default RTE config.
<div data-fred-name="rte-content" data-fred-rte="true" data-fred-rte-config="bold-and-italics-only">The RTE for this content will only show the bold and italics buttons</div>
This option defines a specific Media Source for Elements, using the names of one or more Media Sources, separated by commas for all file types.
<a href="assets/pdfs/brochure.pdf" data-fred-name="brochure" data-fred-media-source="Assets">download our brochure</a>
data-fred-media-source but only for images.
<img src="http://via.placeholder.com/450x150" data-fred-name="header-image" data-fred-image-media-source="Blogs,Images">
Allows you to specify an additional class which is added to the wrapping
<div class="image" data-fred-block-class="special-wrapper"></div>
When Fred is loaded, the markup around it will look as follows:
<div class="fred--block special-wrapper"> <div class="fred--toolbar">…</div> <div class="fred--block_content" data-fred-element-id="5ce33419-44d6-4e30-90db-8c9a62d04763" data-fred-element-title="Image"> <div class="image"></div> </div> </div>
When Fred is not loaded, the processed markup for the element will look as follows:
<div class="image special-wrapper"></div>
The value of this attribute will be added to class for this element only when Fred is not loaded.
<div class="row" data-fred-class="visible-grid foo"></div>
When Fred is loaded, the class is omitted:
<div class="row"> … </div>
When Fred is not loaded, the class is added:
<div class="row visible-grid foo"> … </div>
This allows you to bind the value of another part of the page to another location within one Element.
<div data-fred-name="name" data-fred-render="false">John Doe</div> <div class="modal"> <div class="modal-header" data-fred-bind="name"></div> <div class="modal-content">Hello there</div> </div>
<div class="modal"> <div class="modal-header">John Doe</div> <div class="modal-content">Hello there</div> </div>
document.ready function call. Without using this attribute, you would need to save and reload the page to initialise the newly dropped slider item.
<div class="clock" data-fred-on-drop="initClock">
<div class="clock" data-fred-on-setting-change="reInitClock"></div>
Used by the TinyMCE RTE with a
data-fred-link-page attribute to create links in the MODX format of
[[~2]]. These links are processed into the href target before generating content.
<a href="fred.html" data-fred-link-type="page" data-fred-link-page="2">Fred</a>
Applicable for dropzones. When set, the value used in this attribute will be set in the dropzone's style min-height.
<div data-fred-dropzone="content" data-fred-min-height="50px"></div>
Applicable for dropzones. When set, the value used in this attribute will be set in the dropzone's style min-width.
<div data-fred-dropzone="content" data-fred-min-width="50px"></div>