bkwld/laravel-haml

Wraps MtHaml for ease use in Laravel

Laravel Haml

, _(*1)

A small package that adds support for compiling Haml templates to Laravel via MtHaml. Both vanilla php and Blade syntax is supported within the Haml., _(*2)

Installation

1. Add it to your composer.json ("bkwld/laravel-haml": "~2.0") and do a composer install.
2. Add the service provider to your app.php config file providers: 'Bkwld\LaravelHaml\ServiceProvider',

Configuration

You can set MtHaml environment, options, and filters manually. To do so:, _(*3)

• Laravel 4 : Publish the config file with php artisan config:publish bkwld/laravel-haml and edit at /app/config/packages/bkwld/laravel-haml/config.php
• Laravel 5 : Publish the config file with php artisan vendor:publish and edit it at /config/haml.php.

For instance, to turn off auto-escaping:, _(*4)

'mthaml' => array(
    'environment' => 'php',
    'options' => array(
        'enable_escaper' => false,
    ),
    'filters' => array(),
), 

Usage

Laravel-Haml registers the ".haml", ".haml.php", ".haml.blade", and ".haml.blade.php" extension with Laravel and forwards compile requests on to MtHaml. It compiles your Haml templates in the same way as Blade templates; the compiled template is put in app/storage/views. Thus, you don't suffer compile times on every page load., _(*5)

In other words, just put your Haml files in the regular views directory and name them like "whatever.haml". You reference them in Laravel like normal:, _(*6)

• Laravel 4 : View::make('home.whatever') for app/views/home/whatever.haml
• Laravel 5 : view('home.whatever') for resources/views/home/whatever.haml

The Haml view files can work side-by-side with regular PHP views. To use Blade templating within your Haml, just name the files with ".haml.blade" or ".haml.blade.php" extensions., _(*7)

Histoy

Read the Github project releases for release notes., _(*8)