NAME

Catalyst::View::HTML::Mason - HTML::Mason rendering for Catalyst

VERSION

version 0.02

SYNOPSIS

    package MyApp::View::Mason;

    use Moose;
    use namespace::autoclean;

    extends 'Catalyst::View::HTML::Mason';

    __PACKAGE__->config(
        interp_args => {
            comp_root => MyApp->path_to('root'),
        },
    );

    1;

DESCRIPTION

This module provides rendering of HTML::Mason templates for Catalyst applications.

It's basically a rewrite of Catalyst::View::Mason, which became increasingly hard to maintain over time, while keeping backward compatibility.

ATTRIBUTES

interp

The mason interpreter instance responsible for rendering templates.

interp_class

The class the interp instance is constructed from. Defaults to HTML::Mason::Interp.

interp_args

Arguments to be passed to the construction of interp. Defaults to an empty hash reference.

template_extension

File extension to be appended to every component file. By default it's only appended if no explicit component file has been provided in $ctx->stash->{template}.

always_append_template_extension

If this is set to a true value, template_extension will also be appended to component paths provided in $ctx->stash->{template}.

encoding

Encode Mason output with the given encoding. Can be a string encoding name (which will be resolved using Encode::find_encoding()), or an Encode::Encoding object. See the Encode::Supported manpage for a list of encodings.

globals

Arrayref of string names to export into each rendered component. Off by default.

Example:

  globals => [qw[ $foo %bar ]]

Would export $foo and %bar to every Mason component as globals using identically-named values in the stash, similar to:

   our $foo = $c->stash->{foo};
   our %bar = %{ $c->stash->{bar} };

To export the context as $c, one would set globals => ['$c'] and make sure to set $c->stash->{c} = $c on each request, such as in an auto in the root controller.

AUTHORS

Florian Ragwitz <rafl@debian.org> Sebastian Willert <willert@cpan.org> Robert Buels <rbuels@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2010 by Florian Ragwitz.

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