|
|
sfDoctrineEditableComponentPlugin - 0.2.0This plugin allows to set up edit-in-place components (plain or wysiwyg), typically to enable content administration directly from the a frontend application. |
|
WARNING: This plugin is currently in a very pre-alpha state, do not use in production.
This plugin allows to set up edit-in-place components (plain or wysiwyg), typically to enable content administration directly from the a frontend application.
The plugin uses some cool libs like jQuery, jEditable, jWysiwyg and the Doctrine ORM for persistence. Rich HTML content can be filtered in order to avoid XSS attacks using HTMLPurifier.
Using the native plugin installation system of Symfony:
$ php symfony plugin:install sfDoctrineEditableComponentPlugin
Using SVN:
$ svn co http://svn.symfony-project.com/plugins/sfDoctrineEditableComponentPlugin plugins/
Adds the sfEditableComponentAdminFilter filter in your application's filter.yml file:
sfEditableComponentAdmin:
class: sfEditableComponentAdminFilter
Then, you're ready to run the following tasks:
$ php symfony cache:clear
$ php symfony doctrine:build-all
You must also enable the sfEditableComponent module in the settings.yml file of your application:
all:
.settings:
enabled_modules: [default, sfEditableComponent]
Last, don't forget to publish the assets used by the plugin:
$ php symfony plugin:publish-assets
You can call editable components whithin any template, even if they don't exist yet in the database, this way:
<?php include_component('sfEditableComponent', 'show', array('name' => 'content1')) ?>
<?php include_component('sfEditableComponent', 'show', array('name' => 'content2')) ?>
You can configure the plugin in your app.yml file, in the namespace. You can look at the app.yml file bundled with the plugin, which contains all plugin's default value.
Here are the main options available:
admin_credential: the name of the required credential for edit editable componentcontrols.OK: The label of the submit button in update formcontrols.Cancel: The label of the cancel button in update formcss_class_name: The name of the css classname to use for editable content divsdefault_content.html: The default content to fill an editable HTML component withdefault_content.plain: The default content to fill an editable plan text component withupdate_error: The error to display if the edition of an editable component failsThis plugin is licensed under the terms of the MIT license.
This plugin has been created and is currently maintened by Nicolas Perriault (nperriault at gmail dot com).
