package WebGUI::Asset::Template; =head1 LEGAL ------------------------------------------------------------------- WebGUI is Copyright 2001-2008 Plain Black Corporation. ------------------------------------------------------------------- Please read the legal notices (docs/legal.txt) and the license (docs/license.txt) that came with this distribution before using this software. ------------------------------------------------------------------- http://www.plainblack.com info@plainblack.com ------------------------------------------------------------------- =cut use strict; use base 'WebGUI::Asset'; use WebGUI::International; use WebGUI::Asset::Template::HTMLTemplate; use WebGUI::Utility; =head1 NAME Package WebGUI::Asset::Template =head1 DESCRIPTION Provides a mechanism to provide a templating system in WebGUI. =head1 SYNOPSIS use WebGUI::Asset::Template; =head1 METHODS These methods are available from this class: =cut #------------------------------------------------------------------- =head2 definition ( session, definition ) Defines the properties of this asset. =head3 session A reference to an existing session. =head3 definition A hash reference passed in from a subclass definition. =cut sub definition { my $class = shift; my $session = shift; my $definition = shift; my $i18n = WebGUI::International->new($session,"Asset_Template"); push @{$definition}, { assetName => $i18n->get('assetName'), icon => 'template.gif', tableName => 'template', className => 'WebGUI::Asset::Template', properties => { template => { fieldType => 'codearea', defaultValue => undef, }, isEditable => { noFormPost => 1, fieldType => 'hidden', defaultValue => 1, }, isDefault => { fieldType => 'hidden', defaultValue => 0, }, showInForms => { fieldType => 'yesNo', defaultValue => 1, }, parser => { noFormPost => 1, fieldType => 'selectList', defaultValue => [$session->config->get("defaultTemplateParser")], }, headBlock => { fieldType => "codearea", defaultValue => undef, }, namespace => { fieldType => 'combo', defaultValue => undef, }, }, }; return $class->SUPER::definition($session,$definition); } #------------------------------------------------------------------- sub processPropertiesFromFormPost { my $self = shift; $self->SUPER::processPropertiesFromFormPost; # TODO: Perhaps add a way to check template syntax before it blows stuff up? if ($self->getValue("parser") ne $self->session->form->process("parser","className") && ($self->session->form->process("parser","className") ne "")) { my %data; if (isIn($self->session->form->process("parser","className"),@{$self->session->config->get("templateParsers")})) { %data = ( parser => $self->session->form->process("parser","className") ); } else { %data = ( parser => $self->session->config->get("defaultTemplateParser") ); } $self->update(\%data); } } #------------------------------------------------------------------- =head2 getEditForm ( ) Returns the TabForm object that will be used in generating the edit page for this asset. =cut sub getEditForm { my $self = shift; my $tabform = $self->SUPER::getEditForm(); my $i18n = WebGUI::International->new($self->session, 'Asset_Template'); $tabform->hidden({ name=>"returnUrl", value=>$self->session->form->get("returnUrl") }); if ($self->getValue("namespace") eq "") { my $namespaces = $self->session->dbSlave->buildHashRef("select distinct(namespace) from template order by namespace"); $tabform->getTab("properties")->combo( -name=>"namespace", -options=>$namespaces, -label=>$i18n->get('namespace'), -hoverHelp=>$i18n->get('namespace description'), -value=>[$self->session->form->get("namespace")] ); } else { $tabform->getTab("meta")->readOnly( -label=>$i18n->get('namespace'), -hoverHelp=>$i18n->get('namespace description'), -value=>$self->getValue("namespace") ); $tabform->getTab("meta")->hidden( -name=>"namespace", -value=>$self->getValue("namespace") ); } $tabform->getTab("display")->yesNo( -name=>"showInForms", -value=>$self->getValue("showInForms"), -label=>$i18n->get('show in forms'), -hoverHelp=>$i18n->get('show in forms description'), ); $tabform->getTab("properties")->codearea( -name=>"template", -label=>$i18n->get('assetName'), -hoverHelp=>$i18n->get('template description'), -value=>$self->getValue("template") ); $tabform->getTab("properties")->codearea( -name=>"headBlock", -label=>$i18n->get('head block'), -hoverHelp=>$i18n->get('head block description'), -value=>$self->getValue("headBlock") ); if($self->session->config->get("templateParsers")){ my @temparray = @{$self->session->config->get("templateParsers")}; tie my %parsers, 'Tie::IxHash'; while(my $a = shift @temparray){ $parsers{$a} = $self->getParser($self->session, $a)->getName(); } my $value = [$self->getValue("parser")]; $value = \[$self->session->config->get("defaultTemplateParser")] if(!$self->getValue("parser")); $tabform->getTab("properties")->selectBox( -name=>"parser", -options=>\%parsers, -value=>$value, -label=>$i18n->get('parser'), -hoverHelp=>$i18n->get('parser description'), ); } return $tabform; } #------------------------------------------------------------------- =head2 getList ( session, namespace [,clause] ) Returns a hash reference containing template ids and template names of all the templates in the specified namespace. NOTE: This is a class method. =head3 session A reference to the current session. =head3 namespace Specify the namespace to build the list for. If no namespace is specified, then an empty hash reference will be returned. =head3 clause An extra clause that can be used to further limit the list, such as "assetData.status='approved' =cut sub getList { my $class = shift; my $session = shift; my $namespace = shift; my $clause = shift; if ($clause) { $clause = ' and ' . $clause; } else { $clause = ''; } my $sql = "select asset.assetId, assetData.revisionDate from template left join asset on asset.assetId=template.assetId left join assetData on assetData.revisionDate=template.revisionDate and assetData.assetId=template.assetId where template.namespace=? and template.showInForms=1 and asset.state='published' and assetData.revisionDate=(SELECT max(revisionDate) from assetData where assetData.assetId=asset.assetId and (assetData.status='approved' or assetData.tagId=?)) $clause order by assetData.title"; my $sth = $session->dbSlave->read($sql, [$namespace, $session->scratch->get("versionTag")]); my %templates; tie %templates, 'Tie::IxHash'; while (my ($id, $version) = $sth->array) { $templates{$id} = WebGUI::Asset::Template->new($session,$id,undef,$version)->getTitle; } $sth->finish; return \%templates; } #------------------------------------------------------------------- =head2 getParser ( session, parser ) Returns a template parser object. NOTE: This is a class method. =head3 session A reference to the current session. =head3 parser A parser class to use. Defaults to "WebGUI::Asset::Template::HTMLTemplate" =cut sub getParser { my $class = shift; my $session = shift; my $parser = shift || $session->config->get("defaultTemplateParser") || "WebGUI::Asset::Template::HTMLTemplate"; if ($parser eq "") { return WebGUI::Asset::Template::HTMLTemplate->new($session); } else { eval("use $parser"); return $parser->new($session); } } #------------------------------------------------------------------- =head2 indexContent ( ) Making private. See WebGUI::Asset::indexContent() for additonal details. =cut sub indexContent { my $self = shift; my $indexer = $self->SUPER::indexContent; $indexer->addKeywords($self->get("namespace")); $indexer->setIsPublic(0); } #------------------------------------------------------------------- =head2 prepare ( headerTemplateVariables ) This method sets the tags from the head block parameter of the template into the HTML head block in the style. You only need to call this method if you're using the HTML streaming features of WebGUI, like is done in the prepareView()/view()/www_view() methods of WebGUI assets. =head3 headerTemplateVariables A hash reference containing template variables to be processed for the head block. Typically obtained via $asset->getMetaDataAsTemplateVariables. =cut sub prepare { my $self = shift; my $vars = shift; $self->{_prepared} = 1; my $templateHeadersSent = $self->session->stow->get("templateHeadersSent") || []; my @sent = @{$templateHeadersSent}; unless (isIn($self->getId, @sent)) { # don't send head block if we've already sent it for this template if ($self->session->style->sent) { $self->session->output->print($self->getParser($self->session, $self->get('parser'))->process($self->get('headBlock'), $vars)); } else { $self->session->style->setRawHeadTags($self->getParser($self->session, $self->get('parser'))->process($self->get('headBlock'), $vars)); } } push(@sent, $self->getId); $self->session->stow->set("templateHeadersSent", \@sent); } #------------------------------------------------------------------- =head2 process ( vars ) Evaluate a template replacing template commands for HTML. =head3 vars A hash reference containing template variables and loops. Automatically includes the entire WebGUI session. =cut # TODO: Have this throw an error so we can catch it and print more information # about the template that has the error. Finding an "ERROR: Error in template" # in the error log is not very helpful... sub process { my $self = shift; my $vars = shift; $self->prepare unless ($self->{_prepared}); return $self->getParser($self->session, $self->get("parser"))->process($self->get("template"), $vars); } #------------------------------------------------------------------- =head2 processRaw ( session, template, vars [ , parser ] ) Process an arbitrary template string. This is a class method. =head3 session A reference to the current session. =head3 template A scalar containing the template text. =head3 vars A hash reference containing template variables. =head3 parser Optionally specify the class name of a parser to use. =cut sub processRaw { my $class = shift; my $session = shift; my $template = shift; my $vars = shift; my $parser = shift; return $class->getParser($session,$parser)->process($template, $vars); } #------------------------------------------------------------------- sub www_edit { my $self = shift; return $self->session->privilege->insufficient() unless $self->canEdit; return $self->session->privilege->locked() unless $self->canEditIfLocked; my $session = $self->session; my $form = $session->form; my $url = $session->url; my $i18n = WebGUI::International->new($session, "Asset_Template"); my $output = ''; # Add an unfriendly warning message if this is a default template if ( $self->get( 'isDefault' ) ) { # Get a proper URL to make the duplicate my $duplicateUrl = $self->getUrl( "func=editDuplicate" ); if ( $form->get( "proceed" ) ) { $duplicateUrl = $url->append( $duplicateUrl, "proceed=" . $form->get( "proceed" ) ); if ( $form->get( "returnUrl" ) ) { $duplicateUrl = $url->append( $duplicateUrl, "returnUrl=" . $form->get( "returnUrl" ) ); } } $session->style->setRawHeadTags( <<'ENDHTML' ); ENDHTML $output .= q{
} . $i18n->get( "warning default template" ) . q{
} . sprintf( q{%s}, $i18n->get( "make duplicate label" ) ) . q{
| %s | %s |
| %s | %s |
| %s | %s |
| %s | |
| %s | |