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" and "POST" as values. The default one is "GET".

       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" is "undef" 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.

perl v5.34.0                                       2022-06-09              Catalyst::View...ubInclude::HTTP(3pm)