/ 
Kelp-2.19
River stage two • 19 direct dependents • 20 total dependents
/ Kelp::Module::Template

NAME

Kelp::Module::Template - Template processing for Kelp applications

SYNOPSIS

First ...

# conf/config.pl
{
    modules => ['Template'],
    modules_init => {
        Template => { ... }
    }
};

Then ...

# lib/MyApp.pm
sub some_route {
    my $self = shift;
    $self->template('some_template', { bar => 'foo' });
}

DESCRIPTION

This module provides an interface for using templates in a Kelp web application. It uses Kelp::Template, but it could be easily subclassed to use anything else.

REGISTERED METHODS

template

template($filename, \%vars)

Renders a file using the currently loaded template engine. If the file doesn't have an extension, the one specified in "ext" will be assigned to it.

If there is no app in %vars, it will be automatically added.

ATTRIBUTES

ext

The default extension of the template files. This module sets this attribute to tt, so

$self->template( 'home' );

will look for home.tt. Set to undef or empty string to skip adding the extension to filenames.

engine

This attribute will be initialized by the build_engine method of this module, and it is available to all code that needs access to the template engine instance. See "SUBCLASSING" for an example.

METHODS

build_engine

build_engine(%args)

This method is responsible for creating, initializing and returning an instance of the template engine used, for example Template. Override it to use a different template engine, for example Text::Haml.

render

render($template, \%vars, @rest)

This method should return a rendered text. Override it if you're subclassing and using a different template engine.

PERKS

UTF8

To process templates in utf8, add the encoding to the module configuration:

# conf/config.pl
{
    modules      => ['Template'],
    modules_init => {
        Template => {
            encoding => 'utf8'
        }
    }
};

SUBCLASSING

To use a different template engine, you can subclass this module. You will need to make sure your new class does the following (for the sake of the example we will show you how to create a Text::Haml rendering module):

  • Overrides the "ext" attribute and provides the file extension of the new template files.

    attr ext => 'haml';

  • Overrides the "build_engine" method and creates an instance of the new template engine.

    sub build_engine {
    my ( $self, %args ) = @_;
    return Text::Haml->new( %args );
}

  • Overrides the "render" method and renders using $self->engine.

    sub render {
    my ( $self, $template, $vars, @rest ) = @_;

    # Get the template engine instance
    my $haml = $self->engine;

    # If the $template is a reference, then render string,
    # otherwise it's a file name.
    return ref($template) eq 'SCALAR'
      ? $haml->render( $$template, %$vars )
      : $haml->render_file( $template, %$vars );
}