Smarty view renderer
This extension allows you to use Smarty version 3 templates in Yii.
Resources
Requirements
- Yii 1.0 or above
- Smarty 3.0.6 or above
Installation
- Extract the release file under
vendor/Smarty. - Download and extract
libsfolder contents of Smarty package underprotected/vendor/Smarty. - Move files from
pluginsfolder toprotected/vendor/Smarty/plugins. - Add the following to your config file 'components' section:
<?php
// ...
'viewRenderer'=>array(
'class'=>'application.vendor.smarty.ESmartyViewRenderer',
'fileExtension' => '.tpl',
//'pluginsDir' => 'application.smartyPlugins',
//'configDir' => 'application.smartyConfig',
//'prefilters' => array(array('MyClass','filterMethod')),
//'postfilters' => array(),
//'config'=>array(
// 'force_compile' => YII_DEBUG,
// ... any Smarty object parameter
//)
),
There are some more options on configuring Smarty properties now. Will add documentation soon.
Usage
- Smarty documentation.
- You can use Yii aliases for including files inside the template. For example:
You have to set path without extension
{extends file="application.views.layout.main"}
{include file="application.views.controller._form"}
Also you can use regular Smarty syntax for file path wich relative to current `views` directory:
{include file="controller/_form.tpl"}
- Current controller properties are accessible via
{$this->pageTitle}. - Yii properties are available as follows:
{Yii::app()->theme->baseUrl}. - Used memory is stored in
{$MEMORY}, used time is in{$TIME}.
Smarty Plugins
widgetandbegin_widgetplugins allow use Yii widgets in this way:
{*Render widget without params*}
{widget name="path.to.widget.Class"}
{*You can set params by passing it in the widget-function*}
{widget name="Breadcrumbs" links=['Library'=>'#', 'Data'] someParam="someValue"}
{*Another syntax. *}
{begin_widget name="bootstrap.widgets.TbModal" id='anotherModalDialog' options=[backdrop=>static] otherParam="value" [...]}
{*Widget object are accessible via {$widget} variable inside the block *}
{$widget->some_widget_method_or_variable}
{/begin_widget}
- Form plugin is a syntax-sugar plugin for Yii ActiveForm. Syntax:
{form name="product_form" id='form' type='horizontal' otherParam="value" [...]}
{*Form object are accessible via variable with name equal to form name*}
{$product_form->textFieldRow($this->model, 'name', ['class'=>'span5','maxlength'=>255])}
{/form}
t()function allows to translate strings using Yii::t(). Syntax:
{t text="text to translate" cat="app"}
{t text="text to translate" cat="app" src="en" lang="ru"}
{t text="text to translate" cat="app" params=$params}
linkfunction allows to generate links using CHtml::link().
Syntax:
{link text="test"}
{link text="test" url="controller/action?param=value"}
{link text="test" url="/absolute/url"}
{link text="test" url="http://host/absolute/url"}