Acrolinx IQ. Acrolinx IQ Plug-in for Adobe CQ Rich Text Editor Installation Guide Version: 2.9

Rich Text Editor Installation Guide

Version: 2.9

Contents

Overview

3

About this Guide...3

Acrolinx IQ and CQ Editor...3

Installation

4

Single Sign-on Configuration...4

Configuring the SSO Properties...5

Uploading and Installing the Acrolinx IQ Plug-in Package...6

Enabling the Acrolinx IQ Plug-in...6

Configuring the Connection to the Acrolinx IQ Server...9

Chapter 1

Overview

About this Guide

Purpose

The

Acrolinx IQ Plug-in for Adobe CQ Rich Text Editor

Installation Guide is

designed to help you install and configure the

Acrolinx IQ Plug-in for Adobe

CQ Rich Text Editor.

Audience

The

Acrolinx IQ Plug-in for Adobe CQ Rich Text Editor

Installation Guide is

intended for technical support staff who install, configure, and provide administration for the

Acrolinx IQ Plug-in for Adobe CQ Rich Text Editor.

Acrolinx IQ and CQ Rich Text Editor

The CQ Rich Text Editor is a WYSIWYG text editor that is included in several of the standard CQ components such as "Text", "Table" and "Text image". The CQ Rich Text Editor is available whenever you add these components to web pages and edit the text in the components. You can integrate

Acrolinx

IQ

functionality into the CQ Rich Text Editor so that you can check for content issues when editing text blocks or tables.

For more information about CQ Rich Text Editor, visit theAdobe CQ website. The

Acrolinx IQ Plug-in for Adobe CQ Rich Text Editor

has been tested with CQ Rich Text Editor versions 5.4, 5.5. Other versions might work but have not been tested.

Chapter 2

Installation

You install the

Acrolinx IQ Plug-in for Adobe CQ Rich Text Editor

by uploading and installing the

Acrolinx IQ Plug-in

package in the Adobe CRX package manager. To complete the

Acrolinx IQ Plug-in

installation, you must also make several changes in the CRX Development Environment Lite (CRXDE Lite), and the Adobe CQ5 web console.

The installation consists of the following major steps: 1 Enable single-sign on for Acrolinx IQ.

2 Obtain the installation package for the

Acrolinx IQ Plug-in for Adobe CQ

Rich Text Editor.

3 Upload the installation package for the

Acrolinx IQ Plug-in for Adobe CQ

Rich Text Editor

and install the package.

4 Configure the connection to the

Acrolinx IQ Server.

Single Sign-on Configuration

If your web applications run in a single sign-on environment, you can configure the

Acrolinx IQ Plug-in for Adobe CQ Rich Text Editor

to work in your single sign-on environment as well. You configure single sign-on by updating the CQ5 Web Console and the

Acrolinx IQ

core server properties.

What is Single Sign-on?

Single sign-on (SSO) is a user authentication process. When single sign-on is deployed, users provide their login details once to access multiple

applications. This process ensures that users do not have to enter their login details again when they switch applications. The network administrator can configure the single sign-on software so that users can only access specific applications. Web single sign-on works only with applications accessed with a web browser. The request to access a web resource is intercepted either by a component in the web server, or by the application itself.

Unauthenticated users are diverted to an authentication service and returned only after a successful authentication.

Which Single Sign-on Methods Does Acrolinx IQ Support?

You can configure Acrolinx IQ to search for a SSO identifier in the request header sent by the browser.

How Does Acrolinx IQ Work with Adobe CQ When Authenticating Users??

Configuring the SSO Properties

To integrate Acrolinx IQ into your single sign-on configuration, you must configure the Acrolinx IQ Server to search for SSO identifier in the request header.

â

To configure the SSO properties, follow these steps:

1 Open the core server properties file and add the following property:

singleSignOn.method=header

2 Configure the generic password that is used in your single sign-on configuration, by adding the following property:

singleSignOn.genericPassword=<PASSWORD>

Example:

singleSignOn.genericPassword=Sus5AbUt

Generic passwords remove the need to configure a password for users in each application. If you configure a generic password, Acrolinx IQ users will be created without passwords.

If some users need to access the Acrolinx IQ term contribution form, you must configure a password for these users. The term contribution feature is not included in the Acrolinx IQ support for single sign-on. If you edit a user and add a password in the Acrolinx IQ Dashboard, this password will be required for the term contribution form, but will be ignored when authenticating a user in an Acrolinx IQ web client. The generic password is used for client authentication instead.

3 To restrict single sign-on to a set of configurable hosts, add the following property:

singleSignOn.allowedRemoteAddresses=<ADDRESSES>

In the following example, a comma delimited list of secured remote addresses has been entered by using regular expressions:

singleSignOn.allowedRemoteAddresses=10\.10\..*\..*,192\.168\..*\..*

NOTE:

You must enter regular expressions in the Java regular expression syntax. However, range quantifiers such as\d{1,3}are not supported because they contain commas that interfere with how the property is interpreted.

4 Define the names of the user name and password keys by adding the following properties:

singleSignOn.usernameKey=<USER_NAME_KEY> singleSignOn.passwordKey=<PASSWORD_KEY>

For example, if the user name and password are sent with parameters that are namedusernameandpassword, enter the properties as follows:

singleSignOn.usernameKey=username singleSignOn.passwordKey=password

singleSignOn.method=header

singleSignOn.genericPassword=Sus5AbUt singleSignOn.usernameKey=username singleSignOn.passwordKey=password

singleSignOn.allowedRemoteAddresses=10\.10\..*\..*,192\.168\..*\..*

5 Save the core server properties file and restart the core server.

Uploading and Installing the Acrolinx IQ Plug-in

Package

To install the key components of the

Acrolinx IQ Plug-in, upload and install

the installation package in the Adobe CRX package manager. You must be logged as an administrator to perform this function.

â

To upload and install the Acrolinx IQ Plug-in package, follow these steps:

1 Navigate to Welcome Page ➤ Packages and click Upload Package

You can also open the Adobe CRX Package manager entering the following URL in your Web Browser:

http://<SERVER_ADDRESS>:4502/crx/packmgr/index.jsp

2 In the

Upload Package

dialog box, select the

Acrolinx IQ Plug-in

installation package and click OK.

3 After the package has uploaded, click Install .

4 When the installation is complete, enable the Acrolinx IQ plug-in(see "Enabling the Acrolinx IQ Plug-in" on page 6).

Enabling the Acrolinx IQ Plug-in

To ensure that the Acrolinx IQ toolbar is visible in the CQ Rich Text Editor, you must add the plug-in as a dependency in the WCM core configuration. You must also add overlay copies of the relevant foundation components and add nodes for the Acrolinx IQ plug-in to each component.

TIP:

You can skip these steps and quickly test the Acrolinx plug-in with a sample configuration package that is available on request. When you upload and install this package in the CQ package manager, all required

configurations are added automatically. However, the installation process will overwrite any previous configurations made to the CQ Rich Text Editor and will add all available editing features. For this reason, we recommend that you use the sample configuration in test environments only. To obtain the sample configuration package, contact your Acrolinx project consultant.

â

To enable the Acrolinx IQ plugin, follow these steps:

You can also open CRXDE Lite by entering the following URL in your Web Browser:

http://<SERVER_ADDRESS>:4502/crx/de/index.jsp

2 Add the Acrolinx IQ plug-in as a core client-library dependency. a) Locate and select the following folder your repository:

/apps/wcm/core/clientlibs/edit

If this folder does not yet exist in your installation, create the location

/apps/wcm/core/clientlibs/first, save your changes, then copy the folder/libs/wcm/core/clientlibs/editto

/apps/wcm/core/clientlibs/.

To copy or paste items, right-click a node or folder. In the context menu that appears, select Copy or Paste.

b) With the edit folder selected, browse the Properties tab and double click the Dependencies row.

c) In the

Edit Dependencies

window, click +, add the dependency

acrolinx.rteplugin, and click OK to save your changes.

3 Add the Acrolinx IQ plug-in as a CQ Rich Text Editor plug-in for each text-based component.

For example, to add the Acrolinx IQ plug-in to the CQ Rich Text Editor in the "Text" component, follow these steps:

a) Locate the following node your repository:

/libs/foundation/components/text/

This node defines the behavior and appearance of the CQ Rich Text Editor

b) Copy the node and paste the node at the following location.

/apps/foundation/components/

If this folder does not yet exist in your installation, create the location

/apps/foundation/components/first, save your changes, then paste

the node.

c) In the node you just pasted, locate the following sub node.

/apps/foundation/components/text/dialog/items/tab1/items/text/rtePlugins

d) Create a new sub node underneath thertePluginsnode with the nameacrolinxand the typent:unstructured.

To create a node, right-click the parent node or folder. In the context menu that appears, select Create ➤ Create Node....

e) Select the node you just created and add a new property with the following attributes:

features

Name

String

Type

check, options, remove-flags, report, help, about

To enter multiple values, ensure that you click the Multi button

Value

Alternatively, you can also enter

*to include all features that are configured in the current version of your plug-in. Ensure that the Multi button is deselected if you the*character.

To add new properties, edit the fields in the bottom row of the Properties tab and click Add. If you are adding multiple values, enter the values in the dialog box that appears. Click + to add each value.

f) Repeat the previous steps from step "a" for the "Text Image" and "Table" components which you can copy from the following locations. • Text Image

/libs/foundation/components/textimage/

You copy this node to the folder/apps/foundation/components/

add anacrolinxnode underneath the node

/apps/foundation/components/textimage/dialog/items/tab1/items/text/rtePlugins. • Table

/libs/foundation/components/table/

You copy this node to the folder/apps/foundation/components/

add anacrolinxnode underneath the node

/apps/foundation/components/table/dialog/items/table/rtePlugins. 4 Add the Acrolinx IQ plug-in stylesheet as an external stylesheet for each

text-based component.

For example, to add the Acrolinx IQ plug-in stylesheet as an external stylesheet for the "Text" component, follow these steps:

a) Locate the following node:

/apps/foundation/components/text/dialog/items/tab1/items/text/

b) Create a new sub node underneath thetext node with the name

externalStyleSheetsand the typent:unstructured.

c) Double click the node you just created and add a new property with the following attributes:

acrolinx-cq-rte-plugin-content

Name

String

Type

/apps/acrolinx/clientlib/css/acrolinx.css

Value

d) Repeat the previous steps from step "a" for the "Text Image" and "Table" components.

You add theexternalStyleSheetsnode to the following locations: • Text Image

/apps/foundation/components/textimage/dialog/items/tab1/items/text/. • Table

The

Acrolinx IQ

toolbar should now be visible whenever you use the rich text editor. For example, the toolbar should be visible when you edit a text component in a web page.

6 Configure the connection to the

Acrolinx IQ Server.

(see "Configuring the Connection to the Acrolinx IQ Server" on page 9)

Configuring the Connection to the

Acrolinx IQ Server

To enable the checking functionality in the

Acrolinx IQ Plug-in for Adobe CQ

Rich Text Editor, you must configure the Adobe CQ application platform to

route the internal checking requests to your

Acrolinx IQ Server

installation.

â

To configure the connection to the Acrolinx IQ Server, follow these steps:

1 Open the Adobe CQ5 Web Console by navigating to Welcome Page ➤ OSGi Console or by entering the following URL in your Web Browser.

http://<SERVER_ADDRESS>:4502/system/console/configMgr

2 Click the row Acrolinx Adobe CQ Proxy and in the dialog box that appears, make the following changes:

• In the Acrolinx Server URL field, enter the address of your Acrolinx IQ Server.

• In the Generic Password field, enter your generic password.

This password must match the generic password that you configured in the core server properties file when Enabling single-sign on for Acrolinx IQ(see "Single Sign-on Configuration" on page 4). 3 Click Save.

You should now be able to use Acrolinx IQ to run checks in the rich text editor.

Upgrading the Acrolinx IQ Plug-in

It is not necessary to remove the previous plug-in version before installing a newer version. You can upload and reinstall the new plug-in package over the top of the old one. You must be logged as an administrator to perform this function.

â

To upgrade the Acrolinx IQ Plug-in:

1 Navigate to Welcome Page ➤ Packages and click Upload Package

You can also open the Adobe CRX Package manager entering the following URL in your Web Browser:

http://<SERVER_ADDRESS>:4502/crx/packmgr/index.jsp

3 After the package has uploaded, click Reinstall . 4 Check that the upgrade has been correctly installed.

a) Open an instance of the rich text editor and press CTRL + F5 to refresh the page.

b) Click the About Acrolinx button in the Acrolinx IQ toolbar and check that the plug-in version number in the version information matches the version of the plug-in that you just installed.

Index

A

About this Guide • 3

C

Configuring the Connection to the Acrolinx IQ Server • 9

Configuring the SSO Properties • 5

E

Enabling the Acrolinx IQ Plug-in • 6

I

Introduction • 3

U