Mason 2 (aka Mason 2.x) rendering, plugabble into Mojolicious web framework
Perl
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
lib/Mojolicious/Plugin
t
Changes
MANIFEST
META.yml
Makefile.PL
README

README

***** DESCRIPTION

Mojolicous::Plugin::Mason2Renderer is a renderer for Mason 2 (aka Mason 2.x)
template system, plugabble into Mojolicious web framework.

Mojolicious : http://www.mojolicious.org/ http://search.cpan.org/~kraih/Mojolicious/
Mason (2) : http://search.cpan.org/~jswartz/Mason/


***** SYNOPSIS

  ## Mojolicious::Lite

  # example -1-
    use Mojolicious::Lite;
    plugin 'mason2_renderer';
    get '/' => sub {
        my $self = shift;
        $self->render('/index', handler => "mason" );
    };
    app->start;

    # template: MOJO_HOME/mason/index.mc
    <html>
      <body>Welcome</body>
    </html>

  # example -2-
    use Mojolicious::Lite;
    plugin 'mason2_renderer' => { preload_regexps => [ '.mc$', '/path/to/comps/to/preload', ... ],
                                  interp_params   => { comp_root => "/path/to/mason/comps",
                                                       ... (other parameters to the new() Mason::Interp constructor)
                                                     },
                                  request_params  => { ... (other parameters to the new() Mason::Request constructor)
                                                     },
    };
    get '/' => sub {
        my $self = shift;
        $self->render('/index', handler => "mason", mytext => "Hello world" );
    };
    app->start;

    # template: /path/to/mason/comps/index.mc
    <%class>
    has 'mytext';
    </%class>
    <html>
      <body>Welcome : <% $self->mytext %></body>
    </html>


  ## Mojolicious

  # example -1-
    package MyApp;
    use Mojo::Base 'Mojolicious';

    sub startup {
      my $self = shift;
      $self->plugin('mason2_renderer');
      $self->routes->get('/' => sub {
          my $self = shift;
          $self->render('/index', handler => "mason" );
        }
      );
    }
    1;

    # template: MOJO_HOME/mason/index.mc
    <html>
      <body>Welcome</body>
    </html>

  # example -2-
    package MyApp;
    use Mojo::Base 'Mojolicious';

    sub startup {
      my $self = shift;
      $self->plugin('mason2_renderer', { preload_regexps => [ '.mc$', '/path/to/comps/to/preload', ... ],
                                         interp_params   => { comp_root => "/path/to/mason/comps",
                                                             ... (other parameters to the new() Mason::Interp constructor)
                                                            },
                                         request_params  => { ... (other parameters to the new() 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.mc
    <%class>
    has 'mytext';
    </%class>
    <html>
      <body>
        Welcome : <% $self->mytext %><br/>
        Mason root_comp is <% $c->app->home %><br/>
      </body>
    </html>


***** 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::Mason2Renderer

You can also look for information at:

    RT, CPAN's request tracker
        http://rt.cpan.org/NoAuth/Bugs.html?Dist=Mojolicious-Plugin-Mason2Renderer

    AnnoCPAN, Annotated CPAN documentation
        http://annocpan.org/dist/Mojolicious-Plugin-Mason2Renderer

    CPAN Ratings
        http://cpanratings.perl.org/d/Mojolicious-Plugin-Mason2Renderer

    Search CPAN
        http://search.cpan.org/dist/Mojolicious-Plugin-Mason2Renderer/


***** 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.