ruby script/plugin install http://svn.pluginaweek.org/trunk/plugins/radiant/rich_text_editor/

Description
===========

Since many clients often do not know html and/or do not want to learn the syntax, rich-text editors are oftentimes the solution to their problems. This plugin adds the ability to enable rich-text editing for certain types of models (e.g. pages, snippets, layouts) and specific layouts.

Usage
=========

Enabling for specific models
--------------------------------------------

You can enable the rich text editor for pages, snippets, and layouts by adding the following Radiant::Config options:

  extensions.rich_text_editor.active_for.page? = true
  extensions.rich_text_editor.active_for.snippet? = true

You can also enable it on a controller/action basis like so:

  extensions.rich_text_editor.active_for.page.new? = true
  extensions.rich_text_editor.active_for.page.edit? = true

It is generally recommended that you only enable the rich text editor for pages since snippets and layouts are not always particularly useful with rich text editing.

Enabling for specific layouts
-------------------------------------------------

When enabling the rich text editor for pages, you must also specify which layouts are enabled. This is because not all layouts are html, such as css and rss. To enabled rich text editing for a specific layout, you can add a Radiant::Config option like so:

  extensions.rich_text_editor.active_for.page.layout.normal? = true

where normal is the lowercase/underscored name of the layout.

Adding Radius tags in rich text
---------------------------------------------------

You may notice that you *can't* add radius tags when using the rich text editor since the syntax conflicts with HTML syntax. To work around this, you can use Radius tags by replacing < and > with [ and ], respectively, like so:

  < strong>This< /strong> shows using radius tags on the page, [r:title /]

There is currently no advanced documentation for this plugin.