NAME

       CGI::Application::Plugin::TT::LastModified - Set "Last-Modified" header based on TT
       template

SYNOPSIS

         # when you want to set the "Last-Modified" header manually
           use base qw(CGI::Application);
           use CGI::Application::Plugin::TT;
           use CGI::Application::Plugin::TT::LastModified;

           sub my_runmode {
               my $self = shift;
               my %params = (
                   ...
                   );
               my $html = $self->tt_process( 'template.html', \%params );
               $self->tt_set_last_modified_header();
               return $html;
           }

         # when you want the "Last-Modified" header set automatically
           use base qw(CGI::Application);
           use CGI::Application::Plugin::TT;
           use CGI::Application::Plugin::TT::LastModified qw(:auto);

           sub my_runmode {
               my $self = shift;
               my %params = (
                   ...
                   );
               return $self->tt_process( 'template.html', \%params );
           }

DESCRIPTION

       "CGI::Application::Plugin::TT::LastModified" adds support to "CGI::Application" for
       setting a "Last-Modified" header based on the most recent modification time of any of the
       components of a template that was processed with TT.

       Normally you'll want to call it manually, on as "as needed" basis; if you're processing
       templates with TT you're most likely dealing with dynamic content (in which case you
       probably don't even want a "Last-Modified" header).  The odd time you'll want to set a
       "Last-Modified" header, though, this plugin helps make that easier.

       If you have a desire to have the "Last-Modified" header set automatically for you, though,
       "CGI::Application::Plugin::TT::LastModified" does have an ":auto" import tag which auto-
       registers "tt_set_last_modified_header()" as a "tt_post_process" hook for you.  If you've
       got an app that just processes static TT pages and generates output, this'll be useful for
       you.

METHODS

       import()
           Custom import routine, which allows for "tt_set_last_modified_header()" to be auto-
           added in as a TT post process hook.

       tt_last_modified()
           Returns the most recent modification time for any component of the most recently
           processed template (via "tt_process()"). Time is returned back to the caller as "the
           number of seconds since the epoch".

       tt_set_last_modified_header()
           Sets a "Last-Modified" header in the HTTP response, equivalent to the last
           modification time of the template components as returned by "tt_last_modified()".

AUTHOR

       Graham TerMarsch (cpan@howlingfrog.com)

COPYRIGHT

       Copyright (C) 2007, Graham TerMarsch.  All Rights Reserved.

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

SEE ALSO

       CGI::Application::Plugin::TT, CGI::Application, Template.

perl v5.12.3                                2011-0CGI::Application::Plugin::TT::LastModified(3pm)