57d2dbed56
Move logic out of WebGUI::Session::HTTP and into WebGUI::Session::Response / ::Request; deprecate more functions; change references in core to use $session->response instead; fix tests that broke because of the change but not one that merely generate the deprecated warning because I want to know that the proxying of depricated methods is working. These can be changed later.
939 lines
28 KiB
Perl
939 lines
28 KiB
Perl
package WebGUI::Asset::Template;
|
|
|
|
=head1 LEGAL
|
|
|
|
-------------------------------------------------------------------
|
|
WebGUI is Copyright 2001-2009 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 Moose;
|
|
use WebGUI::Definition::Asset;
|
|
extends 'WebGUI::Asset';
|
|
|
|
define assetName => ['assetName', 'Asset_Template'];
|
|
define icon => 'template.gif';
|
|
define tableName => 'template';
|
|
|
|
property template => (
|
|
fieldType => 'codearea',
|
|
syntax => "html",
|
|
default => undef,
|
|
trigger => \&_template_autopack,
|
|
label => ['assetName', 'Asset_Template'],
|
|
hoverHelp => ['template description', 'Asset_Template'],
|
|
);
|
|
sub _template_autopack {
|
|
my ($self, $new, $old) = @_;
|
|
return if $new eq $old;
|
|
$self->_clear_templatePacked;
|
|
}
|
|
property isEditable => (
|
|
noFormPost => 1,
|
|
fieldType => 'hidden',
|
|
default => 1,
|
|
);
|
|
property isDefault => (
|
|
noFormPost => 1,
|
|
fieldType => 'hidden',
|
|
default => 0,
|
|
);
|
|
property showInForms => (
|
|
fieldType => 'yesNo',
|
|
default => 1,
|
|
label => ['show in forms', 'Asset_Template'],
|
|
hoverHelp => ['show in forms description', 'Asset_Template'],
|
|
);
|
|
property parser => (
|
|
noFormPost => 1,
|
|
fieldType => 'selectBox',
|
|
lazy => 1,
|
|
builder => '_default_parser',
|
|
lazy => 1,
|
|
);
|
|
sub _default_parser {
|
|
my $self = shift;
|
|
return $self->session->config->get('defaultTemplateParser');
|
|
}
|
|
property namespace => (
|
|
fieldType => 'combo',
|
|
default => undef,
|
|
label => ['namespace', 'Asset_Template'],
|
|
hoverHelp => ['namespace description', 'Asset_Template'],
|
|
);
|
|
property templatePacked => (
|
|
fieldType => 'hidden',
|
|
noFormPost => 1,
|
|
lazy => 1,
|
|
clearer => '_clear_templatePacked',
|
|
builder => '_build_templatePacked',
|
|
);
|
|
sub _build_templatePacked {
|
|
my $self = shift;
|
|
my $template = $self->template;
|
|
if (defined $template) {
|
|
HTML::Packer::minify( \$template, {
|
|
do_javascript => 'shrink',
|
|
do_stylesheet => 'minify',
|
|
} );
|
|
}
|
|
$template;
|
|
}
|
|
|
|
property usePacked => (
|
|
fieldType => 'yesNo',
|
|
default => 0,
|
|
label => ['usePacked label', 'Asset_Template'],
|
|
hoverHelp => ['usePacked description', 'Asset_Template'],
|
|
);
|
|
|
|
property storageIdExample => (
|
|
fieldType => 'image',
|
|
label => ['field storageIdExample', 'Asset_Template'],
|
|
hoverHelp => ['field storageIdExample description', 'Asset_Template'],
|
|
);
|
|
|
|
property attachmentsJson => (
|
|
fieldType => 'JsonTable',
|
|
label => [ "attachments display label", "Asset_Template" ],
|
|
);
|
|
|
|
use WebGUI::International;
|
|
use WebGUI::Asset::Template::HTMLTemplate;
|
|
use WebGUI::Form;
|
|
use WebGUI::Exception;
|
|
use List::MoreUtils qw{ any };
|
|
use Tie::IxHash;
|
|
use Clone qw/clone/;
|
|
use HTML::Packer;
|
|
use JSON qw{ to_json };
|
|
|
|
=head1 NAME
|
|
|
|
Package WebGUI::Asset::Template
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
Provides a mechanism to provide a templating system in WebGUI.
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
my $template = WebGUI::Asset::Template->newById( $session, "template id" );
|
|
$template->setParam( param => "value", param2 => "value" );
|
|
print $template->process;
|
|
|
|
|
|
=head1 ATTRIBUTES
|
|
|
|
|
|
#----------------------------------------------------------------------------
|
|
|
|
=head2 param
|
|
|
|
Save params in the template for later processing. This allows a template to be
|
|
passed around, adding variables until finally it is processed and output for
|
|
the user.
|
|
|
|
Use L<setParam> method to set parameters.
|
|
|
|
=cut
|
|
|
|
has param => (
|
|
traits => [ 'Hash' ],
|
|
is => 'ro',
|
|
isa => 'HashRef',
|
|
default => sub { {} },
|
|
handles => {
|
|
setParam => 'set',
|
|
getParam => 'get',
|
|
deleteParam => 'delete',
|
|
},
|
|
);
|
|
|
|
#----------------------------------------------------------------------------
|
|
|
|
=head2 style
|
|
|
|
Attach a style template to this template. This will allow you to return the
|
|
template from a www_ method and have the WebGUI PSGI handler do the processing.
|
|
|
|
Accepts an asset ID
|
|
|
|
=cut
|
|
|
|
has style => (
|
|
is => 'rw',
|
|
isa => 'Maybe[Str]',
|
|
);
|
|
|
|
=head1 METHODS
|
|
|
|
These methods are available from this class:
|
|
|
|
=cut
|
|
|
|
#-------------------------------------------------------------------
|
|
|
|
=head2 addAttachments ( new_attachments )
|
|
|
|
Adds attachments to this template. New attachments are added to the end of the current set of
|
|
attachments.
|
|
|
|
=head3 new_attachments
|
|
|
|
An arrayref of hashrefs, where each hashref should have at least url and type. All
|
|
other keys will be ignored.
|
|
|
|
=cut
|
|
|
|
sub addAttachments {
|
|
my ($self, $new_attachments) = @_;
|
|
my $attachments = $self->getAttachments();
|
|
|
|
foreach my $a (@{ $new_attachments }) {
|
|
push @{ $attachments }, {
|
|
url => $a->{url},
|
|
type => $a->{type},
|
|
};
|
|
}
|
|
my $json = JSON->new->encode( $attachments );
|
|
$self->update({ attachmentsJson => $json, });
|
|
}
|
|
|
|
#-------------------------------------------------------------------
|
|
|
|
=head2 cut ( )
|
|
|
|
Extend the base method to handle cutting the User Function Style template and destroying your site.
|
|
If the current template is the User Function Style template with the Fail Safe template.
|
|
|
|
=cut
|
|
|
|
around cut => sub {
|
|
my ( $orig, $self ) = @_;
|
|
my $returnValue = $self->$orig();
|
|
if ($returnValue && $self->getId eq $self->session->setting->get('userFunctionStyleId')) {
|
|
$self->session->setting->set('userFunctionStyleId', 'PBtmpl0000000000000060');
|
|
}
|
|
return $returnValue;
|
|
};
|
|
|
|
=head2 addRevision ( )
|
|
|
|
Override the master addRevision to copy attachments
|
|
|
|
=cut
|
|
|
|
override addRevision => sub {
|
|
my ( $self, $properties, @args ) = @_;
|
|
my $asset = super();
|
|
delete $properties->{templatePacked};
|
|
return $asset;
|
|
};
|
|
|
|
#-------------------------------------------------------------------
|
|
|
|
=head2 duplicate
|
|
|
|
Subclass the duplicate method so that the isDefault flag is set to 0 on any
|
|
copy.
|
|
|
|
=cut
|
|
|
|
override duplicate => sub {
|
|
my $self = shift;
|
|
my $newTemplate = super();
|
|
$newTemplate->update({isDefault => 0});
|
|
if ( my $storageId = $self->get('storageIdExample') ) {
|
|
my $newStorage = WebGUI::Storage->get( $self->session, $storageId )->copy;
|
|
$newTemplate->update({ storageIdExample => $newStorage->getId });
|
|
}
|
|
return $newTemplate;
|
|
};
|
|
|
|
#-------------------------------------------------------------------
|
|
|
|
=head2 exportAssetData ( )
|
|
|
|
Override to add attachments to package data
|
|
|
|
=cut
|
|
|
|
override exportAssetData => sub {
|
|
my ( $self ) = @_;
|
|
my $data = $self->SUPER::exportAssetData;
|
|
if ( $self->get('storageIdExample') ) {
|
|
push @{$data->{storage}}, $self->get('storageIdExample');
|
|
}
|
|
return $data;
|
|
};
|
|
|
|
#-------------------------------------------------------------------
|
|
|
|
=head2 getAttachments ( [type] )
|
|
|
|
Returns an arrayref of hashrefs representing all attachments for this template
|
|
of the specified type (link, bodyScript, headScript).
|
|
|
|
=head3 type
|
|
|
|
If defined, will limit the attachments to this type; e.g., passing
|
|
'stylesheet' will return only stylesheets.
|
|
|
|
=cut
|
|
|
|
sub getAttachments {
|
|
my ( $self, $type ) = @_;
|
|
|
|
return [] if !$self->get('attachmentsJson');
|
|
|
|
my $attachments = JSON->new->decode( $self->get('attachmentsJson') );
|
|
|
|
# We want it all and we want it now
|
|
if ( !$type ) {
|
|
return $attachments;
|
|
}
|
|
|
|
my $output = [];
|
|
for my $attach ( @{$attachments} ) {
|
|
if ( $attach->{type} eq $type ) {
|
|
push @{$output}, $attach;
|
|
}
|
|
}
|
|
|
|
return $output;
|
|
}
|
|
|
|
#-------------------------------------------------------------------
|
|
|
|
=head2 getEditForm ( )
|
|
|
|
Returns the WebGUI::FormBuilder object that will be used in generating the edit page for this asset.
|
|
|
|
=cut
|
|
|
|
override getEditForm => sub {
|
|
my $self = shift;
|
|
my $tabform = super();
|
|
my $i18n = WebGUI::International->new($self->session, 'Asset_Template');
|
|
$tabform->addField( "hidden",
|
|
name=>"returnUrl",
|
|
value=>$self->session->form->get("returnUrl")
|
|
);
|
|
if ($self->namespace eq "") {
|
|
my $namespaces = $self->session->dbSlave->buildHashRef("select distinct(namespace) from template order by namespace");
|
|
$tabform->getTab("properties")->addField( "combo",
|
|
name=>"namespace",
|
|
options=>$namespaces,
|
|
label=>$i18n->get('namespace'),
|
|
hoverHelp=>$i18n->get('namespace description'),
|
|
value=>[$self->session->form->get("namespace")]
|
|
);
|
|
} else {
|
|
$tabform->getTab("meta")->addField( "ReadOnly",
|
|
name=>"namespace",
|
|
label=>$i18n->get('namespace'),
|
|
hoverHelp=>$i18n->get('namespace description'),
|
|
value=>$self->namespace
|
|
);
|
|
}
|
|
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->parser];
|
|
$value = \[$self->session->config->get("defaultTemplateParser")] if(!$self->parser);
|
|
$tabform->getTab("properties")->addField( "SelectBox",
|
|
name=>"parser",
|
|
options=>\%parsers,
|
|
value=>$value,
|
|
label=>$i18n->get('parser'),
|
|
hoverHelp=>$i18n->get('parser description'),
|
|
);
|
|
}
|
|
|
|
$tabform->getTab('properties')->addField( "jsonTable",
|
|
name => 'attachmentsJson',
|
|
value => $self->get('attachmentsJson'),
|
|
label => $i18n->get("attachment display label"),
|
|
fields => [
|
|
{
|
|
type => "text",
|
|
name => "url",
|
|
label => $i18n->get('attachment header url'),
|
|
size => '48',
|
|
},
|
|
{
|
|
type => "select",
|
|
name => "type",
|
|
label => $i18n->get('attachment header type'),
|
|
options => [
|
|
stylesheet => $i18n->get('css label'),
|
|
headScript => $i18n->get('js head label'),
|
|
bodyScript => $i18n->get('js body label'),
|
|
],
|
|
},
|
|
],
|
|
);
|
|
|
|
$tabform->getTab('properties')->addField( image =>
|
|
name => 'storageIdExample',
|
|
value => $self->storageIdExample,
|
|
label => $i18n->get('field storageIdExample'),
|
|
hoverHelp => $i18n->get('field storageIdExample description'),
|
|
);
|
|
|
|
return $tabform;
|
|
};
|
|
|
|
#-------------------------------------------------------------------
|
|
|
|
=head2 getExampleImageUrl ( )
|
|
|
|
Get the URL to the example image of this template, if any
|
|
|
|
=cut
|
|
|
|
sub getExampleImageUrl {
|
|
my ( $self ) = @_;
|
|
if ( my $storageId = $self->get('storageIdExample') ) {
|
|
my $storage = WebGUI::Storage->get( $self->session, $storageId );
|
|
return $storage->getUrl( $storage->getFiles->[0] );
|
|
}
|
|
return;
|
|
}
|
|
|
|
#-------------------------------------------------------------------
|
|
|
|
=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';
|
|
TEMPLATE: while (my ($id, $version) = $sth->array) {
|
|
my $template = eval { WebGUI::Asset::Template->newById($session,$id,$version); };
|
|
next TEMPLATE if Exception::Class->caught();
|
|
$templates{$id} = $template->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;
|
|
|
|
# If parser is not in the config, throw an error message
|
|
if ( $parser && $parser ne $session->config->get('defaultTemplateParser')
|
|
&& !any { $_ eq $parser } @{$session->config->get('templateParsers')} ) {
|
|
WebGUI::Error::NotInConfig->throw(
|
|
error => "Attempted to load template parser '$parser' that is not in config file",
|
|
module => $parser,
|
|
configKey => 'templateParsers',
|
|
);
|
|
}
|
|
else {
|
|
$parser ||= $session->config->get("defaultTemplateParser") || "WebGUI::Asset::Template::HTMLTemplate";
|
|
}
|
|
|
|
WebGUI::Pluggable::load( $parser );
|
|
return $parser->new($session);
|
|
}
|
|
|
|
#-------------------------------------------------------------------
|
|
|
|
=head2 importAssetCollateralData ( data )
|
|
|
|
Override to import attachments from old versions of WebGUI
|
|
|
|
=cut
|
|
|
|
override importAssetCollateralData => sub {
|
|
my ( $self, $data, @args ) = @_;
|
|
if ( $data->{template_attachments} ) {
|
|
$self->update( { attachmentsJson => JSON::to_json($data->{template_attachments}) } );
|
|
}
|
|
return super();
|
|
};
|
|
|
|
#-------------------------------------------------------------------
|
|
|
|
=head2 indexContent ( )
|
|
|
|
Making private. See WebGUI::Asset::indexContent() for additonal details.
|
|
|
|
=cut
|
|
|
|
around indexContent => sub {
|
|
my $orig = shift;
|
|
my $self = shift;
|
|
my $indexer = $self->$orig(@_);
|
|
$indexer->addKeywords($self->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 $sent = $self->session->stow->get('templateHeadersSent');
|
|
unless ($sent) {
|
|
$self->session->stow->set('templateHeadersSent', $sent = []);
|
|
}
|
|
|
|
my $id = $self->getId;
|
|
# don't send head block if we've already sent it for this template
|
|
return if $id ~~ $sent;
|
|
|
|
my $session = $self->session;
|
|
my ($db, $style) = $session->quick(qw(db style));
|
|
my $parser = $self->getParser($session, $self->parser);
|
|
my $headBlock = $parser->process($self->getExtraHeadTags, $vars);
|
|
|
|
$style->setRawHeadTags($headBlock);
|
|
|
|
foreach my $sheet ( @{ $self->getAttachments('stylesheet') } ) {
|
|
my %props = ( type => 'text/css', rel => 'stylesheet' );
|
|
$style->setLink($sheet->{url}, \%props);
|
|
}
|
|
|
|
my $doScripts = sub {
|
|
my ($type, $body) = @_;
|
|
foreach my $script ( @{ $self->getAttachments($type) } ) {
|
|
my %props = ( type => 'text/javascript' );
|
|
$style->setScript($script->{url}, \%props, $body);
|
|
}
|
|
};
|
|
|
|
$doScripts->('headScript');
|
|
$doScripts->('bodyScript', 1);
|
|
|
|
push(@$sent, $id);
|
|
}
|
|
|
|
|
|
#-------------------------------------------------------------------
|
|
|
|
=head2 process ( vars )
|
|
|
|
Evaluate a template replacing template commands for HTML. If the internal property templatePacked
|
|
is set to true, the packed, minimized template will be used. Otherwise, the original template
|
|
will be used.
|
|
|
|
Will also process the style template attached to this template
|
|
|
|
=head3 vars
|
|
|
|
A hash reference containing template variables and loops. Automatically includes the entire WebGUI session.
|
|
|
|
=cut
|
|
|
|
sub process {
|
|
my $self = shift;
|
|
my $vars = shift;
|
|
my $session = $self->session;
|
|
|
|
if ($self->state =~ /^trash/) {
|
|
my $i18n = WebGUI::International->new($session, 'Asset_Template');
|
|
$session->log->warn('process called on template in trash: '.$self->getId
|
|
.'. The template was called through this url: '.$session->asset->url);
|
|
return $session->isAdminOn ? $i18n->get('template in trash') : '';
|
|
}
|
|
elsif ($self->state =~ /^clipboard/) {
|
|
my $i18n = WebGUI::International->new($session, 'Asset_Template');
|
|
$session->log->warn('process called on template in clipboard: '.$self->getId
|
|
.'. The template was called through this url: '.$session->asset->url);
|
|
return $session->isAdminOn ? $i18n->get('template in clipboard') : '';
|
|
}
|
|
|
|
# Merge the passed-in vars with the prepared vars
|
|
if ( keys %$vars > 0 ) { # can't call setParam with an empty hash
|
|
$self->setParam( %$vars );
|
|
}
|
|
|
|
# Return a JSONinfied version of vars if JSON is the only requested content type.
|
|
if ( defined $session->request && $session->request->header('Accept') eq 'application/json' ) {
|
|
$session->response->content_type( 'application/json' );
|
|
return to_json( $self->param );
|
|
}
|
|
|
|
$self->prepare unless ($self->{_prepared});
|
|
my $parser = $self->getParser($session, $self->parser);
|
|
my $template = $self->usePacked
|
|
? $self->templatePacked
|
|
: $self->template
|
|
;
|
|
my $output;
|
|
eval { $output = $parser->process($template, $self->param); };
|
|
if (my $e = Exception::Class->caught) {
|
|
$session->log->error(sprintf "Error processing template: %s, %s, %s", $self->getUrl, $self->getId, $e->error);
|
|
my $i18n = WebGUI::International->new($session, 'Asset_Template');
|
|
$output = sprintf $i18n->get('template error').$e->error, $self->getUrl, $self->getId;
|
|
}
|
|
|
|
# Process the style template
|
|
if ( $self->style ) {
|
|
$output = $self->session->style->process( $output, $self->style );
|
|
}
|
|
|
|
return $output;
|
|
}
|
|
|
|
|
|
#-------------------------------------------------------------------
|
|
|
|
=head2 processEditForm
|
|
|
|
Extends the master class to handle template parsers, namespaces and template attachments.
|
|
|
|
=cut
|
|
|
|
override processEditForm => sub {
|
|
my $self = shift;
|
|
super();
|
|
my $session = $self->session;
|
|
# TODO: Perhaps add a way to check template syntax before it blows stuff up?
|
|
my %data;
|
|
my $needsUpdate = 0;
|
|
if ($self->parser ne $self->session->form->process("parser","className") && ($self->session->form->process("parser","className") ne "")) {
|
|
$needsUpdate = 1;
|
|
if ($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") );
|
|
}
|
|
}
|
|
if ($self->session->form->process("namespace") eq 'style') {
|
|
$needsUpdate = 1;
|
|
$data{extraHeadTags} = '';
|
|
}
|
|
|
|
if ($needsUpdate) {
|
|
$self->update(\%data);
|
|
}
|
|
|
|
### Template attachments
|
|
$self->update({ attachmentsJson => $session->form->process( 'attachmentsJson', 'JsonTable' ), });
|
|
|
|
return;
|
|
};
|
|
|
|
#-------------------------------------------------------------------
|
|
|
|
=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 to add to the existing params.
|
|
|
|
=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);
|
|
}
|
|
|
|
#-------------------------------------------------------------------
|
|
|
|
=head2 purge ( )
|
|
|
|
Extend the base method to handle purging the User Function Style template and destroying your site.
|
|
If the current template is the User Function Style template with the Fail Safe template.
|
|
|
|
=cut
|
|
|
|
around purge => sub {
|
|
my $orig = shift;
|
|
my $self = shift;
|
|
my $session = $self->session;
|
|
my $assetId = $self->assetId;
|
|
my $returnValue = $self->$orig(@_);
|
|
if ($returnValue && $assetId eq $session->setting->get('userFunctionStyleId')) {
|
|
$session->setting->set('userFunctionStyleId', 'PBtmpl0000000000000060');
|
|
}
|
|
return $returnValue;
|
|
};
|
|
|
|
#-------------------------------------------------------------------
|
|
|
|
=head2 removeAttachments ( urls )
|
|
|
|
Removes attachments.
|
|
|
|
=head3 urls
|
|
|
|
C<urls> is an arrayref of URLs to remove. If C<urls>
|
|
is not defined, will remove all attachments for this revision.
|
|
|
|
=cut
|
|
|
|
sub removeAttachments {
|
|
my ($self, $urls) = @_;
|
|
|
|
my @attachments = ();
|
|
|
|
if ($urls) {
|
|
@attachments = grep { ! ($_->{url} ~~ $urls) } @{ $self->getAttachments() };
|
|
}
|
|
|
|
my $json = JSON->new->encode( \@attachments );
|
|
$self->update({ attachmentsJson => $json, });
|
|
}
|
|
|
|
#----------------------------------------------------------------------------
|
|
|
|
=head2 replaceParamName ( oldName, newName )
|
|
|
|
Replace all instances of oldName with newName. Updates the template instance with
|
|
the new names and returns the new template data. This is only to be used to alter
|
|
the names of template parameters.
|
|
|
|
=cut
|
|
|
|
sub replaceParamName {
|
|
my ( $self, $oldName, $newName ) = @_;
|
|
|
|
# We're lazy here. If this fails, we'll add more checks, or call out to the parser
|
|
my $template = $self->template;
|
|
$template =~ s/$oldName/$newName/g;
|
|
$self->template( $template );
|
|
return $template;
|
|
}
|
|
|
|
#-------------------------------------------------------------------
|
|
|
|
=head2 www_edit
|
|
|
|
Hand draw this form so that a warning can be displayed to the user when editing a
|
|
default template.
|
|
|
|
=cut
|
|
|
|
override www_edit => sub {
|
|
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 $template = super();
|
|
|
|
# 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" ) );
|
|
}
|
|
}
|
|
|
|
my $errors = $template->getParam('errors') || [];
|
|
my $message .= q{<p>}
|
|
. $i18n->get( "warning default template" )
|
|
. q{</p><p>}
|
|
. sprintf( q{<a href="} . $duplicateUrl . q{">%s</a>}, $i18n->get( "make duplicate label" ) )
|
|
. q{</p>}
|
|
;
|
|
push @$errors, $message;
|
|
$template->setParam( 'errors' => $errors );
|
|
}
|
|
|
|
return $template;
|
|
};
|
|
|
|
#-------------------------------------------------------------------
|
|
|
|
=head2 www_goBackToPage
|
|
|
|
If set, redirect the user to the URL set by the form variable C<returnUrl>. Otherwise, it returns
|
|
the user back to the site.
|
|
|
|
=cut
|
|
|
|
sub www_goBackToPage {
|
|
my $self = shift;
|
|
$self->session->response->setRedirect($self->session->form->get("returnUrl")) if ($self->session->form->get("returnUrl"));
|
|
return undef;
|
|
}
|
|
|
|
#----------------------------------------------------------------------------
|
|
|
|
=head2 www_editDuplicate
|
|
|
|
Make a duplicate of this template and edit that instead.
|
|
|
|
=cut
|
|
|
|
sub www_editDuplicate {
|
|
my $self = shift;
|
|
return $self->session->privilege->insufficient() unless $self->canEdit;
|
|
|
|
my $session = $self->session;
|
|
my $form = $self->session->form;
|
|
|
|
my $newTemplate = $self->duplicate;
|
|
$newTemplate->update( {
|
|
isDefault => 0,
|
|
title => $self->get( "title" ) . " (copy)",
|
|
menuTitle => $self->get( "menuTitle" ) . " (copy)",
|
|
} );
|
|
|
|
# Make the asset that originally invoked edit template use the newly created asset.
|
|
if ( $self->session->form->get( "proceed" ) eq "goBackToPage" ) {
|
|
if ( my $asset = WebGUI::Asset->newByUrl( $session, $form->get( "returnUrl" ) ) ) {
|
|
# Find which property we should set by comparing namespaces and current values
|
|
DEF: for my $def ( @{ $asset->definition( $self->session ) } ) {
|
|
my $properties = $def->{ properties };
|
|
PROP: for my $prop ( keys %{ $properties } ) {
|
|
next PROP unless lc $properties->{ $prop }->{ fieldType } eq "template";
|
|
next PROP unless $asset->get( $prop ) eq $self->getId;
|
|
if ( $properties->{ $prop }->{ namespace } eq $self->get( "namespace" ) ) {
|
|
my $tag = WebGUI::VersionTag->getWorking( $session );
|
|
$asset->addRevision( { $prop => $newTemplate->getId, tagId => $tag->getId, status => "pending" } );
|
|
$asset->setVersionLock;
|
|
|
|
# Auto-commit our revision if necessary
|
|
# TODO: This needs to be handled automatically somehow...
|
|
my $status = WebGUI::VersionTag->autoCommitWorkingIfEnabled($self->session);
|
|
##get a fresh object from the database
|
|
if ($status eq 'commit') {
|
|
$newTemplate = $newTemplate->cloneFromDb;
|
|
}
|
|
last DEF;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
return $newTemplate->www_edit;
|
|
}
|
|
|
|
#-------------------------------------------------------------------
|
|
|
|
=head2 www_manage
|
|
|
|
If trying to use the assetManager on this asset, push them back to managing the
|
|
template's parent instead.
|
|
|
|
=cut
|
|
|
|
sub www_manage {
|
|
my $self = shift;
|
|
#takes the user to the folder containing this template.
|
|
return $self->getParent->www_manageAssets;
|
|
}
|
|
|
|
#-------------------------------------------------------------------
|
|
|
|
=head2 www_view
|
|
|
|
Override the default behavior. When a template is viewed, it redirects you
|
|
to viewing the template's container instead.
|
|
|
|
=cut
|
|
|
|
sub www_view {
|
|
my $self = shift;
|
|
return $self->session->asset($self->getContainer)->www_view;
|
|
}
|
|
|
|
|
|
__PACKAGE__->meta->make_immutable;
|
|
|
|
1;
|