Utf8_XH helps with the conversion from ANSI encoded CMSimple websites to UTF-8, a reasonable step when updating to CMSimple_XH ≥ 1.2.
Please do read this documentation! Support might not be given otherwise. It's generally a good idea to read the documentation, before you encounter any problems!
Utf8_XH couldn't be tested so far in various environments. It is a so called BETA version. Use with caution!
Utf8_XH is a plugin for CMSimple_XH. It requires a UTF-8 encoded version and jQuery4CMSimple.
The installation is done as with many other CMSimple_XH plugins. See the CMSimple_XH wiki for further details.
The plugin's configuration is done as with many other CMSimple_XH plugins in the website's back-end. Select "Utf8" from "Plugins".
You can change the default settings of Utf8_XH in "Plugin Config". Hints for the options will be displayed when hovering over the help icon with your mouse.
Localization is done in "Plugin Language". You can translate the character strings to your own language, or customize them according to your needs.
The look of Utf8_XH can be customized in "Plugin Stylesheet".
Utf8_XH is used exclusively in the back-end. Select Plugins → Utf8 → Files to see a simple tree view of all files in the current CMSimple_XH installation, that have one of the configurable extensions. The folders can be collapsed/expanded by clicking on their name. The icon beside the file name displays the status. If the file is already UTF-8 encoded without BOM, a green checkmark is shown, otherwise a red exclamation mark. If a file or folder can't be read, a blue question mark is displayed.
Check the files you want to convert to UTF-8, select their current encoding in the box at the bottom of the page and press "Convert". If you're not sure, in which charset the files are encoded, you shouldn't use Utf8_XH to convert the files. Nonetheless the plugin might be useful to detect which files are not UTF-8 encoded. Those files can be converted with any decent text editor, e.g. Notepad++.
N.B.: when converting to UTF-8 the URLs of your pages might change, if the page headings contain non-ASCII characters which were not escaped by urichar_org/new. If you want those pages to be accessible through existing links, you have to use some kind of URL rewriting mechanism provided by your webserver, e.g. mod_rewrite for Apache.
Utf8_XH is licensed under GPLv3.
© 2012 Christoph M. Becker
The plugin icon is designed by the Oxygen Team. Many thanks for publishing this icon under GPL.
This plugin uses free applications icons from Aha-Soft. Many thanks for making these icons freely available.
And last but not least many thanks to all developers of CMSimple_XH without whom this amazing CMS wouldn't exist.