Frontend Editing Module
Maintainer Contact
Marcus Nyeholt, (*1)
, (*2)
Requirements
SilverStripe 3.0, (*3)
Documentation
SilverStripe 2.4 version still available in the ss24 branch, (*4)
The frontend editing module adds the ability to edit HTML based content on
the frontend of your website. Developers specify in their templates the
fields they want to be able to edit, add an include for buttons to help with
switching between edit and standard views, and that's all there is to it., (*5)
Add the following to your project's configuration.yml file, (*6)
---
Name: frontend_config
---
SiteTree:
extensions:
- FrontendEditableExtension
```
In the templates for the page types you would like editable, add the
following in place of raw output fields - for example, instead of `$Content`,
use
$EditableField(Content), (*7)
As well as single fields of the current page, you can use it on
other objects contained in a control block (so long as those
objects have the EditableExtension)
, (*8)
Also in your template, add the following at the top. It includes some
controls for initiating the editor (if you want them). You can provide
your own mechanism for launching the editor, but this is simpler :)
````, (*9)
NOTE after adding the above, when navigating to a page in 'Live' mode,
if you have edit access to the page, hovering your mouse over the bottom
right corner of the screen will display controls for launching the edit
mode. In "Stage" view, these controls should appear immediately., (*10)
API
Defining new plugins for the editor, (*11)
@TODO - for now, see nicedit-image-selector.js or nicedit-url-selector.js as
examples., (*12)
Troubleshooting
- Appending
?stage=Stage&startEditing=true
to the current URL will
open the editor immediately; if this does not happen, check your JS error
console!