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 / Lotus Web Content Management to 6.1.0.3 / 6.1.5 EditLive is available out of box and ready to use. If you are on version 6.1.0.0 to 6.1.0.2, then you need to download the Editlive editor from Passport Advantage website and install the Ephox editor. Recommended approach is to upgrade to 6.1.0.3 or later.

EditLive! editor displays as trial version

Ensure the Editlive RTE is downloaded from Passport Advantage website and deployed to obtain the IBM licensed one. Also if you have 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

For 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 per the Cumulative fix install process. This issue could happen mostly likely with version 6.1.0.2 or earlier. For 6.10.2 or earlier, the update-wcm task redeploys/updates the WCM portlets and as pat this the Ephox related files are deleted. You need to redeploy / copy the Edilive files again as documented in the Editlive readme included in the download.

After upgrade to 6.1.0.3, Ephox not working.

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

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 be 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 will need to 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 and if any issues with inline edit / Editlive, then ensure the Reserved authoring portlet is configured and available. Refer to below link in Infocenter for more details.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.
http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1/index.jsp?topic=/com.ibm.wp.ent.doc_v615/wcm/wcm_config_wcmviewer_reservedauth.html
Once the hidden portlet page is available and the RTE is set to extended editor, any content when edited via inline edit / Authoring tool component will be editing 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 the content creator does not want to modify the rich text they do not have to wait for the editor to load. Second, many of our clients have multiple rich text fields in a single form – some as many as 7 or 8! 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.

How to get version 7.x Editlive

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

Data to collect to troubleshoot Ephox related issues.

If you need assist from IBM Support on any Ephox related issue, collection logs and debug data listed in technote listed below and send to support.
http://www-01.ibm.com/support/docview.wss?rs=688&uid=swg21380433

WCM Technote's that might be useful

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