Browse Source

updated view renderers docs

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

39
docs/view_renderers.md

@ -2,15 +2,18 @@ Yii2 view renderers
=================== ===================
By default Yii uses PHP as template language but you can change it in your application. 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 The component responsible for rendering a view is called `view`. You can configure
called `viewRenderer`. You can configure it as follows: a custom template engine as follows:
```php ```php
array( array(
'components' => array( 'components' => array(
'viewRenderer' => array( 'view' => array(
'class' => 'yii\renderers\TwigViewRenderer', 'class' => 'yii\base\View',
// or 'class' => 'yii\renderers\SmartyViewRenderer', '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`. 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()` Also you need to specify this extension explicitly when calling `$this->render()`
or `$this->renderPartial()` from your controller. 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