WordPress.org

READ CAREFULLY ALL THE README AND PREREQUISITES

See also wiki.

1. Upload the folder containing xili-language.php and language files to the /wp-content/plugins/ directory,
2. Verify that your theme is international compatible - translatable terms like _e('the term','mytheme') and no text hardcoded - and contains .mo and .po files for each target language - (application poEdit and/or plugin xili-dictionary can be used)
3. verify that a domain name is defined in your theme - see note at end list below,
4. Activate the plugin through the 'Plugins' menu in WordPress,
5. Go to the dashboard settings tab - languages - and adapt default values if necessary by adding your languages in the catalog. You can set the order (1,2,3...) of the series. (used in language_attributes() template_tag).
6. Modify each post by setting (checking) the language in xili-language box (under the content box) before publishing.
7. Others settings and parts (Browser detection, widgets, shortcode, template tags) see below… and examples.

Additional infos

1. Before using your own theme, to understand how xili-language works, install the example child theme of Twentyten Twelve shown in this commented demo site.
2. Child of TwentyTen, Twenty Eleven, Twentyten Twelve themes include a navigation menu - downloadable here -. In xili-language settings it is possible to insert automatically languages menu in the menu previously set by you.
3. If you are webmaster and want to add lot of personalizations in your theme, read source and visit expert's corner.

Browser detection for visitors or authors

To change the language of the frontpage according to the language of the visitor's browser, check the popup in right small box in settings. To change the default language of a new post according to the language of the author's browser, check the popup in right small box in settings.

xili-language and widgets

Three widgets are created to enrich sidebar : list of languages, recent posts and recent comments with sub-selection according current language.

xili-language and shortcode

Shortcode to add a link to other language inside content of a post like

[linkpost lang="fr_FR"]

is available in a library in complement to xili-language.

xili-language and template tags

• xili-language "translates" template tags and permits some variations for webmasters:

The most current template tags don't need special work: wp_list_categories(), wp_title(),...

wp_get_archives

Possible that very special permalinks need to use hook named xiliml_get_archives_link. - Sub selection of archives for wp_get_archives() with &lang= (see § below)

wp_list_pages()

with optional query tag &lang=

• xili-language "provides" new template tags (or widgets) to solve issues from WP core or add new features for CMS:

xili_language_list()

• outside loop (sidebar) display the languages of the site (used also by widget)

xiliml_the_category()

• replace the_category() template tag of WP Core

improved xiliml_the_others_posts() function and theme tag to be used in multilingual category loop and by option (array) to return an array of linked posts in other languages (useful for CMS webmasters) (array of lang and id ) - the id is easily transformable in permalink with function get_permalink() when using this array.

• widget for recent comments that can subselect those for current language. (a function xiliml_recent_comments() is also available if you want to create a template tag with resulting objects array).

Archives selection

Archives tags is a very complex template tag in his background and not very easy source hookable. So we decided to add few features : by adding query in vars of the function, it will be possible to display a monthly list of archives for a selected language - wp_get_archives('..your.vars..&lang=fr_fr') - or the current the theme language - wp_get_archives('..your.vars..&lang=') -. The displayed list of links will be translated and link restrited to display only archives of this language.