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
- Using the WebSphere Integration Solutions console, navigate
to and then click Install.
- Install the spell checking service for the Textbox.io editor
as follows:
- 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
- Select the editorsServices_c6.ear file and then click
Next.
- Wait for the editorsServices_c6.ear file to be uploaded and prepared for
installation, which might take few minutes.
- Select the Fast Path installation option
and then click Next.
- Accept the selected, default installation options and then click
Next.
- Map modules to the appropriate cluster and server:
- In the Mapping modules to server field, select the following files:
- ephox-spelling.war
- ephox-image-proxy.war
- ephox-hyperlinking.war
- In the Clusters and servers field, select the following cluster and server:
- Click Apply.
- For the Map virtual host for Web modules options,
accept the default values and then click Next.
- Review the details on the Summary page. If you need to make changes,
click Previous; otherwise click Finish to
begin the installation.
- After installation completes successfully, click the Save
link in the message feedback list to preserve the new
configuration
- Edit the configuration for the new editorsServices_c6.ear application as
follows:
- Find editorsServices_c6.ear application in the list and then click it to begin
editing.
- 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.
- On the Messages prompt, click Save to preserve the configuration
edits.
- 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.
- Save your updates to application.conf.
- Stop and then restart the application for your changes to take effect.
- In the WebSphere Integrated Solutions console, start the newly installed
editorsServices_c6.ear.
- 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.