Rich text editor toolbar configuration options

Run these configuration tasks to change the configuration of the rich text editor toolbar.

Note: In a clustered environment, these tasks are only run on the primary server.

Using a custom Textbox.io editor toolbar

  1. The Textbox.io editor uses a custom configuration file that is named tbio_config.jsp to set custom parameters for the toolbar. Copy your custom configuration file to wp_profile_root\PortalServer\wcm\shared\app\config\textboxio.
    Note: Sample configurations can be found in PortalServer_root\wcm\prereq.wcm\wcm\config\templates\shared\app\config\textboxio
  2. Open a command prompt.
  3. Run the following command from the wp_profile_root/ConfigEngine directory:
    Windows™
    ConfigEngine.bat configure-wcm-ephox-editor-custom-configuration -DWasPassword=password -DPortalAdminId=username -DPortalAdminPwd=password
    UNIX™Linux™
    ./ConfigEngine.sh configure-wcm-ephox-editor-custom-configuration -DWasPassword=password -DPortalAdminId=username -DPortalAdminPwd=password
    IBM® i
    ConfigEngine.sh configure-wcm-ephox-editor-custom-configuration -DWasPassword=password -DPortalAdminId=username -DPortalAdminPwd=password
    z/OS®
    ./ConfigEngine.sh configure-wcm-ephox-editor-custom-configuration -DWasPassword=password -DPortalAdminId=username -DPortalAdminPwd=password
    Note: An administrator user name and password is not required if you already specified the portal administrator user name and password with the PortalAdminId and PortalAdminPwd settings in the wkplc.properties file.
  4. Restart the server.
    Note: To revert to the default editor toolbar, run the task that is named remove-wcm-ephox-editor-custom-configuration on the primary node only.

With HCL Digital Experience 9.5 CF18, in order to remediate security vulnerabilities in several open source libraries, the Rich Text Editor Textbox.io requires a minimum supported Java level of 1.8. If you are unable to move to Java 8, it is recommended that you use the out-of-the-box, default CKEditor provided with HCL Digital Experience.
  1. To enable the new Textbox I/O editor fix using HCL Digital Experience CF18 or later, run this configuration process:
    ConfigEngine(sh/bat) action-deploy-tiny-editors
  2. If a custom configuration is used for this editor, run this configuration process:
    ConfigEngine(sh/bat) configure-wcm-ephox-editor-custom-configuration
  3. Restart your HCL Digital Experience 9.5 CF18 (or later) deployment once the configuration process is completed.
  4. To revert this process to an earlier version of this Rich Text editor, run the following process:
    ConfigEngine(sh/bat) action-remove-tiny-editors
    ConfigEngine(sh/bat) configure-wcm-editor
    ConfigEngine(sh/bat) remove-wcm-ephox-editor-custom-configuration (if a custom configuration is used)
  5. Restart your HCL Digital Experience deployment.
  6. If you are using HCL Digital Experience 9.5 Container Update CF18 (or later), run the following process:
    ConfigEngine.sh action-deploy-tiny-editors
  7. Restart your HCL Digital Experience 9.5 Container deployment.

Using a custom EditLive! editor toolbar

Note: Ephox EditLive! is a deprecated feature as of CF11 or higher.
  1. The EditLive! editor uses a custom configuration file that is named config.xml.jsp to set custom parameters for the toolbar. Copy your custom configuration file to wp_profile_root\PortalServer\wcm\shared\app\config\ephox.
    Note: Sample configurations can be found in PortalServer_root\wcm\prereq.wcm\wcm\config\templates\shared\app\config\ephox
  2. Open a command prompt.
  3. Run the following command from the wp_profile_root/ConfigEngine directory:
    Windows
    ConfigEngine.bat configure-wcm-ephox-editor-custom-configuration -DWasPassword=password -DPortalAdminId=username -DPortalAdminPwd=password
    UNIXLinux
    ./ConfigEngine.sh configure-wcm-ephox-editor-custom-configuration -DWasPassword=password -DPortalAdminId=username -DPortalAdminPwd=password
    IBM i
    ConfigEngine.sh configure-wcm-ephox-editor-custom-configuration -DWasPassword=password -DPortalAdminId=username -DPortalAdminPwd=password
    z/OS
    ./ConfigEngine.sh configure-wcm-ephox-editor-custom-configuration -DWasPassword=password -DPortalAdminId=username -DPortalAdminPwd=password
    Note: An administrator user name and password is not required if you already specified the portal administrator user name and password with the PortalAdminId and PortalAdminPwd settings in the wkplc.properties file.
  4. Restart the server.
Note: To revert to the default editor toolbar, run the task that is named remove-wcm-ephox-editor-custom-configuration on the primary node only.

Reverting to the EditLive! editor version 7 toolbar

Note: Ephox EditLive! is a deprecated feature as of CF11 or higher.
  1. Open a command prompt.
  2. Run the following command from the wp_profile_root/ConfigEngine directory:
    Windows
    ConfigEngine.bat configure-wcm-ephox-editor-v7-configuration -DWasPassword=password -DPortalAdminId=username -DPortalAdminPwd=password
    UNIXLinux
    ./ConfigEngine.sh configure-wcm-ephox-editor-v7-configuration -DWasPassword=password -DPortalAdminId=username -DPortalAdminPwd=password
    IBM i
    ConfigEngine.sh configure-wcm-ephox-editor-v7-configuration -DWasPassword=password -DPortalAdminId=username -DPortalAdminPwd=password
    z/OS
    ./ConfigEngine.sh configure-wcm-ephox-editor-v7-configuration -DWasPassword=password -DPortalAdminId=username -DPortalAdminPwd=password
    Note: An administrator user name and password is not required if you already specified the portal administrator user name and password with the PortalAdminId and PortalAdminPwd settings in the wkplc.properties file.
  3. Restart the server.
Note: To revert to the default editor toolbar, run the task that is named remove-wcm-ephox-editor-v7-configuration on the primary node only.