Index: openacs-4/packages/acs-templating/tcl/richtext-procs.tcl =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-templating/tcl/richtext-procs.tcl,v diff -u -r1.47.2.3 -r1.47.2.4 --- openacs-4/packages/acs-templating/tcl/richtext-procs.tcl 8 Jun 2009 14:52:35 -0000 1.47.2.3 +++ openacs-4/packages/acs-templating/tcl/richtext-procs.tcl 9 Jun 2009 15:30:43 -0000 1.47.2.4 @@ -299,14 +299,20 @@ ad_proc -public template::widget::richtext { element_reference tag_attributes } { + +

Implements the richtext widget, which offers rich text editing options. - This version supports the xinha editor. + This version supports the xinha and tinymce + editors. If the acs-templating.UseHtmlAreaForRichtextP parameter is set to true (1), - this will use the htmlArea WYSIWYG editor widget. + this will use the WYSIWYG editor widget set in the acs-templating.RichTextEditor + parameter. Otherwise, it will use a normal textarea, with a drop-down to select a format. The available formats are: +

+ + +

You can also parameterize the richtext widget with a 'htmlarea_p' attribute, which can be true or false, and which will override the parameter setting.

- The default editor in wysigwig mode is rte. In oder to use xinha, one - has to use 'editor xinha' in the options of the form field. The following - options for xinha may be specified: + The available editors in wysigwig mode are xinha and tinymce. In order to + use xinha, one has to use 'editor xinha' in the options of the form field. + The following options for xinha may be specified:

These options are used by the OacsFs plugin

  • javascript: provide javascript code to configure - the xinha widget and its plugins. The configure object is called xinha_config. + the xinha widget and its plugins. The configure object is called xinha_config. + + +

    Example to use xinha with only a few controls: +

         {options {editor xinha plugins {OacsFs} height 350px javascript {
             xinha_config.toolbar = [
                                     ['popupeditor', 'bold','italic','createlink','insertimage','separator'],
                                     ['killword','removeformat'] ];
         }}}
         
    - - - Example for the use of the xinha widget with options: + +

    + Example for the use of the xinha widget with options:

         text:richtext(richtext),nospell,optional 
         {label #xowiki.content#} 
         {options {editor xinha plugins OacsFs height 350px file_types %pdf%}}
         {html {rows 15 cols 50 style {width: 100%}}}
         
    +

    Caveat: the three adp-files needed for the OpenACS file selector (insert-image, insert-ilink and file-selector) are currently part of the xowiki package, since acs-templating is per default not mounted. This is hopefully only a temporal situation and we find a better place. +

    - Note that the rich-rext editor interacts with blank-master.tcl and - blank-master.adp. + Example for the use of the tinymce widget with options: +

    +    text:richtext(richtext),nospell,optional 
    +    {label #acs-subsite.Biography#} 
    +    {options {theme simple plugins "oacsimage,oacslink,style"}}
    +    {html {rows 15 cols 50 style {width: 100%}}}
    +    

    + See TinyMCE + documentation for a full list of available options +

    + Caveat: the scripts needed for the oacsimage and oacslink plugins require + acs-templating to be mounted. This is a temporary situation until we find + a better way to handle plugins. + +

    + Note that the richtext editors interact with blank-master.tcl and + blank-master.adp. +

    Derived from the htmlarea richtext widget for htmlarea by lars@pinds.com
    modified for RTE http://www.kevinroth.com/ by davis@xarg.net
    - xinha support by gustaf.neumann@wu-wien.ac.at + xinha support by gustaf.neumann@wu-wien.ac.at
    + tinymce support by oct@openacs.org } { upvar $element_reference element