php/yii2
1
0
Fork 0
mirror of https://github.com/yiisoft/yii2.git synced 2025-08-14 22:30:27 +08:00
Code Issues Packages Projects Releases Wiki Activity

Corrected theming docs not to give an example of theme view files under webroot

Browse Source
This commit is contained in:
Alexander Makarov
2014-04-02 17:07:04 +04:00
parent 3a232743a4
commit ada39df60b
2 changed files with 17 additions and 17 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
docs/guide/theming.md
View File

@ -18,7 +18,7 @@ be in your application config file:
'components' => [ 'components' => [
'view' => [ 'view' => [
'theme' => [ 'theme' => [
'pathMap' => ['@app/views' => '@webroot/themes/basic'], 'pathMap' => ['@app/views' => '@app/themes/basic'],
'baseUrl' => '@web/themes/basic', 'baseUrl' => '@web/themes/basic',
], ],
], ],
@ -26,8 +26,8 @@ be in your application config file:
``` ```
In the above `pathMap` defines where to look for view files while `baseUrl` defines base URL for resources referenced In the above `pathMap` defines where to look for view files while `baseUrl` defines base URL for resources referenced
from these files. For example, if `pathMap` is `['/web/views' => '/web/themes/basic']`, then the themed version from these files. In our case `pathMap` is `['@app/views' => '@app/themes/basic']` so the themed version
for a view file `/web/views/site/index.php` will be `/web/themes/basic/site/index.php`. for a view file `@app/views/site/index.php` will be `@app/themes/basic/site/index.php`.
Using multiple paths Using multiple paths
-------------------- --------------------
@ -36,14 +36,14 @@ It is possible to map a single path to multiple paths. For example,
```php ```php
'pathMap' => [ 'pathMap' => [
'/web/views' => [ '@app/views' => [
'/web/themes/christmas', '@app/themes/christmas',
'/web/themes/basic', '@app/themes/basic',
], ],
] ]
``` ```
In this case, the view will be searched in `/web/themes/christmas/site/index.php` then if it's not found it will check In this case, the view will be searched in `@app/themes/christmas/site/index.php` then if it's not found it will check
`/web/themes/basic/site/index.php`. If there's no view there as well application view will be used. `@app/themes/basic/site/index.php`. If there's no view there as well application view will be used.
This ability is especially useful if you want to temporary or conditionally override some views. This ability is especially useful if you want to temporary or conditionally override some views.

18
framework/base/Theme.php
View File

@ -27,23 +27,23 @@ use yii\helpers\FileHelper;
* to replace the original view file. * to replace the original view file.
* 4. If Step 2 or 3 fails, the original view file will be used. * 4. If Step 2 or 3 fails, the original view file will be used.
* *
* For example, if [[pathMap]] is `['/web/views' => '/web/themes/basic']`, * For example, if [[pathMap]] is `['@app/views' => '@app/themes/basic']`,
* then the themed version for a view file `/web/views/site/index.php` will be * then the themed version for a view file `@app/views/site/index.php` will be
* `/web/themes/basic/site/index.php`. * `@app/themes/basic/site/index.php`.
* *
* It is possible to map a single path to multiple paths. For example, * It is possible to map a single path to multiple paths. For example,
* *
* ~~~ * ~~~
* 'pathMap' => [ * 'pathMap' => [
* '/web/views' => [ * '@app/views' => [
* '/web/themes/christmas', * '@app/themes/christmas',
* '/web/themes/basic', * '@app/themes/basic',
* ], * ],
* ] * ]
* ~~~ * ~~~
* *
* In this case, the themed version could be either `/web/themes/christmas/site/index.php` or * In this case, the themed version could be either `@app/themes/christmas/site/index.php` or
* `/web/themes/basic/site/index.php`. The former has precedence over the latter if both files exist. * `@app/themes/basic/site/index.php`. The former has precedence over the latter if both files exist.
* *
* To use a theme, you should configure the [[View::theme|theme]] property of the "view" application * To use a theme, you should configure the [[View::theme|theme]] property of the "view" application
* component like the following: * component like the following:
@ -51,7 +51,7 @@ use yii\helpers\FileHelper;
* ~~~ * ~~~
* 'view' => [ * 'view' => [
* 'theme' => [ * 'theme' => [
* 'basePath' => '@webroot/themes/basic', * 'basePath' => '@app/themes/basic',
* 'baseUrl' => '@web/themes/basic', * 'baseUrl' => '@web/themes/basic',
* ], * ],
* ], * ],