Date: Thu, 13 Nov 2008 22:59:24 +0000 Subject: Changing EOL style to LF --- user_guide/libraries/language.html | 272 ++++++++++++++++++------------------- 1 file changed, 136 insertions(+), 136 deletions(-) (limited to 'user_guide/libraries/language.html') diff --git a/user_guide/libraries/language.html b/user_guide/libraries/language.html index 0b5e8a214..4967fe0fd 100644 --- a/user_guide/libraries/language.html +++ b/user_guide/libraries/language.html @@ -1,137 +1,137 @@ - - - - - -Language Class : CodeIgniter User Guide - - - - - - - - - - - - - - - - - - - -

- - - - - - - - - - -

- - -
- - - -

- - -

Language Class

- -

The Language Class provides functions to retrieve language files and lines of text for purposes of internationalization.

- -

In your CodeIgniter system folder you'll find one called language containing sets of language files. You can create -your own language files as needed in order to display error and other messages in other languages.

- -

Language files are typically stored in your system/language directory. Alternately you can create a folder called language inside -your application folder and store them there. CodeIgniter will look first in your system/application/language -directory. If the directory does not exist or the specified language is not located there CI will instead look in your global -system/language folder.

- -

Note: Each language should be stored in its own folder. For example, the English files are located at: -system/language/english

- - - -

Creating Language Files

- -

Language files must be named with _lang.php as the file extension. For example, let's say you want to create a file -containing error messages. You might name it: error_lang.php

- -

Within the file you will assign each line of text to an array called $lang with this prototype:

- -$lang['language_key'] = "The actual message to be shown"; - -

Note: It's a good practice to use a common prefix for all messages in a given file to avoid collisions with -similarly named items in other files. For example, if you are creating error messages you might prefix them with error_

- -

$lang['error_email_missing'] = "You must submit an email address";

-$lang['error_url_missing'] = "You must submit a URL";

-$lang['error_username_missing'] = "You must submit a username";

- - -

Loading A Language File

- -

In order to fetch a line from a particular file you must load the file first. Loading a language file is done with the following code:

- -$this->lang->load('filename', 'language'); - -

Where filename is the name of the file you wish to load (without the file extension), and language -is the language set containing it (ie, english). If the second parameter is missing, the default language set in your -application/config/config.php file will be used.

- - -

Fetching a Line of Text

- -

Once your desired language file is loaded you can access any line of text using this function:

- -$this->lang->line('language_key'); - -

Where language_key is the array key corresponding to the line you wish to show.

- -

Note: This function simply returns the line. It does not echo it for you.

- -

Using language lines as form labels

- -

This feature has been deprecated from the language library and moved to the lang() function of the Language helper.

- -

Auto-loading Languages

If you find that you need a particular language globally throughout your application, you can tell CodeIgniter to auto-load it during system initialization. This is done by opening the application/config/autoload.php file and adding the language(s) to the autoload array.

- - - - - - + + + + + +Language Class : CodeIgniter User Guide + + + + + + + + + + + + + + + + + + + +

+ + + + + + + + + + +

+ + +
+ + + +

+ + +

Language Class

+ +

The Language Class provides functions to retrieve language files and lines of text for purposes of internationalization.

+ +

In your CodeIgniter system folder you'll find one called language containing sets of language files. You can create +your own language files as needed in order to display error and other messages in other languages.

+ +

Language files are typically stored in your system/language directory. Alternately you can create a folder called language inside +your application folder and store them there. CodeIgniter will look first in your system/application/language +directory. If the directory does not exist or the specified language is not located there CI will instead look in your global +system/language folder.

+ +

Note: Each language should be stored in its own folder. For example, the English files are located at: +system/language/english

+ + + +

Creating Language Files

+ +

Language files must be named with _lang.php as the file extension. For example, let's say you want to create a file +containing error messages. You might name it: error_lang.php

+ +

Within the file you will assign each line of text to an array called $lang with this prototype:

+ +$lang['language_key'] = "The actual message to be shown"; + +

Note: It's a good practice to use a common prefix for all messages in a given file to avoid collisions with +similarly named items in other files. For example, if you are creating error messages you might prefix them with error_

+ +

$lang['error_email_missing'] = "You must submit an email address";

+$lang['error_url_missing'] = "You must submit a URL";

+$lang['error_username_missing'] = "You must submit a username";

+ + +

Loading A Language File

+ +

In order to fetch a line from a particular file you must load the file first. Loading a language file is done with the following code:

+ +$this->lang->load('filename', 'language'); + +

Where filename is the name of the file you wish to load (without the file extension), and language +is the language set containing it (ie, english). If the second parameter is missing, the default language set in your +application/config/config.php file will be used.

+ + +

Fetching a Line of Text

+ +

Once your desired language file is loaded you can access any line of text using this function:

+ +$this->lang->line('language_key'); + +

Where language_key is the array key corresponding to the line you wish to show.

+ +

Note: This function simply returns the line. It does not echo it for you.

+ +

Using language lines as form labels

+ +

This feature has been deprecated from the language library and moved to the lang() function of the Language helper.

+ +

Auto-loading Languages

+ + + + + + \ No newline at end of file -- cgit v1.2.3-24-g4f1b

CodeIgniter User Guide Version 1.7

Language Class

Creating Language Files

Loading A Language File

Fetching a Line of Text

Using language lines as form labels

Auto-loading Languages

CodeIgniter User Guide Version 1.7

Language Class

Creating Language Files

Loading A Language File

Fetching a Line of Text

Using language lines as form labels

Auto-loading Languages