jamiecressey/slim-handlebars-view

Slim Framework 3 view helper built on top of the Handlebars templating component

0.0.2 2015-10-06 22:18 UTC

This package is not auto-updated.

Last update: 2024-04-27 16:08:54 UTC


README

Build Status

This is a Slim Framework view helper built on top of the Handlebars templating component. You can use this component to create and render templates in your Slim Framework application.

Install

Via Composer

$ composer require jamiecressey/slim-handlebars-view

Requires Slim Framework 3 and PHP 5.5.0 or newer.

Usage

// Create Slim app
$app = new \Slim\App();

// Fetch DI Container
$container = $app->getContainer();

// Register Handlebars View helper
$container['view'] = function ($c) {
    $view = new \Slim\Views\Handlebars('path/to/templates', [
        'extension' => 'handlebars'
    ]);
    
    return $view;
};

// Define named route
$app->get('/hello/{name}', function ($request, $response, $args) {
    return $this->view->render($response, 'profile.html', [
        'name' => $args['name']
    ]);
})->setName('profile');

// Run app
$app->run();

Custom template functions

This component exposes a custom path_for() function to your Handlebars templates. You can use this function to generate complete URLs to any Slim application named route. This is an example Handlebars template:

{{>layout}}

<h1>User List</h1>
<ul>
    <li><a href="{{ path_for('profile', { 'name': 'josh' }) }}">Josh</a></li>
</ul>

Testing

phpunit

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email jamiecressey89@gmail.com instead of using the issue tracker.

Credits

License

The MIT License (MIT). Please see License File for more information.