Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
EMustache - Mustache templating for Yii
PHP
Branch: master
Pull request Compare This branch is 4 commits behind Haensel:master.

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
vendor/Mustache
EMustacheViewRenderer.php
README.md

README.md

EMustache - Mustache templating for Yii

This extension is based on the excellent work of Justin Hileman aka. "bobthecow" => mustache.php at https://github.com/bobthecow/mustache.php The idea was to make mustache templating with Yii as easy as possible. It therefore uses the familiar Yii rendering syntax. In order to make this extension as fast as possible EMustache uses Mustache.php's built in caching functionality. By default these cached views are stored under /protected/runtime/Mustache/cache

INSTALL:

1.) Add the extension to Yii by placing it in your application's extension folder (for example '/protected/extensions') 2.) Add the viewRenderer configuration to the main config (within the "components section")

            'viewRenderer' => array(
                    'class' => 'application.extensions.EMustache.EMustacheViewRenderer',
                )

3.) Add additional options. To pass mustache.php specific options you may use the following syntax. Example:


                'viewRenderer' => array(
                    'class' => 'application.extensions.EMustache.EMustacheViewRenderer',
                    'mustacheOptions'=>array(
                        'charset' => Yii::app()->charset
                    )
                )

Please note that the options "partial_loader","charset" and "escape" are already set to make Mustache.php usable with Yii's conventions. E.g.: Escaping is done via Yii's CHtml::encode() and views/partials are searched within "protected/views". Only change them if you know what you do.

USAGE:

With layouts:

protected/layouts/main.mustache:

<!DOCTYPE html>
    <html>
    <head>
        <title>Test</title>
    </head>
    <body>
        <div class="container" id="page">
            {{{content}}}
        </div><!-- page -->
    </body>
</html>

protected/views/site/index.mustache:

Hello {{name}}
You have just won ${{value}}!
{{#in_ca}}
Well, ${{taxed_value}}, after taxes.
{{/in_ca}}

protected/controllers/SiteController.php

<?php

class SiteController extends Controller
{   
    public function actionIndex()
    {
        $this->layout="//layouts/main";
        $this->render('index',array('name'=>'Chris','value'=>10000,'taxed_value'=>10000 - (10000 * 0.4),'in_ca'=>true));
    }
}

http://localhost/mustacheExample/index.php will output:

<!DOCTYPE html>
    <html>
    <head>
        <title>Test</title>
    </head>
    <body>
        <div class="container" id="page">
            Hello Chris
            You have just won $10000!
            Well, $6000.0, after taxes.
        </div><!-- page -->
    </body>
</html>

Partials:

protected/views/site/index.mustache:

Hello {{name}}
You have just won ${{value}}!
{{#in_ca}}
Well, ${{taxed_value}}, after taxes.
{{/in_ca}}
And here comes a partial 
{{>site/partial}}

protected/views/site/partial.mustache:

I am a partial with name {{partialName}} and you are probably named {{name}}

Partials will automatically have access to variables of their parents.

<?php
class SiteController extends Controller
{   
    public function actionIndex()
    {
        $this->layout="//layouts/main";
        $this->render('index',array('name'=>'Chris','value'=>10000,'taxed_value'=>10000 - (10000 * 0.4),'in_ca'=>true,'partialName'=>'IAMAPARTIAL'));
    }
}

Using models

<?php
class SiteController extends Controller
{   
    public function actionIndex()
    {
        $model=new YiiModel;
                $model->name='Haensel;
                $model->age=30;
                $this->render('index',array('model'=>$model);
    }
}

protected/views/site/index.mustache:

Name: {{model.name}}
Age: {{model.age}}

Full mustache syntax: http://mustache.github.com/mustache.5.html

Something went wrong with that request. Please try again.