JCE Editor is a superior replacement for the default TinyMCE editor that ships with Joomla.
The following refers to JCE Editor 1.5.7 on Joomla 1.5 and JCE 2.0.21 on Joomla 2.5.4, and were last updated 19 April 2012.
As with any extension, back up your site before installing JCE.
Download the latest stable “JCE Installation Package” for your version of Joomla. If users will be using it in a language other than English, download language packs as needed. Paid subscribers may also download desired plugins.
Install JCE and any plugins in the usual way. Language packs will be installed later as described below.
Go to Extensions – Plugin Manager and insure that the plugin “Editor – JCE” is enabled. It is a good idea to disable all other editors unless they will be used.
Go to Site – Global Configuration – Site – Site Settings and set “Default WYSIWYG Editor” to JCE. Press Save.
You may have to explicitly enable JCE for individual users. In Joomla 1.5, go to Site – User Manager; in 2.5 go to Users – User Manager. Select the user, and in Basic Configuration – User Editor, select JCE.
If you have language packs to install, go to Components – JCE Administration – Install Add-Ons. Here, install your language packs in the normal way. Confirm in Components – JCE Administration – Install Add-Ons – Languages that all desired languages have been installed.
Go to Components – JCE Administration – Global Configuration and configure as desired. Non-default settings I usually set include:
- Cleanup and exit: Enable cleanup HTML
- Format and visualization: Use Template CSS File; set Container Element and Newlines to paragraph
From here how I proceed depends upon the version of JCE being used:
JCE 1.5 (e.g. for Joomla 1.5)
Go to Components – JCE Administration – Plugins. I usually disable the following: Font Size Select, Style Select, StrikeThrough, Justify (Full, Center, Left), HTML, Code Cleanup, New Document, Justify (Right), Bold, Italic, Underline, Font Select, Anchor, Font Back Colour, Link, Font Fore Colour, Visual Aid, Horizontal Rule, Safari Browser Support, Paste, Directionality, Emotions, Fullscreen, Preview, Print, Layers, Styles, XHTML Xtras, Image Manager. The more you disable the faster it will load for the end user.
Apropos the above, I have observed despite its name, even unsophisticated users prefer the “advanced link” plugin over the basic one (named simply “link”). Conversely, even power users find the simple image plugin (“Image”) to be more intuitive than the advanced “Image Manager”.
Go to Components – JCE Administration – Groups and open the Default group. If Joomla Estate Agency (JEA) is installed, then in Setup – Restrictions – Types, make sure Jea Agent is selected. If you changed this setting, press Apply. In Plugin Parameters – Spell Checker – Languages, the default setting is “English=en”. If you want users to be able to spell check other languages, append to it (without any space and without quote marks) “,Español=es” or as appropriate for the desired language. Press Save.
I like to configure two user groups for JCE. The existing default group I configure for unsophisticated users, removing most buttons to provide an uncomplicated experience and to disallow manual styling that might override the template’s styling. Then I create a new group for administrators, adding those buttons that I or another administrator would find useful (e.g. Advanced Code Editor, Styles).
You may wish to change the layout of the remaining, enabled plugins. In Components – JCE Administration – Groups, click on Default and choose Layout. In the group layout editor there are five rows for components; empty rows must be at the bottom or JCE will not display. Have a second browser tab open showing a JCE edit window open, and refresh it as you make your changes to the JCE component layout.
If you notice a button available that no one will need, disable the corresponding plugin (Components – JCE Administration – Plugins) so that JCE will load faster for the end user.
A layout that worked well for one client is consciously modeled on the toolbar layout of LibreOffice:
Spell checker, clipboard actions, undo, redo, advanced link, unlink, search replace, indent, outdent, numbered list, bullet list, subscript, superscript, character map, spacer, remove format, advanced code editor (administrative group only), spacer, visual characters, help
Format select, tables, spacer, non-breaking, article breaks, spacer, image manager (simple)
JCE 2.0 (e.g. for Joomla 2.5)
TODO: Finish this section.
TIPS AND TRICKS
JCE Editor is free software and depends upon voluntary subscriptions from users to sustain the project. If you find it useful, please consider subscribing.