Logo xili-language

xili-language plugin provides an automatic selection of language in theme according to the language of one post. xili-language use on the fly the .mo files present in the theme’s folder.

Themes with localization can be easily transformed in multilingual site.
It is dedicaced for theme’s creator or webmaster with knowledges in CMS and WP and having tools to create .mo language files. The plugin add automatic tools (or links or filters) for sidebar or top menus. Categories lists are translated also. xili-language provides also series of functions which can be hooked in the functions.php file of the theme that you create i.e. for a multilingual cms like website.
With xili-tidy-tags plugin [here], it is now possible to display sub-selection (cloud) of tags according language. With xili-dictionary plugin (beta), it is easier to create online via admin UI the files .mo of each languages.

1.2.0

Full tests with lastest wp 2.9.1. New admin UI localization joined (RU – © see header of xili-language-ru_RU.po)

1.1.8, 1.1.9

Intermediate release
Optional improve hooking ways to be compatible with l10n cache of Johan’s plugin see line 2200. Automatic detection of theme_text_domain and languages (.mo) sub-folder in theme’s folder.
More infos in Settings UI Special sidebox.
Fixes title of wp_get_archives links with current permalinks. Possible that very special permalinks need to use hook named xiliml_get_archives_link.

This release adds new features dedicated to multilingual theme’s creators and webmasters. Some new php functions, a folder to include functions shared by themes (not necessary to put functions in functions.php of the current theme); example with a shortcode to insert link inside content toward another post in a language. A post explaining these improvements can be found in this post . Since 1.1.8, xili-language is also tested with future wordpress 2.9-rare.

1.1

improve function and theme tag «  xiliml_the_others_posts() »
(this template tag displays list of links of linked posts in other languages – by example in subtitle)

1. to be used in multilingual category loop and
2. 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.
   IMPORTANT : if this function was previously hooked for your theme, it works but you must review the hooking function of your functions.php to include new array option (see plugin code).

1.0

This version 1.0 to salute Wordpress 2.8. and some adds : new ways to choose language of home page through a popup in settings page. Ready to have more customized functions in a specific folder (and not only in functions.php of current theme). Reserved to theme’s designers…

0.9.9.6

Multiple Languages List Widget
xili-language list widget is now « multiple » ready. If the theme contains more than one sidebar, it is possible to adapt the list of languages for each sidebar. Designers of theme will be happy to find a way to change html tags of list.
More… a new item is added in widget : Type. This option offers a way to select type of languages list.
Enrichable through hooks and your function in functions.php, the available default option « typeone » deliver a list (without the selected language) and the link when in categories pages go a subselection in this language and this category.
See this post to enrich your list with flags or other behaviours depending which part of website is displayed (front-page, categories, search….)

Tested with wordpress 2.8-beta2-11509

A technical post

A new post about template tags here

0.9.9.5

php doc enhanced, link to modify linked posts in post edit UI
link to edit directly post in other language

compatible with old server in php4 !?
0.9.9.4
New 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). Sub selection of archives for `wp_get_archives()` with &lang= : see installation notes.

If frontpage is a page, select correlated page according language see Other notes.
0.9.9.3
sub selection of pages for `wp_list_pages()` with &lang=, some fixes (other posts, options when activate,…)
Example 1 :

wp_list_pages('title_li=&lang='.the_curlang() );

will display only pages of current lang
Example 2 :

wp_list_pages('title_li=&setlang=0&lang='.the_curlang() );

will display pages of current lang AND pages with lang undefined (polyglot pages).

and soon examples how to install selected rss as visible here in the left sidebar.

0.9.9.2

fixe class of metabox has-right-sidebar for 2.8 – some other admin UI sizing, W3C – improved template-tag default function `xiliml_the_other_posts()` display (if you had hook it in previous version, verify the hook of your functions.php, see php code lines 1314, 1650).

0.9.9

now provides infos about **text direction** *ltr* ou *rtl* of languages (arabic, hebraic,…) of theme and of each post in loop see note [direction in installation](http://wordpress.org/extend/plugins/xili-language/installation/). Soon more infos and demos for designers if multilingual theme. Some fixes (thanks to Jacob about QuickEdit UI bug when post update).

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 –
3. define domain name of 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 – language – 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 flag in xili-language sub-windows at the right of the editing window before publishing.

See this post about template tags here…

SPECIAL NOTE FOR VERSION >= 1.1.9

With the cost of 50 lines more, plugin now detect automatically (if theme is good) the theme_text_domain and languages (.mo) sub-folder. It not mandatory to declare the two constats (but compatible with previous settings).
Only encapsule the `load_theme_textdomain()` like in that example for a theme named fusion:

if (!class_exists('xili_language')) { // class in not (!) present...
   load_theme_textdomain('fusion', get_template_directory() . '/lang');	
}

NOTE

In the functions php file of the theme : replace by commenting `load_theme_textdomain` line `//load_theme_textdomain(‘mythemename’); ` by a *define* `define(‘THEME_TEXTDOMAIN’,'mythemename’); //second text must be used in theme texts with _e( , ) or __( , )` where ‘mythemename’ is `’kubrik’` in default international theme.

Another example with fusion theme that offer localization :

replace

function init_language(){
	load_theme_textdomain('fusion', get_template_directory() . '/lang');
}

by

function init_language(){
	if (class_exists('xili_language')) {
		define('THEME_TEXTDOMAIN','fusion');
		define('THEME_LANGS_FOLDER','/lang');
	} else {
	   load_theme_textdomain('fusion', get_template_directory() . '/lang');	
	}
 
}

see the [recent post](http://dev.xiligroup.com/?p=427 « Transform a theme with localization »).

Browser detection
To change the language of the frontpage according to the language of the visitor’s browser, check the button in right small box in settings.

text direction, since 0.9.9

Examples *for theme’s designer* of functions to keep text **direction** of theme and of current post :

<?php 
	$themelangdir = ((class_exists('xili_language')) ? the_cur_lang_dir() : array ()) ; ?>
<div class="inside <?php echo $themelangdir['direction'] ?>">
...

example in loop :

<?php while (have_posts()) : the_post(); 
$langdir = ((class_exists('xili_language')) ? get_cur_post_lang_dir($post->ID) : array());
?>
      <div class="story <?php echo $langdir['direction'] ?>" >

minimal example in css :

.rtl {direction: rtl; text-align:right !important; font-size:130% !important;}
.ltr {direction: ltr; text-align:left !important;}

Caution : multilingual theme with both ltr and rtl texts needs a rigourous structure of the css !

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.

Wordpress 2.8 beta

Today, xili-language is ‘compatible’ with ‘nightly’ of next WP release.

Are the default rules (functions) of xili-language plugin hookable ?

Yes, by theme’s developers. In plugin’s php script, all is documented and the hooks can be added in functions.php file of the theme. Here one example to create a languages list with flag as here in left sidebar.

Where can I see websites using this plugin ?

dev.xiligroup.com (« why xili-language ? »)
and
www.xiliphone.mobi (« a theme for mobile ») also usable with mobile as iPhone.

JacobandEric informs that these two websites are powered by xili-language :
http://terranovasite.com/blog/
http://altitude-blog.com/

1. an example of wp-content/themes folder of a theme with localization files (.mo)
an example of wp-content/themes folder
2. the admin settings UI
the admin settings UI
3. the language setting in post writting UI
the language setting in post writting UI
4. coding extract with ‘international’ text in ‘xiliphone’ theme
coding extract with 'international' text in 'xiliphone' theme
5. Admin Tools UI – pre-set default language of author according his browser’s language.
Admin Tools UI - pre-set default language of author according his browser's language.
6. xili-tidy-tags : Admin Tools UI – see this compatible plugin to group tags according languages
xili-tidy-tags : Admin Tools UI - see this compatible plugin to group tags according languages
7. xili-dictionary : Admin Tools UI – list of translated terms
xili-dictionary : Admin Tools UI - list of translated terms

What happens if frontpage is a page ?

Before publishing an ‘how-to‘, since 0.9.9.4, the plugin incorporates now features that are formerly possible through the hookable functions of xili-language. The page frontpage must have her clones in each other languages. As for posts, if the user’s browser is not in the default language, xili-language will display the page in the corresponding language if set by the editor. Be patient, a detailled post will arrive soon…

The first beta releases was for theme’s creator or designer.

See also the other posts about xili-language here.

and the [Wordpress plugins forum].

The current version is available in the Wordpress Plugins Directory repository.