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.
xili-language plugin does not create addition tables in the database. xili-language simply makes proper use of the taxonomy tables and postmeta table offered by WordPress to define language and link items between them. Because xili-language plugin does not modify deeply the post edit UI, it is possible to use iPhone / iPod Touch WordPress app to prepare and draft the post.

Documentation : A new table summarizes all the technical features of this powerful plugin for personalized CMS created by webmaster. 

1.6.1

* sticky posts are now managed (see demo multisite)

1.5.5 compatible also with WP 3.0-beta

* incorporate automatic detection of theme domain for WP 3.0 and his new default theme ‘twentyten’
* remains compatible for previous versions WP 2.9.x
* Tests were started with recent WP 3.0-alpha. Very few modifications were necessary.
* Rename two filters (as manage_edit_columns) for compatibility with filters renamed (as manage_posts_columns) by WP3.0. Incorporate new posts edit UI modifications of WP3.0.
* improved template_tags : xiliml_the_category, xiliml_the_other_posts (see source doc)
Contact us to test…
* can be tested with WP 3.0-beta multisite mode (WPMU) – contact-us for more docs.

1.4.1

* Browser’s window title now translated for categories (wp_title()). Option in post edit UI to auto-search linked posts in other languages – see this post.
* New option to adapt the home query according rules defined by chief editor. If home page loop is filled by most recent posts (via index or home.php), formerly, by default xili-language is able to choose the theme’s language but not to sub-select the loop (without php coding). Now when checking in Settings ‘Modify home query’ – no need to be a php developer.
* New widget for recent posts (able to choose language). This new widget solves conflicts or issues occuring when WP default widget is present (contains an obscure wp_reset_query – tracs #12320). Also a choice of language of this list of recent posts is possible – not necessary the same of the current page. And you can install multiple widgets. Replace WP Recent Posts Widget by this one named – List of recent posts -

1.3.x

* New functions to change and restore loop’s language query-tag (see functions table).
* Better dashboard post UI to create linked post: from one post, it possible to create linked post in another language and the links are prefilled. Just need to save draft to save the links between root and translated posts filled by authors.
Add a new linked post in other language
* fixes lost languages’s link when trash or untrash (WP 2.9.1).

1.2.1

Admin UI : fixes some directories issues for (rare) xamp servers – Some improvements in post edit UI.
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.5.0 and WP 3.0

Nothing to do in functions.php : only verify that the theme is localizable and functions.php contains a function load_theme_textdomain(); and that the theme’s folder contains .mo files (in root or a sub-folder) for each languages of your website. « twentyten » default WP theme is compatible.

Plugin is backward compatible for theme of monosite. But if you upgrade, it is better to restore you theme with default load_theme_textdomain();. Delete lines concerned by constants THEME_TEXTDOMAIN and languages sub-folder THEME_LANGS_FOLDER. NOTE FOR THEMES DESIGNER : If your theme is compatible both for newest (>3.0-apha) and older versions, add some conditional lines.

SPECIAL NOTE FOR VERSION >= 1.5.0 and WP 2.9.x

Example with ‘fusion’ theme that offers localization:

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'); 
}

Example with a theme theme that offer localization but not permit automatic detection (no terms with domain inside index.php) : replace

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

by

function init_language(){
    if (class_exists('xili_language')) {
        define('THEME_TEXTDOMAIN','thedomain');
    } else {
       load_theme_textdomain('thedomain', 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.

What about WPMU and the trilogy ?

xili-language, xili-tidy-tags, xili-dictionary

Since WP 3.0-alpha, if multisite is activated, the trilogy is now compatible and will include progressively some improvements dedicaded especially for WPMU context. Future specific docs will be available for registered webmasters. Contact us.

How to see post or page ID in dashbord ?

Reveal IDs for WP Admin is an efficient plugin found in WP repository.

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.