2017 © Pedro Peláez
 

library handlelars

A Laravel 5 wrapper for Handlebars

image

truemedia/handlelars

A Laravel 5 wrapper for Handlebars

  • Saturday, May 9, 2015
  • by Truemedia
  • Repository
  • 1 Watchers
  • 1 Stars
  • 79 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 7 Forks
  • 1 Open issues
  • 7 Versions
  • 3 % Grown

The README.md

handlelars

A Laravel wrapper for Lightncandy, a PHP implementation of http://handlebarsjs.com/, (*1)

Acknowledgements

  • Original credit to the creator of this repo https://github.com/brightmachine/laratash, all I did was rename everything to handlebars and configure the handlebars PHP library.

Supports

  • Laravel 5
  • Handlebars 2.0+

Installation

Add handlelars as a dependency to your composer.json file:, (*2)

"require": {
    "laravel/framework":      "~5.0",
    "truemedia/handlelars": "dev-master"
}

run composer update, or composer install if this is a brand new project, (*3)

Add the Service Provider

Open: config/app.php, (*4)

...

'Handlelars\HandlelarsServiceProvider',

...

You are all setup!, (*5)

Usage

Handlelars is merely a wrapper for the Lightncandy library that integrates it into Laravel 5+., (*6)

Handlelars registers itself with the Laravel View class, providing seamless integration with Laravel. You can use Handlebars just as you would Blade! The Laravel View class will choose the right template engine to use based on the file extension of the view. So all you have to do to render Handlebars files, is ensure that your view has a .hbs file extension. Handlelars will take care of the rest., (*7)

You can even mix and match template engines. For instance maybe you have a Blade layout file, and you want to nest a Handlebars view, that's fine! The Handlebars view will be rendered into a variable named whatever section you passed the view to. So for example if you were to do:, (*8)

$view->nest('content', 'some.view');
$view->nest('sidebar', 'some.sidebar');

The contents of the parsed some.view file will be available in the template file under a variable called $content. The contents of the parsed some.sidebar would be available in the template file, under a variable called $sidebar., (*9)

By default, Handlebars partials are also loaded using Laravel's ViewFinder, so you can feel free to use dot-notation to specify a view., (*10)

{{#posts}}
    {{> posts._post}}
{{/posts}}

Other than that it is business as usual!, (*11)

Examples:

  • Example using View::make(), (*12)

    app/views/test.hbs, (*13)

    <h1>{{ pageHeading }}</h1>
<div>
    {{ pageContent }}
</div>

    app/router.php, (*14)

    Route::get('/', function()
{
    return View::make('test', array(
        'pageHeading' => 'Rendered with Lightncandy',
        'pageContent' => 'But still looks like Laravel!'
    ));
});

  • Example using a Blade controller layout, (*15)

    app/views/layouts/master.blade.php, (*16)

    <html>
<head></head>
<body>
    {{ content }}
</body>
</html>

    app/views/test.mustache, (*17)

    <h1>{{ pageHeading }}</h1>
<div>
    {{ pageContent }}
</div>

    app/controllers/TestController.php, (*18)

    <?php

class TestController extends BaseController {

    public $layout = 'layouts.master';

    public function index()
    {
    $this->layout->nest('content', 'test', array(
        'pageHeading' => 'Rendered with Lightncandy',
        'pageContent' => 'But still looks like Laravel!'
    ));   
    }

    }

  • Example using a Handlebars layout, (*19)

    app/views/posts/_post.hbs, (*20)

    <article>
    <h2>{{ title }}</h2>
    <div>
        {{ content }}
    </div>
</article>

    app/views/blog/index.hbs, (*21)

    <html>
<head></head>
<body>
    <h1>My Blog</h1>

    {{#posts}}
        {{> posts._post}}
    {{/posts}}
</body>
</html>

    app/routes.php, (*22)

    Route::get('/', function()
{
    $posts = array(
        array(
            'title' => 'This is a Title',
            'content' => 'lorem ipsum...'
        ),
        array(
            'title' => 'This is a another title',
            'content' => 'lorem ipsum...'
        ),
        array(
            'title' => 'This is yet another Title',
            'content' => 'lorem ipsum...'
        ),
    );

    return View::make('blog.index', compact('posts));
});

A note on template data

Laravel expects view data to be be passed as an array., (*23)

Handlebars PHP, however, also allows a Context object to be used., (*24)

If you wish to use a Context object, pass through an array with a __context key and this will be used. E.g., (*25)

`return view('my.view', ['__context' => new Context]);`

Configure

You can alter the configuration options that are passed to Lightncandy in your ConfigServiceProvider. E.g., (*26)

config([
    'handlelars.cache' => storage_path() . '/framework/views/handlebars',
]);

All handlelars. options are passed directly to the Mustache_Engine constructor, so you can use any of the options that you would use with Lightncandy, (*27)

The Versions

09/05 2015

dev-master

9999999-dev https://github.com/Truemedia/handlelars

A Laravel 5 wrapper for Handlebars

  Sources   Download

MIT

The Requires

 

by Wade Penistone

laravel php handlebars laravel 5

08/02 2015

5.0.5

5.0.5.0 https://github.com/brightmachine/laratash

A Laravel 5+ wrapper for mustache.php, a PHP implementation of http://mustache.github.io/

  Sources   Download

MIT

The Requires

 

by Conar Welsh
by Kelvin Jones

laravel php mustache laravel 5

02/02 2015

5.0.4

5.0.4.0 https://github.com/brightmachine/laratash

A Laravel 5+ wrapper for mustache.php, a PHP implementation of http://mustache.github.io/

  Sources   Download

MIT

The Requires

 

by Conar Welsh
by Kelvin Jones

laravel php mustache laravel 5

14/11 2014

5.0.3

5.0.3.0 https://github.com/brightmachine/laratash

A Laravel 5+ wrapper for mustache.php, a PHP implementation of http://mustache.github.io/

  Sources   Download

MIT

The Requires

 

by Conar Welsh
by Kelvin Jones

laravel php mustache laravel 5

23/09 2014

5.0.2

5.0.2.0 https://github.com/brightmachine/laratash

A Laravel 5+ wrapper for mustache.php, a PHP implementation of http://mustache.github.io/

  Sources   Download

MIT

The Requires

 

by Conar Welsh
by Kelvin Jones

laravel php mustache laravel 5

20/09 2014

5.0.1

5.0.1.0 https://github.com/brightmachine/laratash

A Laravel 5+ wrapper for mustache.php, a PHP implementation of http://mustache.github.io/

  Sources   Download

MIT

The Requires

 

by Conar Welsh
by Kelvin Jones

laravel php mustache laravel 5

20/09 2014

5.0.0

5.0.0.0 https://github.com/brightmachine/laratash

A Laravel 5+ wrapper for mustache.php, a PHP implementation of http://mustache.github.io/

  Sources   Download

MIT

The Requires

 

by Conar Welsh
by Kelvin Jones

laravel php mustache laravel 5