Lotus Web Content Management – EditLive! Rich Text Editor Troubleshooting Guide for Common Scenarios.

This documentation provides details on troubleshooting if any issues are encountered while working with Lotus Web Content Management (WCM) Ephox Rich Text Editor (RTE). Below are some of the most common issues reported to Product Support.

How to get EditLive! RTE (Ephox) for WCM

EditLive! RTE is available with WCM 6.1.x or later. Once you upgrade WebSphere Portal / Web Content Management to 6.1.0.3 or later, EditLive! is available out of the box and is ready to use. If you use version 6.1.0.0 to 6.1.0.2, then you must download the EditLive! Editor from the Passport Advantage website and install the Ephox Editor. The recommended approach is to upgrade to 6.1.0.3 or later.

EditLive! Editor displays as trial version

Ensure that the EditLive! RTE is downloaded from the Passport Advantage website and is the IBM-licensed application. Also if you installed the trial version prior to installing the IBM-licensed version, you must uninstall the trial version completely and then install the version downloaded from Passport Advantage website.

Editlive! RTE not available / working after applying WCM cumulative fixes

In version 6.1.0.3 and later, EditLive! RTE is included with the product and is redeployed / updated as part of the update-wcm task executed in the cumulative fix install process. This situation may occur mostly likely with version 6.1.0.2 or earlier. In version 6.1.0.2 or earlier, the update-wcm task redeploys/updates the WCM portlets and as part of this update, the Ephox-related files are deleted. You must redeploy / copy the EditLive! files again as documented in the EditLive! ReadMe file included in the EditLive! RTE download.

After upgrading to 6.1.0.3, Ephox not working.

EditLive! RTE is now completely integrated with WCM and is available out of the box with versions 6.1.0.3 and later. During the 6.10.3 upgrade, the EditLive! Editor is now deployed as a separate application and configured. Post-upgrade, to use the EditLive! RTE, you must access the Configure or Edit Shared settings for the WCM Authoring Portlet and select the Extended Editor in the Rich Text Option section. This should resolve the issue. You do not have to copy any EditLive! files after version 6.1.0.3 as you do in 6.1.0.2 or earlier versions.

Cannot see the option for Extended Editor after upgrading to WCM v6.1.0.4/v6.1.5.1

This is controlled by the property wcm.editor.extended which is set in WAS here:



It is possible that the property did not get set correctly during upgrade. One can confirm this by reviewing the logs __WP_PTF_6104_wp.ptf.config_install.log or __WP_PTF_6104_wp.ptf.config_install.log along with the other logs. Message like below
Result: [wplc-create-res-env-custom-property-directory] (Resource ENV Provider) J2EEResourceProperty property wcm.editor.extended create success.

By manually creating this value as above, restarting the server the issue should be resolved.

Using the EditLive! Editor in local Web content viewer portlets

To use the EditLive! Editor in a local Web content viewer portlet, you must add a new configuration parameter to the portlet configuration:

1. Go to Administration > Portlet Management > Portlets.
2. Open the Web content Viewer portlet in configuration mode.
3. Type WCM_RICH_TEXT_EDITOR in the New Parameter field.
4. Type /wps/ephox;/jsp/html/EditLiveJavaEditor.jsp in the New Value field.
5. Click Add.
6. Click OK.

Ephox Editor and JSR 286 Local Rendering Portlet / Inline edit.

When rendering an Authoring Tool component / using Inline edit with JSR 286 Web content viewer portlet, if any issues occur with Inline edit / EditLive!, then ensure that the reserved authoring portlet is configured and available. Refer to the following link in the Information Center for more details:
http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1/index.jsp?topic=/com.ibm.wp.ent.doc_v615/wcm/wcm_config_wcmviewer_reservedauth.html
If the reserved authoring portlet or the hidden portlet page are removed inadvertently, you can deploy them again using the action-install-wcm-hidden-authoring configuration task. Once the hidden portlet page is available and the RTE is set to extended editor, any content when edited using Inline edit or the Authoring tool
component will be edited with EditLive!.

How to disable the Click-to-Edit feature so that the Edit applet loads automatically

The feature that causes you to click into the editor before using it is an EditLive! feature called Inline editing. Inline editing was implemented for two reasons. First, if content creators do not want to modify the rich text, they do not have to wait for the editor to load. Second, many clients have as many as 7 or 8 rich text fields in a single form. In these situations, Inline editing eliminates the need to wait for all 7 or 8 rich text fields to load in parallel. This significantly improves the load time of the Authoring template. At this time, it is not possible to disable this feature.

How to get Editlive! version 7.x

EditLive! RTE is now completely integrated with WebSphere Portal / Lotus Web Content Management 6.10.3 or later versions. Once you install Fixpack 3 or higher, EditLive! 7.x is readily available out of the box.

Data to collect to troubleshoot Ephox-related issues.

If you need assistance from IBM Product Support on any Ephox-related issue, collect the logs and debug data listed in below link
Ephox® EditLive! OEM Edition for IBM® Lotus Web Content Management (WCM) version 6.1,” and send to Product Support

WCM technotes that may be useful

http://www-01.ibm.com/support/docview.wss?uid=swg21428290
http://www-01.ibm.com/support/docview.wss?uid=swg21433948