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
- 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 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
- Select the tbioServices_c5.ear file and then
click Next.
- Wait for the tbioServices_c5.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.
- 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.
- 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 tbioServices_c5.ear application as
follows:
- Find tbioServices_c5.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
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.
- 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
EphoxTbioServices.
- 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.