1Catalyst::View::ComponeUnste:r:SCuobnItnrcilbuudtee(d3C)PaetrallyDsotc:u:mVeinetwa:t:iCoonmponent::SubInclude(3)
2
6 Catalyst::View::Component::SubInclude - Use subincludes in your
7 Catalyst views
8
10 Version 0.10
11
13 package MyApp::View::TT;
14 use Moose;
15 extends 'Catalyst::View::TT';
17 with 'Catalyst::View::Component::SubInclude';
18 __PACKAGE__->config( subinclude_plugin => 'SubRequest' );
20 Then, somewhere in your templates:
22 [% subinclude('/my/widget') %]
24 [% subinclude_using('SubRequest', '/page/footer') %]
25
27 "Catalyst::View::Component::SubInclude" allows you to include content
28 in your templates (or, more generally, somewhere in your view's
29 "render" processing) which comes from another action in your
30 application. It's implemented as a Moose::Role, so using Moose in your
31 view is required.
32 Simply put, it's a way to include the output of a Catalyst sub-request
34 somewhere in your page.
35 It's built in an extensible way so that you're free to use sub-
37 requests, Varnish ESI
38 (<http://www.catalystframework.org/calendar/2008/17>) or any other sub-
39 include plugin you might want to implement.
40
42 This component does its magic by exporting a "subinclude" coderef entry
43 to the stash. This way, it's easily accessible by the templates (which
44 is the most common use-case).
45 "subinclude( $path, @args )"
47 This will render and return the body of the included resource (as
48 specified by $path) using the default subinclude plugin.
49 "subinclude_using( $plugin, $path, @args )"
51 This will render and return the body of the included resource (as
52 specified by $path) using the specified subinclude plugin.
53 The "subinclude" function above is implemented basically as a shortcut
55 which calls this function using the default plugin as the first
56 parameter.
57
59 The module comes with two subinclude plugins: SubRequest, Visit and
60 ESI.
61 By default, the "SubRequest" plugin will be used. This can be changed
63 in the view's configuration options (either in the config file or in
64 the view module itself).
65 Configuration file example:
67 <View::TT>
69 subinclude_plugin ESI
70 </View::TT>
71 "set_subinclude_plugin( $plugin )"
73 This method changes the current active subinclude plugin in runtime. It
74 expects the plugin suffix (e.g. "ESI" or "SubRequest") or a fully-
75 qualified class name in the "Catalyst::View::Component::SubInclude"
76 namespace.
77 Writing plugins
79 If writing your own plugin, keep in kind plugins are required to
80 implement a class method "generate_subinclude" with the following
81 signature:
82 sub generate_subinclude {
84 my ($class, $c, @args) = @_;
85 }
86 The default plugin is stored in the "subinclude_plugin" which can be
88 changed in runtime. It expects a fully qualified class name.
89
91 Catalyst::Plugin::SubRequest, Moose::Role, Moose,
92 <http://www.catalystframework.org/calendar/2008/17>
93
95 Please report any bugs or feature requests to
96 "bug-catalyst-view-component-subinclude at rt.cpan.org", or through the
97 web interface at
98 http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Catalyst-View-Component-SubInclude
99 <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Catalyst-View-
100 Component-SubInclude>. I will be notified, and then you'll
101 automatically be notified of progress on your bug as I make changes.
102
104 Nilson Santos Figueiredo Junior, "<nilsonsfj at cpan.org>"
105
107 Tomas Doran (t0m) "<bobtfish@bobtfish.net".
108 Vladimir Timofeev, "<vovkasm at gmail.com>".
110 Wallace Reis (wreis) "<wreis@cpan.org>".
112
114 Development sponsored by Ionzero LLC <http://www.ionzero.com/>.
115
117 Copyright (C) 2010 Nilson Santos Figueiredo Junior and the above
118 contributors.
119 Copyright (C) 2009 Nilson Santos Figueiredo Junior.
121 Copyright (C) 2009 Ionzero LLC.
123 This program is free software; you can redistribute it and/or modify it
125 under the same terms as Perl itself.
126perl v5.12.2 2010-C1a2t-a1l4yst::View::Component::SubInclude(3)