Installing Textbox.io services for spell check

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

Before you begin

This task assumes that the Ephox editors for IBM Connections are installed and that Textbox.io has been selected as the preferred rich text editor.
Note: If you do not install the spell-checking service, then spell checking in Textbox.io 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 Connections ships with Textbox.io 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 tbioServices_c5.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 tbioServices_c5.ear file and then click Next.
    3. Wait for the tbioServices_c5.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. For Mapping modules to server, select the ephox-allowed-origins.war and ephox-spelling.war modules, select the Clusters and servers lccluster and webserver, and then click Apply. The selected modules will be mapped to servers.
    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 tbioServices_c5.ear application as follows:
    1. Find tbioServices_c5.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 Textbox.io services. Add an entry for each URL that might load Textbox.io 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 EphoxTbioServices.
  8. Validate this installation by opening Connections and browsing to a rich text editor instance. The rich text editor should be Textbox.io.
    • 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.