-
-
14 Dec 2010 14:37:07 UTC
- Distribution: Catalyst-View-Component-SubInclude
- Module version: 0.01
- Source (raw)
- Browse (raw)
- Changes
- How to Contribute
- Clone repository
- Issues (4)
- Testers (1566 / 16 / 0)
- Kwalitee
Bus factor: 9- % Coverage
- License: perl_5
- Activity
24 month- Tools
- Download (36.41KB)
- MetaCPAN Explorer
- Permissions
- Subscribe to distribution
- Permalinks
- This version
- Latest version
and 1 contributors- Nilson Santos Figueiredo Junior, C<< <nilsonsfj at cpan.org> >>
NAME
Catalyst::View::Component::SubInclude::HTTP - HTTP plugin for C::V::Component::SubInclude
SYNOPSIS
In your view class:
package MyApp::View::TT; use Moose; extends 'Catalyst::View::TT'; with 'Catalyst::View::Component::SubInclude'; __PACKAGE__->config( subinclude_plugin => 'HTTP::GET', subinclude => { 'HTTP::GET' => { class => 'HTTP', http_method => 'GET', ua_timeout => '10', uri_map => { '/my/' => 'http://localhost:5000/', }, }, 'HTTP::POST' => { class => 'HTTP', http_method => 'POST', ua_timeout => '10', uri_map => { '/foo/' => 'http://www.foo.com/', }, }, }, );
Then, somewhere in your templates:
[% subinclude('/my/widget') %] ... [% subinclude_using('HTTP::POST', '/foo/path', { foo => 1 }) %]
DESCRIPTION
Catalyst::View::Component::SubInclude::HTTP
does HTTP requests (currently using LWP::UserAgent) and uses the responses to render subinclude contents.CONFIGURATION
The configuration is passed in the
subinclude
key based on your plugin name which can be arbitrary.- class
-
Required just in case your plugin name differs from
HTTP
. - http_method
-
Accepts
GET
andPOST
as values. The default one isGET
. - user_agent
-
This lazily builds a LWP::UserAgent obj, however you can pass a different user agent obj that implements the required API.
- ua_timeout
-
User Agent's timeout config param. Defaults to 10 seconds.
- uri_map
-
This expects a HashRef in order to map paths to different URLs.
- base_url
-
Used only if
uri_map
isundef
and defaults to$c->request->base
.
METHODS
generate_subinclude( $c, $path, $args )
Note that
$path
should be the relative path.SEE ALSO
Catalyst::View::Component::SubInclude
AUTHOR
Wallace Reis
<wreis@cpan.org>
SPONSORSHIP
Development sponsored by Ionzero LLC http://www.ionzero.com/.
COPYRIGHT & LICENSE
Copyright (c) 2010 Wallace Reis.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
Module Install Instructions
To install Catalyst::View::Component::SubInclude, copy and paste the appropriate command in to your terminal.
cpanm Catalyst::View::Component::SubInclude
perl -MCPAN -e shell install Catalyst::View::Component::SubInclude
For more information on module installation, please visit the detailed CPAN module installation guide.