2017 © Pedro Peláez
 

library dispatch-handlebars

handlebars support for dispatch micro framework

image

gigglebox/dispatch-handlebars

handlebars support for dispatch micro framework

  • Wednesday, August 20, 2014
  • by bmcminn
  • Repository
  • 1 Watchers
  • 1 Stars
  • 18 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 0 Forks
  • 1 Open issues
  • 2 Versions
  • 0 % Grown

The README.md

{{handlebars}} for Dispatch

An extension for the Dispatch PHP micro-framework that provides support for Handlebars templates., (*1)

Requires:

{
  "require": {
    "php": ">= 5.4.0",
    "dispatch/dispatch": ">= 2.6.2",
    "xamin/handlebars.php": "dev-master"
  }
}

Installation

This repo assumes you know how to install dependencies via Composer, (*2)

composer.json:

{
  "require": {
    "php": ">= 5.4.0",
    "dispatch/dispatch": ">= 2.6.2",
    "xamin/handlebars.php": "dev-master",
    "gigglebox/dispatch-handlebars": "dev-master"
  }
}

Open a new terminal to your working directory and composer install or composer update., (*3)

Configuration

your-main-app-file.php

  // main layout template file; must contain `{{{content}}}` in <body>
  config('handlebars.layout') = 'layout';

  // set location of .handlbars templates (views and partials)
  config('handlebars.views') = 'path/to/tempaltes';

  // set character encoding for template files; defaults to `UTF-8`
  config('handlebars.charset') = 'utf-8';

  // prefix string to determine partial files, defaults to `_` (underscore)
  config('handlebars.partial_prefix') = '_';

  // [associative array](http://www.php.net/manual/en/language.types.array.php) of tagname and function names
  config('handlebars.helpers') = array('tagName' => 'callback_function');

  // path where compiled templates will be cached (this feature does not work yet)
  config('handlebars.cache') = 'path/to/cached/tempaltes';

NOTE: If you do not define handlebars.layout and handlebars.views, handlebars will use the default dispatch.layout and dispatch.views values instead., (*4)

Using Handlebars with Dispatch

layout.handlebars:

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>{{#capitalize page.title }}</title>
</head>
<body>
  {{{ content }}}
</body>
</html>

homepage.handlebars:

  <!-- homepage.handlebars -->
  <h1>Hello there, {{ user.notLoggedIn.name }}!</h1>

In our example index.php file, we'll use the handlebars() function to render our template within our route:, (*5)

index.php

  'http://localhost/appname'
  , 'handlebars.views'          =>  'app/templates'
  , 'handlebars.layout'         =>  'layout'
  , 'handlebars.partial_prefix' =>  '_'

  , 'handlebars.helpers' => [
        'capitalize' => 'handlebars_capitalize'
      , 'upper'      => 'handlebars_upper'
      , 'lower'      => 'handlebars_lower'
      ]
  ));


  //
  // EXTEND HANDLEBARS
  //
  function handlebars_capitalize($template, $context, $args, $source) {
    return ucwords($context->get($args));
  }

  function handlebars_upper($template, $context, $args, $source) {
    return strtoupper($context->get($args));
  }

  function handlebars_lower($template, $context, $args, $source) {
    return strtolower($context->get($args));
  }


  //
  // DEFINE ROUTES
  //
  on('GET', '/', function () {
    global $model;
    handlebars('homepage', $model);
  });


  //
  // RUN THE APPLICATION
  //
  dispatch();
?>

The handlebars() function accepts three arguments:, (*6)

handlebars();

The resulting HTML from our demo above renders something like this:, (*7)

<!doctype html>
<html>
<head><title>Handlebars Hello World App</title></head>
<body>
  <!-- homepage.handlebars -->
  <h1>Hello there, stranger!</h1>
</body>
</html>

Extending Handlebars with Helpers

To define helpers for Handlebars, you need to define the functions you wish to use and pass them into the handlebars.helpers array as defined above., (*8)

example:

  config('handlebars.helpers') = array(
      'capitalize'  => 'handlebars_capitalize'
    , 'upper'       => 'handlebars_upper'
    , 'lower'       => 'handlebars_lower'
    );

  // extend handlebars

  function handlebars_capitalize($template, $context, $args, $source) {
    return ucwords($context->get($args));
  }

  function handlebars_upper($template, $context, $args, $source) {
    return strtoupper($context->get($args));
  }

  function handlebars_lower($template, $context, $args, $source) {
    return strtolower($context->get($args));
  }

In handlebars.helpers, the key is the tag name that gets used in your handlebars templates, and the value is the name of the callback function we want to use when that helper is defined., (*9)

Read more about defining helpers at mardix/Handlebars, (*10)

Credits

This package was written by Brandtley McMinn and is largely based on the Dispatch-Mustache package written by Jesus A. Domingo as an add-on for the Dispatch PHP micro-framework., (*11)

It depends on the Handlebars PHP library by fzerorubigd and Behrooz Shabani aka everplays., (*12)

LICENSE

MIT http://brandtleymcminn.mit-license.org/, (*13)

The Versions

20/08 2014

dev-master

9999999-dev https://github.com/gigglebox/dispatch-handlebars

handlebars support for dispatch micro framework

  Sources   Download

MIT

The Requires

 

by Brandtley McMinn

template handlebars dispatch

23/05 2014

1.0.0

1.0.0.0 https://github.com/GiggleboxStudios/dispatch-handlebars

handlebars support for dispatch micro framework

  Sources   Download

MIT

The Requires

 

by Brandtley McMinn

template handlebars dispatch