Added deep recursion detection

[catagits/Catalyst-Runtime.git] / lib / Catalyst / Manual / Plugins.pod

=head1 NAME

Catalyst::Manual::Plugins - Catalyst Plugins (and Components)

=head1 DESCRIPTION

This section lists the some of the plugins and components that are
available to extend the runtime functionality of Catalyst. The plugins
are not distributed with Catalyst but should be available from CPAN.
They typically require additional modules from CPAN.

=head1 PLUGINS

=head2 Catalyst::Plugin::Authentication::CDBI

L<Catalyst::Plugin::Authentication::CDBI> is a CDBI (C<Class::DBI>)
authentication plugin.  Note that it requires a session plugin.

=head2 Catalyst::Plugin::Email

L<Catalyst::Plugin::Email> sends email with Catalyst and L<Email::Send>
and L<Email::MIME::Creator>.

=head2 Catalyst::Plugin::FillInForm

L<Catalyst::Plugin::FillInForm> is plugin for Catalyst based on
C<HTML::FillInForm>, which describes itself as a module to automatically
insert data from a previous HTML form into the HTML input, textarea,
radio buttons, checkboxes, and select tags.  C<HTML::FillInForm> is a
subclass of C<HTML::Parser> and uses it to parse the HTML and insert the
values into the form tags.

=head2 Catalyst::Plugin::FormValidator

L<Catalyst::Plugin::FormValidator> is a form validator plugin that uses
L<Data::FormValidator> to validate and set up form data from your
request parameters.  It's a quite thin wrapper around that module, so
most of the relevant information can be found there.


=head2 Catalyst::Plugin::I18N

L<Catalyst::Plugin::I18N> is an internationalization plugin for
Catalyst.  Supports C<mo>/C<po> files and Maketext classes under your
application's I18N namespace.


=head2 Catalyst::Plugin::Pluggable

L<Catalyst::Plugin::Pluggable> is a plugin for pluggable Catalyst
applications.

=head2 Catalyst::Plugin::Prototype

L<Catalyst::Plugin::Prototype> is a plugin for the Prototype JavaScript
library. This Plugin allows you to easily implement AJAX functionality
without actually knowing Javascript.

=head2 Catalyst::Plugin::Session::FastMmap

L<Catalyst::Plugin::Session::FastMmap> is a session plugin for Catalyst
based on C<Cache::FastMMap>, which uses an mmap'ed file to act as a
shared memory interprocess cache.


=head2 Catalyst::Plugin::Static

L<Catalyst::Plugin::Static> is a plugin to serve static files from C<<
$c->config->{root} >>/<< action >>/.


=head2 Catalyst::Plugin::SubRequest

L<Catalyst::Plugin::SubRequest> is a plugin to allow subrequests to
actions to be made within Catalyst.  Nice for portal software and such.


=head2 Catalyst::Plugin::Textile

L<Catalyst::Plugin::Textile> is a persistent Textile processor for
Catalyst that uses C<Text::Textile>, a Perl-based implementation of Dean
Allen's Textile syntax. Textile is shorthand for doing common formatting
tasks (see L<http://textism.com>).


=head2 Catalyst::Plugin::XMLRPC

L<Catalyst::Plugin::XMLRPC> plugin allows your Controller class to
dispatch XMLRPC methods from its own class.


=head1 COMPONENT MODULES

=head2 Catalyst::Model::CDBI

L<Catalyst::Model::CDBI> is the C<Class::DBI> (CDBI) module class.  It 
is built on top of C<Class::DBI::Loader>, which automates the 
definition of C<Class::DBI> sub-classes by scanning the underlying 
table schemas, setting up columns and primary keys.

=head2 Catalyst::Model::CDBI::Plain

L<Catalyst::Model::CDBI::Plain> is a neutral interface to the
C<Class::DBI> module, which does not attempt to automate table
setup. It allows the user to manually set up C<Class::DBI>
classes, either by doing so within the Catalyst model classes
themselves, or by inheriting from existing C<Class::DBI>
classes.

=head2 Catalyst::Model::CDBI::CRUD

L<Catalyst::Model::CDBI::CRUD> is a subclass of 
C<Catalyst::Model::CDBI> with additional CRUD (create, replace, 
update, delete) methods.


=head2 Catalyst::View::TT

L<Catalyst::View::TT> is a Template Toolkit view. See
L<Template::Manual>.

=head2 Catalyst::View::Mason

L<Catalyst::View::Mason> allows you to render your stash using
L<HTML::Mason>.

=head1 AUTHOR

Andrew Ford E<lt>A.Ford@ford-mason.co.ukE<gt>
Marcus Ramberg E<lt>mramberg@cpan.orgE<gt>

=head1 COPYRIGHT

This program is free software, you can redistribute it and/or modify it under
the same terms as Perl itself.