Kevin Falcone > RT-Extension-ArticleTemplates-0.07 > RT::Extension::ArticleTemplates

Download:
RT-Extension-ArticleTemplates-0.07.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.07   Source  

NAME ^

RT::Extension::ArticleTemplates - turns articles into dynamic templates

DESCRIPTION ^

When this extension is installed RTFM parses content of articles as a template using Text::Template module. Using this extension you can make your articles dynamic. Text::Template module is used to parse RT's Templates as well and its syntax is pretty simple - you can consult RT docs/wiki or module's documentation.

VERY IMPORTANT ^

It's a SECURITY RISK to install this extension on systems where articles can be changed by not trusted users. You're warned!

Your articles may contain some text that looks like a template and will be parsed after installation when it's actually is not valid template.

INSTALLATION ^

This extension requires RT 4.0.0 or higher.

perl Makefile.PL
make
make install

May need root permissions

Edit your /opt/rt4/etc/RT_SiteConfig.pm

Add this line:

    Set(@Plugins, qw(RT::Extension::ArticleTemplates));

or add RT::Extension::ArticleTemplates to your existing @Plugins line.

Clear your mason cache
    rm -rf /opt/rt4/var/mason_data/obj
Restart your webserver

CONFIGURATION ^

ArticleTemplatesWithRequestArgs

Enabling this option passes in the Mason request arguments to your article templates as the hashref $request_args.

Warning: Request args are user-controlled direct input, so all the normal cautions of using them apply. Never trust user input.

Disabled by default.

AUTHOR ^

Kevin Falcone <falcone@bestpractical.com> Ruslan Zakirov <ruz@bestpractical.com>

LICENCE AND COPYRIGHT ^

Copyright (c) 2008-2012, Best Practical Solutions, LLC. All rights reserved.

This module is free software; you can redistribute it and/or modify it under the terms of version 2 of the GNU General Public License.

ParseTemplate $CONTENT, %TEMPLATE_ARGS

Parses $CONTENT string as a template (Text::Template). $Article and other arguments from %TEMPLATE_ARGS are available in code of the template as perl variables.

syntax highlighting: