From ca6be9eddbfedfdbb0ded7b256d72f8b0b50305b Mon Sep 17 00:00:00 2001 From: Damian Mooyman Date: Mon, 5 Sep 2016 17:54:45 +1200 Subject: [PATCH] Document iconv a bit better Fixes https://github.com/silverstripe/silverstripe-cms/issues/1002 --- docs/en/02_Developer_Guides/13_i18n/index.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/en/02_Developer_Guides/13_i18n/index.md b/docs/en/02_Developer_Guides/13_i18n/index.md index be74b0436..81cc1fd85 100644 --- a/docs/en/02_Developer_Guides/13_i18n/index.md +++ b/docs/en/02_Developer_Guides/13_i18n/index.md @@ -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 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, limit the character filtering in the underlying configuration setting, by setting `URLSegmentFilter.default_use_transliterator` to `false` in your YAML configuration.