Document iconv a bit better

Fixes https://github.com/silverstripe/silverstripe-cms/issues/1002
This commit is contained in:
Damian Mooyman 2016-09-05 17:54:45 +12:00
parent fc353dc17a
commit ca6be9eddb
No known key found for this signature in database
GPG Key ID: 78B823A10DE27D1A

View File

@ -108,6 +108,10 @@ This describes the process of converting from one character set to another
while keeping characters recognizeable. For example, vowels with french accents while keeping characters recognizeable. For example, vowels with french accents
are replaced with their base characters, `pâté` becomes `pate`. are replaced with their base characters, `pâté` becomes `pate`.
It is advisable to set the `SS_Transliterator.use_iconv` setting to true via config for systems
which have `iconv` extension enabled and configured.
See [the php documentation on iconv](http://php.net/manual/en/book.iconv.php) for more information.
In order to allow for so called "multibyte" characters outside of the ASCII subset, In order to allow for so called "multibyte" characters outside of the ASCII subset,
limit the character filtering in the underlying configuration setting, limit the character filtering in the underlying configuration setting,
by setting `URLSegmentFilter.default_use_transliterator` to `false` in your YAML configuration. by setting `URLSegmentFilter.default_use_transliterator` to `false` in your YAML configuration.