Drupal

WProofreader spelling and grammar checker is available in Drupal through two CKEditor 5 modules developed by CKSource:

circle-info

You don't need a separate license for other premium features in the module to use WProofreader.

  • CKEditor 5 Plugin Packarrow-up-right — Includes the free version of WProofreader, enabled by default. No sign-up or activation key is required. This version has word processing limits, limited functionality, and no advanced settings management.

Both modules point to the WebSpellChecker cloud service by default (governed by the Terms of Servicearrow-up-right). The CKEditor 5 Plugin Pack doesn't allow changing this, while the CKEditor 5 Premium Features module lets you choose between cloud and self-hosted deployment. For a detailed comparison of free and paid versions, see Free vs paidarrow-up-right.

circle-info

One of the above Drupal modules must be installed on your Drupal website before using WProofreader.

Getting started

WProofreader is enabled by default for the main editor and comments that use CKEditor 5 under the hood. It isn't activated for plain text fields or standard inputs.

To obtain a license for WProofreader SDK, sign up for one of the paid plansarrow-up-right (which differ by the word package included) or contact usarrow-up-right for Enterprise pricing with self-hosted deployment.

Activating WProofreader

WProofreader in CKEditor 5 Premium Featuresarrow-up-right for Drupal uses the cloud service by default and requires a service ID as an activation key.

  1. Navigate to Administration > Configuration > CKEditor 5 Premium Features > WProofreader.

  2. Enter your Service ID in the corresponding field. You can find this on the Credentialsarrow-up-right page in the WProofreader admin panel.

  1. Click Save configuration.

Once a valid activation key is saved, proofreading will be active in all rich text fields using the default settings.

Settings overview

There's a list of settings available to adjust the default behavior of the proofreading tool:

  • Language. Change the default language for proofreading.

  • Custom dictionary. Manage organization-level dictionaries.

  • General check types. Enable which types of suggestions (spelling, grammar and style) and functionality (spelling autocorrect and text autocomplete) should be enabled.

  • Spelling ignore options. Define if the spellchecker should skip certain types of words during check, such as words written in mixed letters, etc.

  • Advanced features. Enable advanced proofreading and text rewriting functionality with AI writing assistant.

  • Advanced settings. Custom configuration options and deployment option.

The following settings are available to customize WProofreader behavior.

Language

The default language is set to Autodetect. In this mode, WProofreader will try to automatically detect the language of the input text.

circle-info

At least 2–3 correct words are needed for language detection. Only one language is used per sentence. If multiple languages are detected, the one with the higher probability will be used for checking.

The language dropdown displays the languages selected during sign-up. You can also modify the available languages from the Settings page in the admin panel. See How to change the list of languages.

Custom dictionary

Custom dictionaries are managed at the organization or global level by subscription or application admins. For the cloud version, they're managed from the admin panel under Custom dictionaryarrow-up-right.

  • If the dictionary ID field is left empty, all enabled dictionaries will be applied.

  • If one or more dictionary IDs are specified, only those dictionaries will be loaded for your Drupal site.

User default settings

These settings control which check types and features are enabled by default. They're also accessible to end users in the WProofreader UI. Admins can set defaults, but users can override them. User preferences are saved in the browser's local storage until it's cleared. You can restrict user modifications through permissions.

Available check types:

  • Spelling suggestions

  • Grammar suggestions

  • Style guide suggestions — Based on custom rules created in the WProofreader admin panel (shown as yellow underlines). Also includes predefined rules for inclusive language and profanity/offensive language detection. Check out more about Style suggestions and Style guide builder.

  • Correct spelling automatically (autocorrect)

  • Autocomplete suggestions (text prediction) — Currently available for English only.

circle-info

Not all check types are supported for every language.

Spelling ignore options

These options apply only to spelling suggestions (red underlines) and are also saved in browser local storage if changed by a user.

Advanced features

This section currently contains a single setting: the AI writing assistant (AIWA), which is disabled by default. When enabled, AIWA offers predefined text operations such as rewrite, improve, summarize, and more. Learn more about AIWA.

Advanced settings

This section contains two main options: one for adding custom configuration options to adjust default settings that aren't available on the UI, and another to update the WProofreader service endpoint and connect to the self-hosted version instead of the cloud service.

Custom configuration

Allows you to specify additional WProofreader configuration options that aren't available through the Drupal settings UI. Options must be provided in JSON format.

Example:

These options override values set elsewhere in the configuration form. See the full Configuration referencearrow-up-right for available options.

Deployment options

Controls the WProofreader service endpoint. By default, WProofreader uses the cloud service.

If you have a license for the self-hosted version, select Use self-hosted version endpoint and fill in the following fields:

  • Protocol (e.g., https)

  • Hostname (e.g., domain.com)

  • Port (e.g., 443)

  • Service path (e.g., wscservice/api)

  • WProofreader script URL (e.g., https://host_name/virtual_directory/wscbundle/wscbundle.js)

The resulting endpoint URL should look like: https://domain.com/wscservice/api

Once you've configured the endpoint, click Save configuration to apply changes.

circle-info

When using a self-hosted endpoint, you don't need to specify a Service ID. It's only required for the cloud service.

User guide

When editing content in any CKEditor 5 field in Drupal, you'll see two UI elements indicating WProofreader is active:

  • An “A“ icon on the editor toolbar

  • An orange badge (dot) in the bottom-right corner of the editable field

Both elements open a menu with additional actions: Proofread in dialog, Settings, and Disable/Enable.

For a complete guide on using WProofreader as an end user, see the User manual.

circle-info

Last updated

Was this helpful?