Operating Instructions

1. install "xLanguage" as a regular module

2. select basic languages (from an available language list) and add extended languages (after selecting basic language) from module Admin page for instance, to make language switch between: English, Simplified Chinese (gb2312), Traditional Chinese (big5) and UTF-8 Chinese:

   base 1:

   • name: english;

   • description(optional): English;

   • charset: iso-8859-1;

   • code: en (or another like "xen", not a true language code, just the tag for indicating English content)

   base 2:

   • name: schinese;

   • description(optional): Simplified Chinese;

   • charset: gb2312;

   • code: zh (or anyother like "sc", not a true language code, just the tag for indicating Chinese content)

     extended lang of schinese

     1) name: tchinese;

     • description(optional): Traditional Chinese;

     • charset: big5

     • code: zh-TW (the true language code of Traditional Chinese)

     • base: schinese

       extended lang of schinese

     2: name: utf8;

     • description(optional): Simplified Chinese UTF-8;

     • charset: UTF-8

     • code: zh-CN (the true language code of Simplified Chinese)

     • base: schinese

3. make the block "language selection" visible

4. add multilingual content with according tags specified for each base language (in step 3) to your modules, templates or themes[Skip this step if you do not use multi-language content display but only use charset encoding]:

   wrap content of each language with respective tag specified in step 3: [langcode1]Content of the language1[/langcode1] [langcode2]Content of the language2[/langcode2] [langcode3]Content of the language3[/langcode3] ...

   if two or more languages have same content, you do not need add them one by one but use delimiter "|": [langcode1|langcode2]Content shared by language1&2[/langcode1|langcode2] [langcode3]Content of the language3[/langcode3] ...

   A real example: suppose the lang_codes specified in step 4 are: English-en; French-fr; SimplifiedChiense-sc: My XOOPS[sc]我的XOOPS[/sc]

   OR:

   [english|french]This is my content in English and French[/english|french][schinese]这是我在中国的内容[/schinese]

5. automatic conversion of content from one charset(extended language) to another [Actually on action needed in this step]

6. if you would like to insert hardcoded scripts for language switch in your theme or any template besides the language selection box:

   1) modify /modules/xlanguage/api.php "$xlanguage_theme_enable = true;"

   2) config options "$options = array("images", " ", 3); // display mode, delimitor, number per line";

   3) insert <{$smarty.const.XLANGUAGE_SWITCH_CODE}> into your theme or template files anywhere you prefer it present