Front End Attribute Editor provides three new blocks:
These blocks are very similar, so the details below apply to all the above blocks.
Any single block can be used to edit an attribute for the current page, current user or for the product on a product page. You cannot edit a page or product attribute from another page, or any other user's attributes than the current user. For pages and products, many page or product properties can also be edited.
To allow front end editing of multiple attributes, simply add multiple blocks to the page.
Front End AttributeEditor enables selected users to edit attributes with no further permissions settings to configure. The user(s) enabled to edit an attribute can be selected from:
This tab simply presents a list of attributes and properties available for editing, one of which may be selected. In the case of properties, this is limited to properties that are directly associated with a page or product and have a single value (for example, tiered pricing cannot currently be edited). Please check the screenshots for details.
A consequence of the perversity of some complex marketplace attributes is that they may not be editable through this block. If in doubt, please ask before purchasing.
The edit dialog shown to edit file properties or attributes can be configured to use jQuery.ui, as per concrete5 core dialogs, or Fancybox.
In both cases, form element styling can be selected to follow concrete5 dashboard styling as per ccm.app.css or to be unstyled.
For safety and security the default setting is that html tags should be stripped from all edited properties and attributes.
The assets needed for the editable attributes should be loaded automatically. However, attributes can be strange things and there is no standardised method of loading some obscure attribute assets. Is such cases you may need to manually select for specific object/attribute assets to be loaded using the assets tab of the edit dialog.
The HTML structure of Front End Attribute Editor is generated through a view, a library and a series of elements. However, all items are marked with css classes that can be used to manipulate the layout of items within the block.
For most theming requirements I recommend simply copying the view.php to a new template and the appearance can be substantially changed using the new template's view.css. The name of a template will be automatically inserted as a class in the outermost wrapping element of the block and dialogs, so can be easily used to scope and differentiate block themes.
The color and opacity of the Fancybox lightbox modal overlay may be adjusted using the site constants:
Alternatively, the overlay color and opacity may be hard coded into a view template.
When additional notifications are enabled, the default time the notification is shown is 3000ms. This may be adjusted by the site constant:
For concrete5 versions before 220.127.116.11, select attributes may not save or validate.
For concrete5 versions 18.104.22.168 +, all core attributes can be edited and saved for pages and users.
For attribute types other than core attributes, compatibility is not guaranteed, but may be possible either by default or by adjusting site configuration constants as below.
Inside Front End Attribute Editor, attributes are saved by one of two methods:
From concrete22.214.171.124 onward, method (1) is used by default for all attribute types. Before concrete126.96.36.199, method 2 is used by default.
To change this behaviour, the constant FRONT_END_ATTRIBUTE_SIMULATE_FORM_FOR_TYPES can be set as a comma separated list of attribute type handles or attribute handles, an empty string or as 'ALL_ATTRIBUTE_TYPES'.
The conatsnt FRONT_END_ATTRIBUTE_SKIP_VALIDATIOIN_FOR_TYPES can have similar values to FRONT_END_ATTRIBUTE_SIMULATE_FORM_FOR_TYPES. By default this is 'boolean'. If you have issues with specific attribute types or attributes, you can list them with this constant and the attribute's validateForm method will not be called.
The conatsnt FRONT_END_ATTRIBUTE_FLATTEN_DATA_FOR_TYPES defaults to just 'select'. When enabled for an attribute, the form data is flattened to a plain list and any select option ids are converted to their respective values.
The only use I can see for this option other than the default is for third party attribute types that extend the select attribute type. However, it may also be relevant to other third party attribute types.