Configuring SCAYT plugin for CKEditor 4

 Check how to configure SCAYT plugin for CKEditor...

This guide outlines the main steps that you need to follow in order to integrate and configure the SCAYT plugin for CKEditor 4. All the described steps are provided for the Server version of SCAYT.

1. Initialize CKEditor 4

Before integrating and configuring the SCAYT plugin, CKEditor should be properly configured in your web application. If you haven't done it yet, please refer to Example CKEditor Setups on the CKEditor documentation pages. 

2. Configure SCAYT Plugin

The next step is to define necessary SCAYT parameters and options in the CKEditor config.js file.

  • Specify path to the SCAYT plugin (wscbundle.js) using scayt_srcUrl parameter. 
CKEDITOR.config.scayt_srcUrl ="http(s)://your_host_name/spellcheck/wscbundle/wscbundle.js";
  • Define additional SCAYT parameters (e.g. start SCAYT spell and grammar automatically, change default language, etc.).
CKEDITOR.config.scayt_autoStartup = true;
CKEDITOR.config.grayt_autoStartup = true;
CKEDITOR.config.scayt_sLang ="en_US";
 Click here to see a full list of SCAYT API parameters and possible values...

Here you can find a list of all available SCAYT parameters for CKEditor 4.0+ that can be used for the SCAYT configuration. Also, you may visit CKEDITOR configuration documentation.

scayt_autoStartup

Description:

scayt_autoStartup parameter turns SCAYT on/off automatically after the editor loading.

Parameter type:Boolean
Possible values:
  • true
  • false

Example:

config.scayt_autoStartup = true;

Back to the top...


grayt_autoStartup

Description:grayt_autoStartup parameter turns Grammar As You Type (GRAYT) on/off automatically once SCAYT has started.
Parameter type:Boolean
Default value:

true

Possible values:
  • true
  • false

Example:

config.grayt_autoStartup = false;

Back to the top...


scayt_inlineModeImmediateMarkup

Description:scayt_inlineModeImmediateMarkup parameter turns the SCAYT initiation on/off when Inline CKEditor is not focused. The SCAYT markup is taken place (SCAYT instance is not destroyed) in both Inline CKEditor's states, focused and unfocused.
Parameter type:Boolean
Default value:

false

Possible values:
  • true
  • false

Example:

config.scayt_inlineModeImmediateMarkup = true;

Back to the top...


scayt_maxSuggestions

Description:scayt_maxSuggestions parameter defines the number of SCAYT suggestions to show in the main context menu.
Parameter type:Number
Default value:

3

Possible values:
  • 0 (zero) No suggestions are shown in the main context menu. All suggestions will be shown in the “More Suggestions” sub-menu.
  • positive number The max number of suggestions to show in the main context menu. Other entries will be listed in “More Suggestions”.
  • negative number 

Example:

config.scayt_maxSuggestions = 3;

Back to the top...


scayt_minWordLength

Description:scayt_minWordLength parameter defines the minimum length of the words that will be collected from editor's text for spell checking.
Parameter type:Number
Default value:

3

Possible values:

any positive number

Example:

config.scayt_minWordLength = 2;

Back to the top...


scayt_customerId

Description:

scayt_customerId parameter sets a customer ID for Cloud SCAYT. It is required for migration from free, ad-supported version to paid, ad-free version. 

scayt_customerId is intended for use only with the Cloud version of SCAYT.

Parameter type:String
Default value:

The free version of SCAYT plugin is shipped with already predefined service ID value.

Possible values:

your-service-id

Example:

config.scayt_customerId = 'your-service-id';

Back to the top...


scayt_ignoreAllCapsWords

Description:

scayt_ignoreAllCapsWords parameter regulates whether all capitalized words should be ignored.

Parameter type:Boolean
Default value:

false

Possible values:
  • true
  • false

Example:

config.scayt_ignoreAllCapsWords = true;

Back to the top...


scayt_ignoreDomainNames

Description:

scayt_ignoreDomainNames parameter regulates whether domain names and web addresses should be ignored.

Parameter type:Boolean
Default value:

false

Possible values:
  • true
  • false

Example:

config.scayt_ignoreDomainNames = true;

Back to the top...


scayt_ignoreWordsWithMixedCases

Description:

scayt_ignoreWordsWithMixedCases parameter regulates whether words with mixed case letters should be ignored.

Parameter type:Boolean
Default value:

false

Possible values:
  • true
  • false

Example:

config.scayt_ignoreWordsWithMixedCases = true;

Back to the top...


scayt_ignoreWordsWithNumbers

Description:

scayt_ignoreWordsWithNumbers parameter regulates whether words containing numbers should be ignored.

Parameter type:Boolean
Default value:

false

Possible values:
  • true
  • false

Example:

config.scayt_ignoreWordsWithNumbers = true;

Back to the top...


scayt_disableOptionsStorage

Description:

scayt_disableOptionsStorage parameter defines whether SCAYT options storing should be disabled. It is allowed to pass an array of options.

Parameter type:Array
Default value:

' '

Possible values:
  • ' '
  • scayt_ignoreAllCapsWords
  • scayt_ignoreDomainNames
  • scayt_ignoreWordsWithMixedCases
  • scayt_ignoreWordsWithNumbers
  • lang

Example: 

config.scayt_disableOptionsStorage = ['lang', 'ignore-all-caps-words', 'ignore-words-with-mixed-cases']]

Back to the top...


scayt_moreSuggestions

Description:

scayt_moreSuggestions parameter enables/disables the “More Suggestions” sub-menu in the context menu. 

Parameter type:String
Default value:

on

Possible values:on, off

Example:

config.scayt_moreSuggestions = 'off';

Back to the top...


scayt_contextCommands

Description:

scayt_contextCommands parameter manages and customizes the SCAYT context menu commands: Add Word,  Ignore All, Options, Languages, Dictionaries and About. It is allowed to pass more than one value separating each value with a vertical bar.

Options, Languages and Dictionaries items can be added to the SCAYT context menu only if these items are present on the SCAYT settings dialog. The visibility of these items are regulated by the scayt_uiTabs parameter.

Parameter type:Array
Default value:

ignore|ignoreall|add

Possible values:
  • ignoreall|add|option|language|dictionary|about – Show in the SCAYT context menu Ignore All, Add Word, Options, Languages, Dictionaries, and About options.
  • off Do not show any additional commands in the context menu except a list of main suggestions and the More Suggestions sub-menu.
  • all Enable all available commands in the context menu.
  • ignoreall Add the Ignore All command to the context menu.
  • add Add only the Add Word command to the context menu.
  • option Add the Options item to the context menu.
  • language Add the Languages item to the context menu. It opens the Languages tab of the SCAYT settings dialog. The Languages tab contains the list of the available languages for spell checking and is used for setting the default spell checking language.
  • dictionary Add the Dictionaries item to the context menu. It opens the Dictionary tab of the SCAYT settings dialog. The Dictionaries tab is used for the personal user dictionary management. It allows users to create personal dictionaries with custom words such as complex words, acronyms, proper names, and others and use them while working with the system.
  • about Enable the About menu item.

Example: 

//Show only the Add Word and Ignore All commands in the context menu.
config.scayt_contextCommands = 'add|ignoreall';

Back to the top...


scayt_sLang

Description:

scayt_sLang parameter sets a language short code of the default language that will be used for spell checking. 

Parameter type:String
Default value:

en_US (American English)

Possible values:

Example:

//Set the default language to German (de_DE).
config.scayt_sLang = 'de_DE'

Back to the top...


scayt_uiTabs

Description:

scayt_uiTabs parameter customizes the SCAYT settings dialog and manages visibility of particular tabs there such as Options, Languages, and Dictionaries. 

By default, SCAYT settings dialog contains four tabs, namely OptionsLanguages, Dictionaries, and About. The About tab is used to provide the information about the SCAYT version and copyrights. Unlike OptionsLanguages, Dictionaries tabs, it can't be removed.

Parameter type:Array
Default value:

1,1,1

Possible values:
  • 0,0,0 Hide all customizable tabs: OptionsLanguages, and Dictionaries.
  • 0,1,0 Hide the Options and Dictionaries tabs.
  • 0,0,1 – Hide the Options and Languages tabs.
  • 1,1,0 Hide the Dictionaries tab.
  • 1,0,1  Hide the Language tab.
  • 1,1,1 Show all tabs: OptionsLanguages, and Dictionaries.

Example:

//Hide the Languages tab.
config.scayt_uiTabs = '1,0,1';

Back to the top...


scayt_serviceProtocol

Description:

scayt_serviceProtocol parameter specifies a protocol to access the SCAYT service. If this parameter is not specified, the protocol will be automatically defined based on the script location.

This is the parameter that intended for us with the Server version only.

Parameter type:String
Default value:

https

Possible values:
  • http
  • https

Example:

config.scayt_serviceProtocol='https';

Back to the top...


scayt_serviceHost

Description:

scayt_serviceHost parameter specifies a service host name to access the SCAYT service. If this parameter is not specified clearly, the service host will be automatically defined based on the script location.

The SCAYT plugin which is shipped with the default CKEditor packages is pointed to the WebSpellChecker Cloud services. scayt_serviceHost is already predefined in the plugin configuration.

If you are using the Server version, you need to specify the host name that you used during the installation of WebSpellChecker.

Parameter type:String
Default value:

svc.webspellchecker.net

Possible values:
  • svc.webspellchecker.net  The default WebSpellChecker service host name. It is used for the WebSpellChecker Cloud services subscriptions.
  • your_host_name

Example:

config.scayt_serviceHost='your_host_name';

Back to the top...


scayt_servicePort

Description:

scayt_servicePort parameter specifies a service port that will be used to access the SCAYT service. 

This is the parameter that intended for us with the Server version only.

Parameter type:String
Default value:

80

Possible values:

Any available port.

  • 2880 – default port that listens WebSpellChecker AppServer. Use this port if your are using the Server version.

Example:

config.scayt_servicePort ='2880';

Back to the top...


scayt_servicePath

Description:

scayt_servicePath parameter specifies a path that will be used to access the SCAYT service. 

Parameter type:String
Default value:

/virtual_directory/script/ssrv.fcgi

Possible values:
  • Path to the ssrv.fcgi script. Use this if you are using the older versions of WebSpellChecker v4.x and the connection between your app and AppServer is confogured via FastCGI protocol (using SSRV.cgi component).
  • Use '/' if you are using the newer versions of WebSpellChecker v5.x. and you configured the direct connetion with AppServer. In this case also use config.scayt_servicePort ='2880';.

Example:

config.scayt_servicePath ='virtual_directory/script/ssrv.fcgi';

Or

config.scayt_servicePath ='/';

Back to the top...


scayt_srcUrl

Description:

scayt_srcUrl parameter specifies a URL to the SCAYT core.

scayt_srcUrl is intended for use only with the Server version of SCAYT.

Parameter type:String
Default value:

http(s)://your_host_name/virtual_directory/wscbundle/wscbundle.js

Possible values:
  • http(s)://your_host_name/virtual_directory/wscbundle/wscbundle.js
  • http(s)://your_host_name/virtual_directory/lf/scayt3/ckscayt/ckscayt.js

Example:

config.scayt_srcUrl ='http(s)://your_host_name/virtual_directory/wscbundle/wscbundle.js"';

Back to the top...


scayt_customDictionaryIds

Description:

scayt_customDictionaryIds parameter specifies a custom dictionary ID that will be linked with SCAYT.

Parameter type:String 
Default value:

None

Possible values:IDs of custom dictionaries.

Example:

config.scayt_customDictionaryIds='3021,3456,3478';

Back to the top...


scayt_userDictionaryName

Description:

scayt_userDictionaryName parameter predefines a specific user dictionary that will be used with SCAYT.

Parameter type:String
Default value:

None

Possible values:Any name of a user dictionary.

Example:

config.scayt_userDictionaryName='user_dictionary_name';

Back to the top...


scayt_contextMenuItemsOrder

Description:

scayt_contextMenuItemsOrder parameter defines the order of SCAYT context menu items by groups. This must be a string with one or more of the following words separated by a pipe character ('|').

Parameter type:String
Default value:

suggest|moresuggest|control

Possible values:
  • suggest – main suggestion word list; 
  • moresuggest – more suggestions word list; 
  • control – SCAYT commands, such as “Ignore” and “Add Word”. 

Example:

config.scayt_contextMenuItemsOrder = 'moresuggest|control|suggest';

Back to the top...


scayt_elementsToIgnore

Description:

scayt_elementsToIgnore parameter defines HTML tags that will be ignored during check spelling.

Parameter type:String
Default value:

'style'

Possible values:Any HTML tag

Example:

config.scayt_elementsToIgnore='del,pre'';

Back to the top...


scayt_multiLanguageMode DEPRECATED | WSC 5.3.2

Description:

scayt_multiLanguageMode parameter turns on/off a special multi-language support mode.

scayt_multiLanguageMode parameter was specifically designed to work with a certain language plugin for CKEditor. Before using this parameter, CKEditor Language plugin must be added.

Parameter type:Boolean
Default value:

false

Possible values:
  • true – multi-language support turns on after the editor loading.
  • false

Example:

config.scayt_multiLanguageMode='true';

Back to the top...


scayt_multiLanguageStyles DEPRECATED | WSC 5.3.2

Description:

scayt_multiLanguageStyles parameter allows defining additional styles for misspelled words specific for a particular language.

scayt_multiLanguageStyles can be used only if the _include_scayt_parameters_for_ckeditor4#scayt_multiLanguageMode parameter is set to “true”.  

Parameter type:Object
Default value:

None

Possible values:

{
'Language_short_code': 'background-image: none; color: #cc22cc',
'el': 'background-image: none; color: blue',
'nl': 'background-image: none; color: red',
'fi': 'background-image: none; color: indigo',
'fr': 'background-image: none; color: orange',
'de': 'background-image: none; color: green'
};

All short codes should be presented according ISO 639-1:2002 codes.

Example:

config.scayt_multiLanguageStyles= {'fr': 'color: green'};

Back to the top...


Check a demo page with SCAYT plugin for CKEditor on our website.


Still Have a Question?

Please feel free to contact our technical team if you are having any difficulties with configuration.

Configuring WSC plugin for CKEditor 4

 Check how to configure WSC Dialog plugin for CKEditor...

This guide outlines the main steps that you need to follow in order to integrate and configure the WebSpellChecker (WSC) Dialog plugin for CKEditor 4. All the described steps are provided for the Server version of WSC.

1. Initialize CKEditor 4

Before integrating and configuring the WSC plugin, CKEditor should be properly configured in your web application. If you haven't done it yet, please refer to Example CKEditor Setups on the CKEditor documentation pages. 

2. Configure WSC Dialog Plugin

The next step is to define necessary WSC Dialog parameters and options in the CKEditor config.js file.

config.wsc_customLoaderScript = "http(s)://your_host_name/spellcheck/lf/22/js/wsc_fck2plugin.js";
  • Define additional WSC parameters (e.g. change default language, adjust dialog view, etc.). 
config.wsc_lang = 'de_DE';
config.wsc_height = 800;
config.wsc_width = 800;


 Click here to see a full list of WSC Dialog API parameters and possible values...

Here you can find a list of all available WSC Dialog parameters for CKEditor 4.0+ that can be used for the WSC configuration. Also, you may visit CKEDITOR configuration documentation.

 Click here to explore a full list of parameters...

wsc_customLoaderScript

Description:

wsc_customLoaderScript parameter specifies a URL to the WSC Dialog script.

wsc_customLoaderScript is intended for use only with the Server version of WSC Dialog.

Parameter type:String
Default value:

None

Possible values:Path to the wsc_fck2plugin.js script: "/virtual_directory/lf/22/js/wsc_fck2plugin.js"

Example:

config.wsc_customLoaderScript = "http(s)://your_host_name/virtual_directory/lf/22/js/wsc_fck2plugin.js";

Back to the top...


wsc_customerId

Description:

wsc_customerId parameter sets a customer ID for Cloud WSC Dialog. It is required for migration from free, ad-supported version to paid, ad-free version. 

wsc_customerId is intended for use only with the Cloud version of WSC Dialog.

Parameter type:String
Default value:

A free version of WSC plugin is shipped with already predefined encrypted customer ID value.

Possible values:encrypted-customer-id

Example:

config.wsc_customerId = 'encrypted-customer-id';

Back to the top...


wsc_lang

Description:

wsc_lang parameter sets a language short code of the default language that will be used for spell checking. 

Parameter type:String
Default value:

en_US (American English)

Possible values:

Example:

config.wsc_lang = 'de_DE';

Back to the top...


wsc_customDictionaryIds

Description:

wsc_customDictionaryIds parameter specifies a custom dictionary ID that will be linked with WSC Dialog.

Parameter type:String
Default value:

None

Possible values:

IDs of custom dictionaries separated with commas (' , ').

Example:

config.wsc_customDictionaryIds = '1,3001';

Back to the top...


wsc_userDictionaryName

Description:

wsc_userDictionaryName parameter predefines a specific user dictionary that will be used with SCAYT.

Parameter type:String
Default value:

None

Possible values:

Any name of a user dictionary.

Example:

config.wsc_userDictionaryName = 'user_dictionary_name';

Back to the top...


wsc_cmd

Description:

wsc_cmd parameter sets an active tab which should be shown on the dialog opening.

Parameter type:String
Default value:

spell

Possible values:
  • spell spell checking tab;
  • thes thesaurus tab;
  • grammar grammar checking tab.

Example:

config.wsc_cmd  = 'thes';

Back to the top...


wsc_height

Description:

wsc_height parameter sets the height in pixels of WSC Dialog.

Parameter type:String
Default value:

Content-based

Possible values:Any height size in pixels.

Example:

config.wsc_height = 800;

Back to the top...


wsc_width

Description:

wsc_width parameter sets the width in pixels of WSC Dialog.

Parameter type:String
Default value:

580

Possible values:Any width size in pixels.

Example:

config.wsc_width = 800;

Back to the top...


wsc_top

Description:

wsc_top parameter sets a top margin value in pixels of WSC Dialog.

Parameter type:String
Default value:

Fixed position in the middle of the screen.

Possible values:Any top margin value in pixels.

Example:

config.wsc_top = 0;

Back to the top...


wsc_left

Description:

wsc_left parameter sets a left margin value in pixels of WSC Dialog.

Parameter type:String
Default value:

Fixed position in the middle of the screen.

Possible values:Any left margin value in pixels.

Example:

config.wsc_left = 0;

Back to the top...


Can be also useful:


Check a demo page with WSC plugin for CKEditor on our website.


Still Have a Question?

Please feel free to contact our technical team if you are having any difficulties with configuration.



  • No labels