You are here

INSTALL.txt in Wysiwyg SpellCheck 6

Same filename and directory in other branches
  1. 7 INSTALL.txt
Wysiwyg SpellCheck Module Installation

To enable this module, follow these instructions:

1. Upload the "Wysiwyg SpellCheck" module to your sites/all/modules folder.

2. Enable the "Wysiwyg SpellCheck" module on the admin/build/modules page.

3. Install spellchecker plugin
In order to use Spell Checker, you will need to download and install spellchecker plugin appropriate for your editor.

TinyMCE spellchecker plugin
===========================

Browser-side TinyMCE spellchecker plugin (steps numbered BST#):
NOTE:
TinyMCE ver 3.4.4 has the default option for browser-side spellchecker on supported browsers,
but it is not yet supported by this module. It might work on some browsers, but was not tested.
BST1. Instructions TBD.

Server-side TinyMCE spellchecker plugin (steps numbered SST#):
(These instructions explain how to install and enable server-side spellchecker)

SST1. Download, extract and copy spellchecker plugin from
from http://www.tinymce.com/download/download.php
(Once you are on the download page, download "PHP Spellchecker" 2.x which is listed in the "Other components" section)

into
sites/all/libraries/tinymce/jscripts/tiny_mce/plugins/
(overwrite files that came with TinyMCE)

After installation it should be found in sites/all/libraries/tinymce/jscripts/tiny_mce/plugins/spellchecker/

As a quick check, the following files should be present in the above path:
- editor_plugin.js
- config.php

SST2. Edit sites/all/libraries/tinymce/jscripts/tiny_mce/plugins/spellchecker/config.php

Uncomment one of the lines that select which spellchecker to use:

*It comes with defaults using Google spellchecker.

*Other options: TBD

SST3. Visit http://YOURSITE/admin/reports/status, verify that Wysiwyg TinyMCE spellchecker reports "Installed correctly".

SST4. Visit http://YOURSITE/sites/all/libraries/tinymce/jscripts/tiny_mce/plugins/spellchecker/rpc.php,
you should see a string in curly braces {"result":null,...}.
If you don't see the expected {"result":null,...}, you will have to figure out access permissions or other problems with your webserver or ISP.

SST5. Configure one of your WYSIWYG profiles to show TinyMCE spellcheck button

SST6. Verify that TinyMCE shows the new button when you edit a page using your WYSISWYG profile, and this button works.


CKEditor ASpell plugin
======================

Browser-side CKEditor spellchecker plugin (steps numbered BSC#):
NOTE:
CKEditor has the default option for browser-side spellchecker on supported browsers,
but it is not yet supported by this module. It might work on some browsers, but was not tested.
BSC1. Instructions TBD.

Server-side CKEditor spellchecker plugin (steps numbered SSC#):
(These instructions explain how to install and enable server-side spellchecker)

SSC1. Aspell library (http://aspell.net) must be installed and working on the server. Do not proceed until it works.

SSC2. Download CKEditor aspell plugin from http://cksource.com/forums/download/file.php?id=512&sid=5cc3ef8ceca1432ebc4459b4241c84aa

SSC3. Unzip the contents of the zip file into sites/all/libraries/ckeditor/plugins so that you have sites/all/libraries/ckeditor/plugins/aspell directory

SSC4. Visit http://YOURSITE/admin/reports/status, verify that Wysiwyg CKEditor spellchecker reports "Installed correctly".

SSC5. Visit http://YOURSITE/sites/all/libraries/ckeditor/plugins/aspell/spellerpages/server-scripts/spellchecker.php,
you should see an empty page. If you inspect source, it should have "function init_spell() {..." inside the head section.
If you don't see the expected "function init_spell() {", you will have to figure out access permissions or other problems with your webserver or ISP.

SSC6. If you aren't using PHP for server-side script (this is rarely needed), edit aspell/dialogs/aspell.js, locate oSpeller.spellCheckScript and change it as appropriate. Redo step #SSC5 for selected script.

SST7. Configure one of your WYSIWYG profiles to show CKEditor spellcheck button (checkbox "Server Side Spell Check")

SST8. Verify that CKEditor shows the new button when you edit a page using your WYSISWYG profile, and this button works.

File

INSTALL.txt
View source
  1. Wysiwyg SpellCheck Module Installation
  2. To enable this module, follow these instructions:
  3. 1. Upload the "Wysiwyg SpellCheck" module to your sites/all/modules folder.
  4. 2. Enable the "Wysiwyg SpellCheck" module on the admin/build/modules page.
  5. 3. Install spellchecker plugin
  6. In order to use Spell Checker, you will need to download and install spellchecker plugin appropriate for your editor.
  7. TinyMCE spellchecker plugin
  8. ===========================
  9. Browser-side TinyMCE spellchecker plugin (steps numbered BST#):
  10. NOTE:
  11. TinyMCE ver 3.4.4 has the default option for browser-side spellchecker on supported browsers,
  12. but it is not yet supported by this module. It might work on some browsers, but was not tested.
  13. BST1. Instructions TBD.
  14. Server-side TinyMCE spellchecker plugin (steps numbered SST#):
  15. (These instructions explain how to install and enable server-side spellchecker)
  16. SST1. Download, extract and copy spellchecker plugin from
  17. from http://www.tinymce.com/download/download.php
  18. (Once you are on the download page, download "PHP Spellchecker" 2.x which is listed in the "Other components" section)
  19. into
  20. sites/all/libraries/tinymce/jscripts/tiny_mce/plugins/
  21. (overwrite files that came with TinyMCE)
  22. After installation it should be found in sites/all/libraries/tinymce/jscripts/tiny_mce/plugins/spellchecker/
  23. As a quick check, the following files should be present in the above path:
  24. - editor_plugin.js
  25. - config.php
  26. SST2. Edit sites/all/libraries/tinymce/jscripts/tiny_mce/plugins/spellchecker/config.php
  27. Uncomment one of the lines that select which spellchecker to use:
  28. *It comes with defaults using Google spellchecker.
  29. *Other options: TBD
  30. SST3. Visit http://YOURSITE/admin/reports/status, verify that Wysiwyg TinyMCE spellchecker reports "Installed correctly".
  31. SST4. Visit http://YOURSITE/sites/all/libraries/tinymce/jscripts/tiny_mce/plugins/spellchecker/rpc.php,
  32. you should see a string in curly braces {"result":null,...}.
  33. If you don't see the expected {"result":null,...}, you will have to figure out access permissions or other problems with your webserver or ISP.
  34. SST5. Configure one of your WYSIWYG profiles to show TinyMCE spellcheck button
  35. SST6. Verify that TinyMCE shows the new button when you edit a page using your WYSISWYG profile, and this button works.
  36. CKEditor ASpell plugin
  37. ======================
  38. Browser-side CKEditor spellchecker plugin (steps numbered BSC#):
  39. NOTE:
  40. CKEditor has the default option for browser-side spellchecker on supported browsers,
  41. but it is not yet supported by this module. It might work on some browsers, but was not tested.
  42. BSC1. Instructions TBD.
  43. Server-side CKEditor spellchecker plugin (steps numbered SSC#):
  44. (These instructions explain how to install and enable server-side spellchecker)
  45. SSC1. Aspell library (http://aspell.net) must be installed and working on the server. Do not proceed until it works.
  46. SSC2. Download CKEditor aspell plugin from http://cksource.com/forums/download/file.php?id=512&sid=5cc3ef8ceca1432ebc4459b4241c84aa
  47. SSC3. Unzip the contents of the zip file into sites/all/libraries/ckeditor/plugins so that you have sites/all/libraries/ckeditor/plugins/aspell directory
  48. SSC4. Visit http://YOURSITE/admin/reports/status, verify that Wysiwyg CKEditor spellchecker reports "Installed correctly".
  49. SSC5. Visit http://YOURSITE/sites/all/libraries/ckeditor/plugins/aspell/spellerpages/server-scripts/spellchecker.php,
  50. you should see an empty page. If you inspect source, it should have "function init_spell() {..." inside the head section.
  51. If you don't see the expected "function init_spell() {", you will have to figure out access permissions or other problems with your webserver or ISP.
  52. SSC6. If you aren't using PHP for server-side script (this is rarely needed), edit aspell/dialogs/aspell.js, locate oSpeller.spellCheckScript and change it as appropriate. Redo step #SSC5 for selected script.
  53. SST7. Configure one of your WYSIWYG profiles to show CKEditor spellcheck button (checkbox "Server Side Spell Check")
  54. SST8. Verify that CKEditor shows the new button when you edit a page using your WYSISWYG profile, and this button works.