Improves spellcheck support for Silverstripe CMS, including an implementation for HunSpell.
Ensure that your server is setup with hunspell, and the necessary dictionaries for each language you wish to use.
Install the spellcheck module with composer, using composer require silverstripe/spellcheck ^2.0
, or downloading
the module and extracting to the 'spellcheck' directory under your project root.
- Silverstripe 4.0.2 or above
- Hunspell
Note: this version is compatible with Silverstripe 4. For Silverstripe 3, please see the 1.x release line.
Setup the locales you wish to check for using yaml. If you do not specify any, it will default to the current i18n default locale, and may not be appropriate if you have not configured dictionaries for some locales.
mysite/_config/config.yml
SilverStripe\SpellCheck\Handling\SpellController:
locales:
- en_NZ
- fr_FR
- de_DE
By default only users with the CMS_ACCESS_CMSMain
permission may perform spellchecking. This permisson
code can be altered (or at your own risk, removed) by configuring the SilverStripe\SpellCheck\Handling\SpellController.required_permission
config.
SilverStripe\SpellCheck\Handling\SpellController:
# Restrict to admin only
required_permission: 'ADMIN'
Additional spell check services can be added by implementing the SilverStripe\SpellCheck\Providers\SpellProvider
interface and setting this as
the default provider using yaml.
mysite/_config/config.yml
---
Name: myspellcheckprovider
After: '#spellcheckprovider'
---
# Set the default provider to HunSpell
SilverStripe\Core\Injector\Injector:
SilverStripe\SpellCheck\Data\SpellProvider
class: MySpellProvider