petal::hash::test(3pm) [debian man page]

Petal::Hash::Test(3pm)					User Contributed Perl Documentation				    Petal::Hash::Test(3pm)

NAME

       Petal::Hash::Test - Test and Tutorial Petal modifier

SUMMARY

       Petal modifiers are snippets of code which are used to extend the expression engine capabilities. This test shows how to write your own
       modifiers.

API

       The modifier API is very, very simple. It consists of two elements:

   The package name
       Your modifier should be called Petal::Hash::<SomeThing>, where <SomeThing> is the name that you want to give to your modifier.

       For example, this modifier is called Petal::Hash::Test. Petal will automatically pick it the module up and assign it the 'test:' prefix.

	   package Petal::Hash::Test;
	   use warnings;
	   use strict;

   The method $class->process ($hash, $argument);
       This class method will define the modifier in itself.

       * $class is the package name of your modifier (which might come in handy if you're subclassing a modifier),

       * $hash is the execution context, i.e. the objects and data which will 'fill' your template,

       * $argument is whatever was after your modifier's prefix. For example, for the expression 'test:foo bar', $argument would be 'foo bar'.

       In this test / tutorial we're going to write a modifier which uppercases a Petal expression.

	 sub process
	 {
	     my $class	  = shift;
	     my $hash	  = shift;
	     my $argument = shift;

	     return uc ($hash->get ($argument));
	 }

	 1;

	 __END__

       And that's it! Simple!

AUTHOR

       Jean-Michel Hiver

       This module is redistributed under the same license as Perl itself.

SEE ALSO

       The template hash module:

	 Petal::Hash

perl v5.12.4							    2011-08-25						    Petal::Hash::Test(3pm)

CGI
::Application::Plugin::AnyTemplate::Driver::Petal(3pmUser Contributed Perl DocumentatiCGI::Application::Plugin::AnyTemplate::Driver::Petal(3pm)

NAME

       CGI::Application::Plugin::AnyTemplate::Driver::Petal - Petal plugin to AnyTemplate

DESCRIPTION

       This is a driver for CGI::Application::Plugin::AnyTemplate, which provides the implementation details specific to rendering templates via
       the Petal templating system.

       All "AnyTemplate" drivers are designed to be used the same way.	For general usage instructions, see the documentation of
       CGI::Application::Plugin::AnyTemplate.

EMBEDDED COMPONENT SYNTAX (Petal)
       Note that for embedding component to work properly in Petal, you need to enclose the contents of the included file in tags, such as
       "<span>" tags.

	   <span>
	   var: <span petal:replace="var"></span>
	   </span>

       The "Petal" syntax for embedding components is:

	   <span tal:replace="structure CGIAPP/embed 'some_run_mode' some_param1 some_param2 'some literal string 3'">
	       this text gets replaced by the output of some_run_mode
	   </span>

       This can be overridden by the following configuration variables:

	   embed_tag_name	# default 'CGIAPP'

       For instance by setting the following values in your configuration file:

	   embed_tag_name	'MYAPP'

       Then the embedded component tag will look like:

	   <span tal:replace="structure MYAPP/embed 'some_run_mode'">
	       this text gets replaced by the output of some_run_mode
	   </span>

       Note that when creating documents to be included as components, they must be complete XML documents.

CONFIGURATION

       The CGI::Application::Plugin::AnyTemplate::Driver::Petal driver accepts the following config parameters:

       embed_tag_name
	   The name of the tag used for embedding components.  Defaults to "CGIAPP".

       template_extension
	   If "auto_add_template_extension" is true, then CGI::Application::Plugin::AnyTemplate will append the value of "template_extension" to
	   "filename".	By default the "template_extension" is ".xhtml".

       emulate_associate_query
	   This feature is now deprecated and will be removed in a future release.

	   If this config parameter is true, then CGI::Application::Plugin::AnyTemplate::Driver::Petal will copy all of the webapp's query params
	   into the template.

	   This is similar to what would happen if you used HTML::Template's "associate" feature with the webapp's query object:

	       my $driver = HTML::Template->new(
		   associate => $self->query,
	       );

	   By default "emulate_associate_query" is false.

       All other configuration parameters are passed on unchanged to Petal.

   required_modules
       The "required_modules" function returns the modules required for this driver to operate.  In this case: "Petal".

DRIVER METHODS

       initialize
	   Initializes the Petal driver.  See the docs for CGI::Application::Plugin::AnyTemplate::Base for details.

       render_template
	   Fills the Petal object with "$self->param"

	   If the param "emulate_associate_query" is true, then set params for each of $self->{'webapp'}->query, mimicking HTML::Template's
	   associate mechanism.

	   Also set up a CGI::Application::Plugin::AnyTemplate::ComponentHandler object so that the "CGIAPP.embed" callback will work.

	   Returns the output of the filled template as a string reference.

	   See the docs for CGI::Application::Plugin::AnyTemplate::Base for details.

SEE ALSO

	   CGI::Application::Plugin::AnyTemplate
	   CGI::Application::Plugin::AnyTemplate::Base
	   CGI::Application::Plugin::AnyTemplate::ComponentHandler
	   CGI::Application::Plugin::AnyTemplate::Driver::HTMLTemplate
	   CGI::Application::Plugin::AnyTemplate::Driver::HTMLTemplateExpr
	   CGI::Application::Plugin::AnyTemplate::Driver::HTMLTemplatePluggable
	   CGI::Application::Plugin::AnyTemplate::Driver::TemplateToolkit
	   CGI::Application::Plugin::AnyTemplate::Driver::Petal

	   CGI::Application

	   Template::Toolkit
	   HTML::Template

	   HTML::Template::Pluggable
	   HTML::Template::Plugin::Dot

	   Petal

	   Exporter::Renaming

	   CGI::Application::Plugin::TT

AUTHOR

       Michael Graham, "<mgraham@cpan.org>"

COPYRIGHT &; LICENSE
       Copyright 2005 Michael Graham, All Rights Reserved.

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

perl v5.10.1							    2010-12-16		 CGI::Application::Plugin::AnyTemplate::Driver::Petal(3pm)