The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
Dancer-Template-TemplateSandbox-1.00
River stage zero No dependents
++
/ Dancer::Template::TemplateSandbox

NAME

Dancer::Template::TemplateSandbox - Template::Sandbox wrapper for Dancer

DESCRIPTION

This class is an interface between Dancer's template engine abstraction layer and the Template::Sandbox module.

In order to use this engine, set the following setting:

    template: template_sandbox

This can be done in your config.yml file or directly in your app code with the set keyword.

Note that Dancer configures the Template::Sandbox engine to use <% %> brackets instead of its default <: :> brackets, it also sets template_toolkit_compat to true.

SETTINGS

You can pass additional options to the Template::Sandbox constructor from within the template_sandbox subsetting of the engines setting in your config.yml:

    template: template_sandbox
    engines:
        template_sandbox:
            open_delimiter: <:
            close_delimiter: :>

CACHING

You can enable and configure caching by setting the cache, cache_type and cache_dir settings.

cache may be one of 'cache_factory' or 'chi' to use Cache::CacheFactory or CHI respectively.

cache_type will set the cache type, 'file' and 'memory' should both be fine, but other values may or may not work.

cache_dir will need to be set if you set cache_type to 'file', but is otherwise ignored.

    template: template_sandbox
    engines:
        template_sandbox:
            cache: cache_factory
            cache_type: file
            cache_dir: /var/tmp/cache/dancer

    template: template_sandbox
    engines:
        template_sandbox:
            cache: chi
            cache_type: memory

TEMPLATE FUNCTIONS

In keeping with Template::Sandbox philosophy, no template functions are enabled by default.

You can load them as class-wide template functions from your myapp.pm:

    package myapp;
    use Dancer;

    use Template::Sandbox qw/:function_sugar/;

    Template::Sandbox->register_template_function(
        localtime => ( no_args inconstant sub { scalar localtime() } ),
        );

Or you can use template function libraries with class-level imports:

    package myapp;
    use Dancer;

    use Template::Sandbox;
    use Template::Sandbox::NumberFunctions qw/:all/;

The documentation in Template::Sandbox and Template::Sandbox::Library goes into more detail on both these scenarios.

SEE ALSO

Dancer, Template::Sandbox, Cache::CacheFactory, CHI

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc Dancer::Template::TemplateSandbox

You can also look for information at:

AUTHORS

Sam Graham <libdancer-template-templatesandbox-perl BLAHBLAH illusori.co.uk>.

Based on work in Dancer::Template::TemplateToolkit by Alexis Sukrieh.

COPYRIGHT & LICENSE

Copyright 2010 Sam Graham, all rights reserved. Portions derived from work copright Alexis Sukrieh.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.