Changes
Title
unchanged
How to customize Yii core messages?
Category
unchanged
Tutorials
Yii version
unchanged
Tags
changed
core messages, translation, i18n
Content
changed
[...]
return array(
......
'language'=>'de',
'components'=>array(
'coreMessages'=>array(
'basePath'=>'protected/messages'null,
),
......[...]
```
In the above, we specify that the application is targeted to German users and that the translated messages are
located under the directory `protected/messages`to be loaded from under the default `basePath` of the `coreMessages` component, which by default is the directory represented by the path alias `application.messages`. The latter effectively translates to the `protected/messages` folder, regardless of where `protected` is located in the filesystem. Please refer to the Yii Guide for more [information about path aliases](doc/guide/basics.namespace).
It might seem odd that we set the `basePath` to null instead of `protected/messages`. The reason we do that is to support the case where the `protected` folder has been moved out of the webroot, because the relative path `protected/messages` will then not be found starting from the webroot. The webroot is where the Yii application is located in the filesystem during runtime.
If we want to specify another basePath for the messages than this default one, we have to provide either an absolute path to the folder (such as `/var/www/messages`), or a path that during runtime will be relative the webroot (for example `../protected/messages` if the `protected` directory is a located in the same directory as the webroot, i.e. moved one step up from the default location).
Next, we need to provide our translations. Under the directory `protected/messages`, create a subdirectory named `de` which corresponds to the target language we set in the application configuration. And under the `de` directory, create a new file named `yii.php`. To this end, we should have the following directory structure:
~~~
WebRoot/[...]