[%# # IMPORTANT NOTE # This documentation is generated automatically from source # templates. Any changes you make here may be lost. # # The 'docsrc' documentation source bundle is available for download # from http://www.template-toolkit.org/docs.html and contains all # the source templates, XML files, scripts, etc., from which the # documentation for the Template Toolkit is built. -%] [% META book = 'Modules' page = 'Plugin_Procedural' %] [% WRAPPER toc; PROCESS tocitem title ="SYNOPSIS" subs = []; PROCESS tocitem title ="DESCRIPTION" subs = []; PROCESS tocitem title ="AUTHOR" subs = []; PROCESS tocitem title ="VERSION" subs = []; PROCESS tocitem title ="COPYRIGHT" subs = []; PROCESS tocitem title ="SEE ALSO" subs = []; END %] [% WRAPPER section title="SYNOPSIS" -%]

        package Template::Plugin::LWPSimple;
        use base qw(Template::Plugin::Procedural);
        use LWP::Simple;  # exports 'get'
        1;

        [% tt_start_tag %] USE LWPSimple [% tt_end_tag %]
        [% tt_start_tag %] LWPSimple.get("http://www.tt2.org/") [% tt_end_tag %]

[%- END %] [% WRAPPER section title="DESCRIPTION" -%]

Template::Plugin::Procedural is a base class for Template Toolkit plugins that causes defined subroutines to be called directly rather than as a method. Essentially this means that subroutines will not receive the class name or object as its first argument.

This is most useful when creating plugins for modules that normally work by exporting subroutines that do not expect such additional arguments.

Despite the fact that subroutines will not be called in an OO manner, inheritance still function as normal. A class that uses Template::Plugin::Procedural can be subclassed and both subroutines defined in the subclass and subroutines defined in the original class will be available to the Template Toolkit and will be called without the class/object argument.

[%- END %] [% WRAPPER section title="AUTHOR" -%]

Mark Fowler <mark@twoshortplanks.com>

[% ttlink('http://www.twoshortplanks.com', 'http://www.twoshortplanks.com') -%]

[%- END %] [% WRAPPER section title="VERSION" -%]

1.17, distributed as part of the Template Toolkit version 2.19, released on 27 April 2007.

[%- END %] [% WRAPPER section title="COPYRIGHT" -%]

Copyright (C) 2002 Mark Fowler <mark@twoshortplanks.com>

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

[%- END %] [% WRAPPER section title="SEE ALSO" -%]

[% ttlink('Template', 'Template') -%], [% ttlink('Template::Plugin', 'Template::Plugin') -%]

[%- END %]