NAME

Templer::Plugin::FileContents - A plugin to read file contents.

SYNOPSIS

The following is a good example use of this plugin

title: About my site
passwd: read_file( /etc/passwd )
----
<p>This is my password file:</p>
<!-- tmpl_var name='passwd' -->

DESCRIPTION

This plugin reads the contents of files from the local system, and allows files to be included inline in templates.

LICENSE

This module is free software; you can redistribute it and/or modify it under the terms of either:

a) the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version, or

b) the Perl "Artistic License".

AUTHOR

Steve Kemp <steve@steve.org.uk>

COPYRIGHT AND LICENSE

Copyright (C) 2012-2015 Steve Kemp <steve@steve.org.uk>.

This library is free software. You can modify and or distribute it under the same terms as Perl itself.

METHODS

Constructor. No arguments are required/supported.

expand_variables

This is the method which is called by the Templer::Plugin::Factory to expand the variables contained in a Templer::Site::Page object.

Variables are written in the file in the form "key: value", and are internally stored within the Page object as a hash.

This method iterates over each key & value and updates any that seem to refer to file-inclusion.