Translator_XH - a CMSimple_XH Plugin

Translator_XH is an advanced tool for translating the CMSimple core, pluginloader and individual plugins.

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!

Important Notice

Translator_XH couldn't be tested so far in various environments. It is a so called BETA version. Use with caution.

back to top

Requirements

Translator_XH is a plugin for CMSimple_XH.

back to top

Installation

The installation is done as with many other CMSimple_XH plugins. See the CMSimple_XH wiki for further details.

  1. Backup the data on your server.
  2. Unzip the distribution on your computer.
  3. Upload the whole directory translator/ to your server into the CMSimple_XH plugins directory.
  4. Set write permissions for the subdirectories config/, css/ und languages/. The languages/ folders of the core and the plugins which should be translated, must have write permissions too.
  5. Switch to Translator in the back-end to check if all requirements are fulfilled.
back to top

Settings

The plugin's configuration is done as with many other CMSimple_XH plugins in the website's back-end. Select Translator from "Plugins".

You can change the default settings of Translator_XH in "Plugin Config". Hints for the options will be displayed when hovering over the help icon with your mouse. Particularly have a look at "translation_author" and "translation_license".

Localization is done in "Plugin Language". You can translate the character strings to your own language, or customize them according to your needs. You might prefer to do this with the advanced facilities of Translator_XH – so have a look at Usage.

You can customize the look of Translator_XH in "Plugin Stylesheet". Particularly have a look at the commented stylings.

back to top

Usage

In CMSimple's back-end choose Translator→Translations to see a list of all translatable plugins. Just click one of the displayed plugins to translate it – the translation page should be pretty much self explaining.

If you want to store the translated plugins as properly arranged zip archive, just select the plugins you want to include on the translatable plugins page, enter the file name and press the save button.

back to top

Limitations

Currently the only limitations I'm aware of, are caused by the chosen character enconding ("meta_codepage"), as all language files will be loaded and saved with this encoding.

back to top

License

Translator_XH is licensed under GPLv3.

© 2011 Christoph M. Becker

back to top

Credits

Translator_XH was inspired by Tata and oldnema. Many thanks for your ongoing efforts to make CMSimple_XH and it's plugins available for users speaking the czech resp. slovak language.

This plugin uses zip.lib.php by Garvin Hicking. Many thanks to making this fine PHP class freely available.

This plugin uses free applications icons from Aha-Soft. Many thanks to making these icons freely available.

Many thanks to the community at the CMSimple forum for tips, suggestions and testing. Particularly I want to thank oldnema, Tata and svasti for their encouraging feedback.

And many thanks to all developers of CMSimple_XH and Peter Harteg, who developed CMSimple, without whom this amazing CMS wouldn't exist.

back to top