rainlab / editable-plugin
Editable plugin for October CMS
Installs: 3 913
Dependents: 0
Suggesters: 0
Security: 0
Stars: 17
Watchers: 10
Forks: 15
Open Issues: 0
Type:october-plugin
Requires
- php: >=7.0
- composer/installers: ~1.0
This package is auto-updated.
Last update: 2024-10-11 15:01:30 UTC
README
This plugin allows in-context editing (click to edit) features to the OctoberCMS front-end.
Only allocated content blocks found in the theme can be edited. Content blocks are edited with a WYSIWYG editor for htm
extension and a source editor for txt
and md
file types. It is not suitable for editing partials and pages that have a more delicate structure.
Implementation is simply replacing the {% content %}
tags with the component.
Proof of concept
Note while this plugin works fine, it is created as a proof of concept. Check out these other plugins that offer the same functionality (probably better):
Using the editable component
First you must ensure that the Editable component is attached to the page or layout. Then create a content block using the CMS.
For a content block with the file welcome.htm, that would be located in the /content directory of a theme, it can be displayed on the front end like this:
title = "A page"
url = "/a-page"
[editable]
==
<!-- This content will be editable -->
{% component 'editable' file="welcome.htm" %}
You can also pass the file property when the component is defined, which is an alternative usage suitable for a single content block.
title = "A page"
url = "/a-page"
[editable aboutus]
file = "welcome.htm"
==
<!-- This content will be editable -->
{% component 'aboutus' %}
Replacing existing content blocks with editable content blocks.
An example content block:
{% content "welcome.htm" %}
This block can be made editable by using the following instead:
{% component 'editable' file="welcome.htm" %}
Permissions
Only administrator with the permission Manage content are able to edit content. Administrators must also be logged in to the back-end.
Front-end JavaScript and StyleSheet
The components in this plugin provide custom stylesheet and javascript files to function correctly on the front-end. Ensure that you have {% scripts %}
and {% styles %}
in your page or layout.
The styles also depend on the October JavaScript Framework, so ensure the {% framework %}
tag is also included in your page or layout.