This guide outlines the main steps to integrate and configure WProofreader with auto-searching functionality. All the steps described are provided for the Server version of WProofreader.
The autoSearch feature enables detecting new editable fields on the page and proofreading the text they contain automatically on hover selection. No additional actions or plugins are required for enabling WProofreader in a specific WYSIWYG editor or HTML editable control. A single configuration applies to almost all editors and controls. Here is the list of WProofreader supported integrations.
Step 1. Initialize WProofreader
There are two approaches for initializing WProofreader in your web app: using the config variable or inline data attributes. Their descriptions follow.
Option A. Initializing using Config Variable
1. Add Config with Options
Define the required options in WEBSPELLCHECKER_CONFIG. It can be added to any location on a web page before or after the wscbundle.js script. However, if you add wscbundle.js asynchronously, this CONFIG must be added before the script. In case of the direct connection to WebSpellChecker AppServer (AppServer is an entry point), you need to configure the SSL connection. Follow the steps described on the Enabling SSL connection with AppServer page (if you missed that step during the installation). If you are using the older version of the deployment where SSRV.CGI component is an entry point, please refer to the sample below. You also have an option to load your CONFIG option on your web page from the file. Just create a *.js file (e.g. wscbundle_config.js) with CONFIG. This is an example of the wscbundle_config.js file. Here is an example of the script that you need to add on your web page with the path to wscbundle_config.js.<script>
window.WEBSPELLCHECKER_CONFIG = {
autoSearch: true,
lang: 'en_US', // set the default language
serviceProtocol: 'https',
serviceHost: 'your_host_name',
servicePort: '443',
servicePath: 'virtual_directory/api' // by default the virtual_directory is wscservice
};
</script>
<script>
window.WEBSPELLCHECKER_CONFIG = {
autoSearch: true,
lang: 'auto', // set the default language
serviceProtocol: 'https',
serviceHost: 'your_host_name',
servicePort: '443',
servicePath: 'virtual_directory/script/ssrv.cgi'
};
</script>
window.WEBSPELLCHECKER_CONFIG = {
autoSearch: true,
...
};
<script type="text/javascript" src="[path_to_config]/wscbundle_config.js"></script>
2. Add WProofreader Script
Add the wscbundle.js script on your web page.<script type="text/javascript" src="http(s)://your_host_name/wscservice/wscbundle/wscbundle.js"></script>
Option B. Initializing using Inline Data Attributes
Step 2. Adjust Default Options
You can customize the default options using WProofreader API.
You can check the demos of WProofreader integrations with various rich-text editors on our website.