***** DESCRIPTION
Mojolicous::Plugin::Mason1Renderer is a renderer for Mason 1 (aka HTML::Mason 1.x)
template system, plugabble into Mojolicious web framework.
Mojolicious : http://www.mojolicious.org/ http://search.cpan.org/~kraih/Mojolicious/
HTML::Mason (1) : http://www.masonhq.com/ http://search.cpan.org/~drolsky/HTML-Mason/
***** SYNOPSIS
## Mojolicious::Lite
# example -1-
use Mojolicious::Lite;
plugin 'mason1_renderer';
get '/' => sub {
my $self = shift;
$self->render('/index', handler => "mason" );
};
app->start;
# template: MOJO_HOME/mason/index
Welcome
# example -2-
use Mojolicious::Lite;
plugin 'mason1_renderer' => { interp_params => { comp_root => "/path/to/mason/comps",
... (other parameters to the new() HTML::Mason::Interp constructor)
},
request_params => { error_format => "brief",
... (other parameters to the new() HTML::Mason::Request constructor)
},
};
get '/' => sub {
my $self = shift;
$self->render('/index', handler => "mason", mytext => "Hello world" );
};
app->start;
# template: /path/to/mason/comps/index
<%args>
$mytext => undef
Welcome : <% $mytext %>
## Mojolicious
# example -1-
package MyApp;
use Mojo::Base 'Mojolicious';
sub startup {
my $self = shift;
$self->plugin('mason1_renderer');
$self->routes->get('/' => sub {
my $self = shift;
$self->render('/index', handler => "mason" );
}
);
}
1;
# template: MOJO_HOME/mason/index
Welcome
# example -2-
package MyApp;
use Mojo::Base 'Mojolicious';
sub startup {
my $self = shift;
$self->plugin('mason1_renderer', { interp_params => { comp_root => "/path/to/mason/comps",
... (other parameters to the new() HTML::Mason::Interp constructor)
},
request_params => { error_format => "brief",
... (other parameters to the new() HTML::Mason::Request constructor)
},
}
);
$self->routes->get('/' => sub {
my $self = shift;
$self->render('/index', handler => "mason", mytext => "Hello World" );
}
);
}
1;
# template: /path/to/mason/comps/index
<%args>
$mytext => undef
Welcome : <% $mytext %>
Mason root_comp is <% $c->app->home %>
***** ACKNOWLEDGEMENTS
Original idea was taken from Graham BARR (http://search.cpan.org/~gbarr/)
MojoX::Renderer::Mason module. This module was not longer adapted to Mojolicious new
Plugin philosophy.
Many, many thanks to Sebastian RIEDEL for developping Mojolicious and Jonathan SWARTZ
for developping HTML::Mason and Mason (2).
***** INSTALLATION
To install this module, run the following commands:
perl Makefile.PL
make
make test
make install
***** SUPPORT AND DOCUMENTATION
After installing, you can find documentation for this module with the
perldoc command.
perldoc Mojolicious::Plugin::Mason1Renderer
You can also look for information at:
RT, CPAN's request tracker
http://rt.cpan.org/NoAuth/Bugs.html?Dist=Mojolicious-Plugin-Mason1Renderer
AnnoCPAN, Annotated CPAN documentation
http://annocpan.org/dist/Mojolicious-Plugin-Mason1Renderer
CPAN Ratings
http://cpanratings.perl.org/d/Mojolicious-Plugin-Mason1Renderer
Search CPAN
http://search.cpan.org/dist/Mojolicious-Plugin-Mason1Renderer/
***** LICENSE AND COPYRIGHT
Copyright (C) 2011 Alexandre SIMON
This program is free software; you can redistribute it and/or modify it
under the terms of either: the GNU General Public License as published
by the Free Software Foundation; or the Artistic License.
See http://dev.perl.org/licenses/ for more information.