Kohana 3 :: Message


Message Basics

Kohana messages are human friendly strings represented by a shorter word or phrase, called a "key". Messages are accessed using the Kohana::message method, which returns either an entire group of messages, or a single message.
As an example, when a user is not logged in and attempts to access a page that requires authentication, an error such as "You must be logged in to access this page" might be displayed. This message could be stored in the auth file with amust_login key:

$message = Kohana::message('auth', 'must_login');
Messages are not translated. To translate a message, use the translation function:
$translated = __(Kohana::message('auth', 'must_login'));
In Kohana v2, the message system was used for translation. However, it is highly recommended to use the new translation system instead of messages, as it provides readable text even when a translation is not available.

Message Files

All message files are plain PHP files, stored in the messages/ directory, that return an associative array:
<?php defined('SYSPATH') or die('No direct script access.');
 
return array(
    'must_login' => 'You must login to access this page',
    'no_access'  => 'You do not have privileges to access this page',
);
Message files are similar to config files in that they are merged together. This means that all of the messages stored in a file called auth will be combined into a single array, so it is not necessary to duplicate all of the messages when you create a new auth file.

0 comments:

Post a Comment