3 Catalyst::Manual::Plugins - Catalyst Plugins (and Components)
7 This section lists the some of the plugins and components that are
8 available to extend the runtime functionality of Catalyst. The plugins
9 are not distributed with Catalyst but should be available from CPAN.
10 They typically require additional modules from CPAN. We will try to
11 keep this document up to date, but please check CPAN directly for
12 the latest and greatest.
16 =head2 Catalyst::Plugin::Authentication::CDBI
18 L<Catalyst::Plugin::Authentication::CDBI> is a CDBI (C<Class::DBI>)
19 authentication plugin. Note that it requires a session plugin.
21 =head2 Catalyst::Plugin::Authentication::LDAP
23 L<Catalyst::Plugin::Authentication::LDAP> is a plugin allowing you
24 to authenticate your web users using an LDAP server.
26 =head2 Catalyst::Plugin::Email
28 L<Catalyst::Plugin::Email> sends email with Catalyst and L<Email::Send>
29 and L<Email::MIME::Creator>.
31 =head2 Catalyst::Plugin::Browser
33 L<Catalyst::Plugin::Browser> extends L<Catalyst::Request> by adding the
34 capability of browser detection. It returns an instance of
35 L<HTTP::BrowserDetect>, which lets you get information from the client's
38 =head2 Catalyst::Plugin::Compress::Zlib
40 L<Catalyst::Plugin::Compress::Zlib> supplies Zlib compression for
43 =head2 Catalyst::Plugin::Compress::Bzip2
45 L<Catalyst::Plugin::Compress::Bzip2> compresses a response using
48 =head2 Catalyst::Plugin::FillInForm
50 L<Catalyst::Plugin::FillInForm> is plugin for Catalyst based on
51 C<HTML::FillInForm>, which describes itself as a module to automatically
52 insert data from a previous HTML form into the HTML input, textarea,
53 radio buttons, checkboxes, and select tags. C<HTML::FillInForm> is a
54 subclass of C<HTML::Parser> and uses it to parse the HTML and insert the
55 values into the form tags.
57 =head2 Catalyst::Plugin::FormValidator
59 L<Catalyst::Plugin::FormValidator> is a form validator plugin that uses
60 L<Data::FormValidator> to validate and set up form data from your
61 request parameters. It's a quite thin wrapper around that module, so
62 most of the relevant information can be found there.
64 =head2 Catalyst::Plugin::Geography
66 L<Catalyst::Plugin::Geography> allows you to retrieve various kinds
67 of geographical information. You can retrieve the country or code from
68 the current user, from a given IP address, or from a given hostname.
70 =head2 Catalyst::Plugin::I18N
72 L<Catalyst::Plugin::I18N> is an internationalization plugin for
73 Catalyst. Supports C<mo>/C<po> files and Maketext classes under your
74 application's I18N namespace.
76 =head2 Catalyst::Plugin::Observe
78 L<Catalyst::Plugin::Observe> provides the ability to register AOP-like
79 callbacks to specific Engine events. Subclasses L<Class::Publisher>.
81 =head2 Catalyst::Plugin::PageCache
83 L<Catalyst::Plugin::PageCache> helps improve the performance of slow or
84 frequently accessed pages by caching the entire output of your page.
85 Subsequent requests to the page will receive the page very quickly from
86 cache. Note: At the moment it should be regarded as I<highly
89 =head2 Catalyst::Plugin::Pluggable
91 L<Catalyst::Plugin::Pluggable> is a plugin for pluggable Catalyst
94 =head2 Catalyst::Plugin::Prototype
96 L<Catalyst::Plugin::Prototype> is a plugin for the Prototype JavaScript
97 library. This Plugin allows you to easily implement AJAX functionality
98 without actually knowing Javascript.
100 =head2 Catalyst::Plugin::RequireSSL
102 Use L<Catalyst::Plugin::RequireSSL> if you would like to force visitors
103 to access certain pages using only SSL mode. An attempt to access the
104 page in non-SSL mode will receive a redirect into SSL mode. Useful for
105 shopping carts, user registration forms, and other sensitive data.
107 =head2 Catalyst::Plugin::Session::FastMmap
109 L<Catalyst::Plugin::Session::FastMmap> is a session plugin for Catalyst
110 based on C<Cache::FastMMap>, which uses an mmap'ed file to act as a
111 shared memory interprocess cache.
113 =head2 Catalyst::Plugin::Session
116 =head2 Catalyst::Plugin::Static
118 L<Catalyst::Plugin::Static> is a plugin to serve static files from
119 C<$c-E<gt>config-E<gt>{root}>. Intended chiefly for development
123 =head2 Catalyst::Plugin::SubRequest
125 L<Catalyst::Plugin::SubRequest> is a plugin to allow subrequests to
126 actions to be made within Catalyst. Nice for portal software and such.
128 =head2 Catalyst::Plugin::Textile
130 L<Catalyst::Plugin::Textile> is a persistent Textile processor for
131 Catalyst that uses C<Text::Textile>, a Perl-based implementation of Dean
132 Allen's Textile syntax. Textile is shorthand for doing common formatting
133 tasks (see L<http://textism.com>).
135 =head2 Catalyst::Plugin::Unicode
137 L<Catalyst::Plugin::Unicode> provides a Unicode-aware Catalyst. On
138 request, it decodes all params from UTF-8 octets into a sequence of
139 logical characters. On response, it encodes the body into UTF-8 octets.
141 =head2 Catalyst::Plugin::XMLRPC
143 L<Catalyst::Plugin::XMLRPC> plugin allows your Controller class to
144 dispatch XMLRPC methods from its own class.
147 =head1 COMPONENT MODULES
149 =head2 Catalyst::Model::CDBI
151 L<Catalyst::Model::CDBI> is the C<Class::DBI> (CDBI) module class. It
152 is built on top of C<Class::DBI::Loader>, which automates the
153 definition of C<Class::DBI> sub-classes by scanning the underlying
154 table schemas, setting up columns and primary keys.
156 =head2 Catalyst::Model::CDBI::Plain
158 L<Catalyst::Model::CDBI::Plain> is a neutral interface to the
159 C<Class::DBI> module, which does not attempt to automate table
160 setup. It allows the user to manually set up C<Class::DBI>
161 classes, either by doing so within the Catalyst model classes
162 themselves, or by inheriting from existing C<Class::DBI>
165 =head2 Catalyst::Model::CDBI::CRUD
167 L<Catalyst::Model::CDBI::CRUD> is a subclass of
168 C<Catalyst::Model::CDBI> with additional CRUD (create, retrieve,
169 update, delete) methods.
171 =head2 Catalyst::Model::Plucene
172 L<Catalyst::Model::Plucene> is the model class for the Plucene
175 =head2 Catalyst::View::HTML::Template
177 L<Catalyst::View::HTML::Template> is a View component for
178 displaying your stash with L<HTML::Template>.
180 =head2 Catalyst::View::PSP
182 L<Catalyst::View::PSP> is a View component for displaying your
183 stash using PSP, a Perl extension implementing a JSP-like
184 templating system; see L<Text::PSP>.
186 =head2 Catalyst::View::Petal
187 L<Catalyst::View::Petal> is a View component for displaying
188 your stash using Petal, the Perl Template Attribute Language,
189 an XML-based templating system; see L<Petal>.
191 =head2 Catalyst::View::Mason
193 L<Catalyst::View::Mason> is a View component for displaying your stash
196 =head2 Catalyst::View::TT
198 L<Catalyst::View::TT> is a Template Toolkit view. See
203 Andrew Ford E<lt>A.Ford@ford-mason.co.ukE<gt>
204 Marcus Ramberg E<lt>mramberg@cpan.orgE<gt>
205 Jesse Sheidlower E<lt>jester@panix.comE<gt>
209 This program is free software, you can redistribute it and/or modify it under
210 the same terms as Perl itself.