Loading extra language files: Difference between revisions

From Joomla! Documentation

New page: ==Overview== Many times, you need to load extra language files in your code. An example is loading your component's language file into a module for that component. Following is the code th...
 
Completed according Joomla! Platform 11.4
Line 1: Line 1:
==Overview==
==Overview==
Many times, you need to load extra language files in your code. An example is loading your component's language file into a module for that component. Following is the code that helps you do this
Many times, you need to load extra language files in your code. An example is loading your component's language file into a module for that component. This example loads a single language file, and appends the results to the existing language strings. Following is the code that helps you do this


==PHP Code==
==PHP Code==
Line 8: Line 8:
$base_dir = JPATH_SITE;
$base_dir = JPATH_SITE;
$language_tag = 'en-GB';
$language_tag = 'en-GB';
$lang->load($extension, $base_dir, $language_tag, true);
$reload = true;
$lang->load($extension, $base_dir, $language_tag, $reload);
</source>
</source>


Line 17: Line 18:
2. $base_dir - Should be JPATH_SITE in case you have language files stored elsewhere. Defaults to JPATH_SITE [optional]
2. $base_dir - Should be JPATH_SITE in case you have language files stored elsewhere. Defaults to JPATH_SITE [optional]


3. $language - This is the locale string. Language files for this locale will be loaded. Defaults to the one set in backend. [optional]
3. $language_tag - This is the locale string. Language files for this locale will be loaded. Defaults to the one set in backend. [optional]
 
4. $reload - Flag that will force a language to be reloaded if set to true. [optional]


<noinclude>[[Category:Development]][[Category:Languages]]</noinclude>
<noinclude>[[Category:Development]][[Category:Languages]]</noinclude>

Revision as of 10:53, 28 April 2012

Overview

Many times, you need to load extra language files in your code. An example is loading your component's language file into a module for that component. This example loads a single language file, and appends the results to the existing language strings. Following is the code that helps you do this

PHP Code

$lang =& JFactory::getLanguage();
$extension = 'com_helloworld';
$base_dir = JPATH_SITE;
$language_tag = 'en-GB';
$reload = true;
$lang->load($extension, $base_dir, $language_tag, $reload);

Following is an explanation of the variables

1. $extension - This is the extension whose language file will be loaded

2. $base_dir - Should be JPATH_SITE in case you have language files stored elsewhere. Defaults to JPATH_SITE [optional]

3. $language_tag - This is the locale string. Language files for this locale will be loaded. Defaults to the one set in backend. [optional]

4. $reload - Flag that will force a language to be reloaded if set to true. [optional]