Installing Ephox Editor services for spell check

Install and configure Ephox Editors: TinyMCE and Textbox.io services for spell-checking after the Ephox Editors installation if you decided to use TinyMCE as your preferred rich text editor.

Before you begin

This task assumes that Ephox Editors for IBM Connections is installed and that TinyMCE has been selected as the preferred rich text editor.
Note: If you do not install the spell-checking service, then spell checking in TinyMCE will fall back to the browser's default spell checker, which can have a number of undesirable repercussions such as spell-check suggestions being unavailable in tables and the spell checker no longer matching the Connections locale for multi-lingual users.

About this task

Ephox Editors for IBM Connections ships with TinyMCE services for spell-checking. This service has to be installed and configured separately as described in the following steps:

Procedure

  1. Using the WebSphere Integration Solutions console, navigate to Applications > Application Types > WebSphere Enterprise Applications and then click Install.
  2. Install the spell checking service for the Textbox.io editor as follows:
    1. On the Preparing for this application installation window under the Local file system option, Browse for the editorsServices_c6.ear application located in EphoxEditorsForConnections.zip package under the services folder.
      • Windows: C:\ephox\EphoxEditorsForConnections\services
      • Unix, Linux, or AIX: /opt/ephox/EphoxEditorsForConnections/services
    2. Select the editorsServices_c6.ear file and then click Next.
    3. Wait for the editorsServices_c6.ear file to be uploaded and prepared for installation, which might take few minutes.
    4. Select the Fast Path installation option and then click Next.
    5. Accept the selected, default installation options and then click Next.
    6. Map modules to the appropriate cluster and server:
      1. In the Mapping modules to server field, select the following files:
        • ephox-spelling.war
        • ephox-image-proxy.war
        • ephox-hyperlinking.war
      2. In the Clusters and servers field, select the following cluster and server:
        • lccluster
        • webserver
      3. Click Apply.
    7. For the Map virtual host for Web modules options, accept the default values and then click Next.
    8. Review the details on the Summary page. If you need to make changes, click Previous; otherwise click Finish to begin the installation.
    9. After installation completes successfully, click the Save link in the message feedback list to preserve the new configuration
  3. Edit the configuration for the new editorsServices_c6.ear application as follows:
    1. Find editorsServices_c6.ear application in the list and then click it to begin editing.
    2. For Class loading options, click Class loading and update detection, select the Classes loaded with local class loader first (parent last) order, and then click Apply.
    3. On the Messages prompt, click Save to preserve the configuration edits.
  4. Under one of the following directories, create an application.conf file using a text editor:
    • On Unix, Linux, or AIX: /opt/ephox/application.conf
    • On Windows: BOOT_DRIVE_LETTER:\opt\ephox\application.conf where BOOT_DRIVE_LETTER is the boot drive for your system
    
ephox {
allowed-origins {
origins = [
"http://connections.domain.com"
],
}
}
    where origins = [] contains a list of the URL prefixes that are allowed to access the TinyMCE services. Add an entry for each URL that might load TinyMCE in the application inside of quotation marks.
    Note: Do not add trailing slashes.
  5. Save your updates to application.conf.
  6. Stop and then restart the application for your changes to take effect.
  7. In the WebSphere Integrated Solutions console, start the newly installed editorsServices_c6.ear.
  8. Validate this installation by opening Connections and browsing to a rich text editor instance. The rich text editor should be TinyMCE.
    • If the editor cannot connect to the spell-checking service, then a red error banner appears under the toolbar.
    • If the spell-checking service has been installed correctly, then an incorrectly spelled word is highlighted with a solid red underline and suggested corrections appear on the context menu for that word.