|
|
LinkXL plugin aims to monetize WordPress blogs
|
|
Mason::Plugin::RouterSimple(3pm) User Contributed Perl Documentation Mason::Plugin::RouterSimple(3pm) NAME
Mason::Plugin::RouterSimple - Specify routes for page components VERSION
version 0.05 SYNOPSIS
In a top-level component '/archives.mc': %% route ":section/{year:[0-9]{4}}/{month:[0-9]{2}}"; Archives for <b><% $.section %></b> For the month of <% $.month %>/<% $.year %> then "/archives/news/2010/02" outputs Archives for <b>news</b> For the month of 2010/02 DESCRIPTION
See Mason::Manual::RequestDispatch for background on how request paths get mapped to page components. This plugin allows you to parse "$m->path_info" (the remainder of the top-level path) using Router::Simple routes. It can be used whenever "$m->path_info" is set, i.e. with a dhandler or with a partial path. Use the "route" keyword to declare routes, either in a <%class> block or on a %%-line. Like Router::Simple::connect, "route" takes a string/regex pattern and a destination hashref; the latter defaults to "{}" if omitted. e.g. %% route "wiki/:page", { action => "wiki" }; <%class> route "download/*.*", { action => "download" }; route "blog/{year:[0-9]+}/{month:[0-9]{2}}"; </%class> This plugin overrides the default allow_path_info to return true for any component that declares at least one route. For components that do not declare a route, you will need to override "allow_path_info" as usual. Any named captured arguments, including "splat", are placed in component attributes, which are automatically declared (as standard read- write attributes) if you do not otherwise declare them. If you specify more than one route in a component, they will be tried in turn, with the first matching route taking precedence. If none of the routes match, the request will be declined; in a web context this generally means a 404. e.g. Given the route declarations above in a component named '/site.mc', o The URL "/site/wiki/HomePage" will set "$.action = "wiki"" and "$.page = "HomePage"". o The URL "/site/download/ping.mp3" will set "$.action = "download"" and "$.splat = ['ping', 'mp3']". o The URL "/site/blog/2010/02" will set "$.year = "2010"" and "$.month = "02"". o The URLs "/site/other" and "/site/blog/10/02" will result in a decline/404. SUPPORT
The mailing list for Mason and Mason plugins is mason-users@lists.sourceforge.net. You must be subscribed to send a message. To subscribe, visit https://lists.sourceforge.net/lists/listinfo/mason-users <https://lists.sourceforge.net/lists/listinfo/mason-users>. You can also visit us at "#mason" on <irc://irc.perl.org/#mason>. Bugs and feature requests will be tracked at RT: http://rt.cpan.org/NoAuth/Bugs.html?Dist=Mason-Plugin-RouterSimple bug-mason-plugin-routersimple@rt.cpan.org The latest source code can be browsed and fetched at: http://github.com/jonswar/perl-mason-plugin-routersimple git clone git://github.com/jonswar/perl-mason-plugin-routersimple.git SEE ALSO
Mason, Router::Simple AUTHOR
Jonathan Swartz <swartz@pobox.com> COPYRIGHT AND LICENSE
This software is copyright (c) 2011 by Jonathan Swartz. This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. perl v5.14.2 2011-07-03 Mason::Plugin::RouterSimple(3pm)
