HowTo: integrate the widgEditor editor

widgEditor is a simple rich-text editor available from http://www.themaninblue.com/experiment/widgEditor/. It has the advantage of being extremely simple to install and use, though it's not nearly as full-featured as other options. Here are the step-by-step instructions for integrating it with Siteframe Beaumont.

Step-by-step

Download the latest version of the editor from the site linked above.
Unpack/unzip the archive file and move all the files into the directory widgeditor, which should be in the same directory in which Siteframe is installed. For example, if Siteframe is installed in /var/www/siteframe, then the directory should be /var/www/siteframe/widgeditor.
Edit siteframe.ini and ensure that rich_text_editor="widg".
You can optionally edit the file widgeditor/scripts/widgEditor.js to set your options; for example, if you want to change the default styles used by the editor, change the value of widgStylesheet to point to the correct location.

The editor should now be fully operational. Try editing a new page; if the editor is not visible, check the <HEAD> section of the page to ensure that the widgEditor javascript file is loaded; if not, go back and check your settings thoroughly.

Known Issues

Some Internet Explorer users report very slow text entry. Other IE users have reported no problems. It's not known if this issue is a browser incompatibility issue or perhaps some sort of conflict between the RTE control and something installed on the users' machine.

A few more issues

by cglusky / at 14:47 on April 10, 2006

Just tried it today and had a few issues with FireFox and Safari. Firefox 1.5 has caused a bug in the editor, and Safari should not show the editor at all but does. The developer is working on a new version (according to his blog) that should address these issues. I am holding off for the latest version as I think FCK is nice, but more than I need. Widgedit is a great choice for those who want to offer a basic RTE to only Windows users (for now). I would make sure you do your own user agent check to make sure that the RTE only loads for IE.
R,
Coby