Browse Source

updated view renderers docs

tags/2.0.0-beta
Alexander Makarov 12 years ago
parent
commit
385f711fa7
  1. 35
      docs/view_renderers.md

35
docs/view_renderers.md

@ -2,17 +2,20 @@ Yii2 view renderers
===================
By default Yii uses PHP as template language but you can change it in your application.
The component responsible for rendering a view using custom template enging is
called `viewRenderer`. You can configure it as follows:
The component responsible for rendering a view is called `view`. You can configure
a custom template engine as follows:
```php
array(
'components' => array(
'viewRenderer' => array(
'view' => array(
'class' => 'yii\base\View',
'renderer' => array(
'class' => 'yii\renderers\TwigViewRenderer',
// or 'class' => 'yii\renderers\SmartyViewRenderer',
),
),
),
)
```
@ -29,3 +32,29 @@ Smarty
In order to use Smarty you need to put you templates in files with extension `.tpl`.
Also you need to specify this extension explicitly when calling `$this->render()`
or `$this->renderPartial()` from your controller.
Using multiple view renderers in a single application
-----------------------------------------------------
If you need multiple view renderers at the same time in a single application you
can use `CompositeViewRenderer` as follows:
```php
'components' => array(
'view' => array(
'class' => 'yii\base\View',
'renderer' => array(
'class' => 'yii\renderers\CompositeViewRenderer',
'renderers' => array(
'tpl' => array(
'class' => 'yii\renderers\SmartyViewRenderer',
),
'twig' => array(
'class' => 'yii\renderers\TwigViewRenderer',
),
),
//'class' => 'yii\renderers\TwigViewRenderer',
),
),
),
```
Loading…
Cancel
Save