Internationalization (i18n) library for CodeIgniter 2

Language in URL:

• maestric.com/en/about
• maestric.com/fr/about

Keep using CodeIgniter Language Class

View

<p><?=lang('about.gender')?></p>

English language file

$lang['about.gender'] = "I'm a man";

French language file

$lang['about.gender'] = "Je suis un homme";

Result with maestric.com/en/about

<p>I'm a man</p>

Result with maestric.com/fr/about

<p>Je suis un homme</p>

• Download ci_i18n_library.zip (if using Codeigniter 1.7, see previous version)
• Put MY_Lang.php and MY_Config.php in application/core

In application/config/routes.php add

// example: '/en/about' -> use controller 'about'
$route['^fr/(.+)$'] = "$1";
$route['^en/(.+)$'] = "$1";
 
// '/en' and '/fr' -> use default controller
$route['^fr$'] = $route['default_controller'];
$route['^en$'] = $route['default_controller'];

Let's build a bilingual English/French page.

application/language/english/about_lang.php

<?php
 
$lang['about.gender'] = "I'm a man";
 
/* End of file */

application/language/french/about_lang.php

<?php
 
$lang['about.gender'] = "Je suis un homme";
 
/* End of file */

application/controllers/about.php

<?php
class About extends CI_Controller {
 
	function index()
	{
		// you might want to just autoload these two helpers
		$this->load->helper('language');
		$this->load->helper('url');
 
		// load language file
		$this->lang->load('about');
 
 
		$this->load->view('about');
	}
}
 
/* End of file */

application/views/about.php

<p><?=lang('about.gender')?></p>
 
<p><?=anchor('music','Shania Twain')?></p>

http://your_base_url/en/about

<p>I'm a man</p>
 
<p><a href="http://mywebsite.com/en/music">Shania Twain</a></p>

http://your_base_url/fr/about

<p>Je suis un homme</p>
 
<p><a href="http://mywebsite.com/fr/music">Shania Twain</a></p>

• You might need to translate some of CodeIgniter's language files in system/language. Example: if you're using the “Form Validation” library for French pages, translate system/language/form_validation_lang.php to application/language/french/form_validation_lang.php.

• links to internal pages are prefixed by the current language, but links to files are not.

site_url('about/my_work');
// http://mywebsite.com/en/about/my_work
 
 
site_url('css/styles.css');
// http://mywebsite.com/css/styles.css

• Get the current language

$this->lang->lang();
// en

• Switch to another language

anchor($this->lang->switch_uri('fr'),'Display current page in French');

• the root page (/) is supposed to be some kind of splash page, without any specific language. This can be changed: see “No splash page” below.

MY_Config.php contains an override of site_url(): add language segment (when appropriate) to generated URLs. Also used by anchor(), form_open()...

A special URI is not prefixed by a language. The root URI (/) is by default a special URI.

You might need other special URIs, like for an admin section in just one language.

In application/core/MY_Lang.php, add admin to the $special array. Now, links to admin won't be prefixed by the current language.

site_url('admin');
// http://mywebsite.com/admin

In application/core/MY_Lang.php

• remove ”” from the $special array
• set $default_uri to something else like home
• now a request to / will be redirected to en/home, if English is your default language
• the default language is the first item of the $languages array

• application/core/MY_Lang.php: add new language to $languages array

// example: German (de)
'de' => 'german',

• application/config/routes.php: add new routes

// example: German (de)
$route['^de/(.+)$'] = "$1"; 
$route['^de$'] = $route['default_controller'];

• create corresponding language folder in application/language. For this “German” example, it would be called german.