@Ghazascanner
_2019runbot
Ghazascanner File Manager
server :Linux phosweb008 3.10.0-1160.el7.x86_64 #1 SMP Mon Oct 19 16:18:59 UTC 2020 x86_64
Current Path :
/
homepage
/
v-mt
/
lib
/
MT
/
Path :
Upload File :
New :
File
Dir
//homepage/v-mt/lib/MT/Template.pm
# Movable Type (r) (C) 2001-2008 Six Apart, Ltd. All Rights Reserved. # This code cannot be redistributed without permission from www.sixapart.com. # For more information, consult your Movable Type license. # # $Id: Template.pm 1191 2008-01-10 23:34:17Z mpaschal $ package MT::Template; use strict; use base qw( MT::Object ); use constant NODE => 'MT::Template::Node'; use constant NODE_TEXT => 1; use constant NODE_BLOCK => 2; use constant NODE_FUNCTION => 3; my $resync_to_db; __PACKAGE__->install_properties({ column_defs => { 'id' => 'integer not null auto_increment', 'blog_id' => 'integer not null', 'name' => 'string(255) not null', 'type' => 'string(25) not null', 'outfile' => 'string(255)', 'text' => 'text', 'linked_file' => 'string(255)', 'linked_file_mtime' => 'string(10)', 'linked_file_size' => 'integer', 'rebuild_me' => 'boolean', 'build_dynamic' => 'boolean', 'identifier' => 'string(50)', }, indexes => { blog_id => 1, name => 1, type => 1, build_dynamic => 1, outfile => 1, identifier => 1, }, defaults => { 'rebuild_me' => 1, 'build_dynamic' => 0, }, meta => 1, child_of => 'MT::Blog', child_classes => [ 'MT::TemplateMap', 'MT::FileInfo' ], audit => 1, datasource => 'template', primary_key => 'id', }); __PACKAGE__->install_meta({ columns => ['last_rebuild_time', 'page_layout'], }); __PACKAGE__->add_trigger('pre_remove' => \&pre_remove_children); use MT::Builder; use MT::Blog; use File::Spec; sub class_label { MT->translate("Template"); } sub class_label_plural { MT->translate("Templates"); } sub new { my $pkg = shift; my (%param) = @_; if (my $type = delete $param{type}) { if ($type eq 'filename') { return $pkg->new_file($param{source}, %param); } elsif ($type eq 'scalarref') { return $pkg->new_string($param{source}, %param); } } my $tmpl = $pkg->SUPER::new(@_); $tmpl->{include_path} = $param{path}; $tmpl->{include_filter} = $param{filter}; return $tmpl; } sub new_file { my $pkg = shift; my ($file, %param) = @_; my $tmpl = $pkg->new; $tmpl->{include_path} = $param{path}; $tmpl->{include_filter} = $param{filter}; my $contents = $tmpl->load_file($file); if (defined $contents) { if ($tmpl->{include_filter}) { $tmpl->{include_filter}->(\$contents, $file); } $tmpl->text($contents); return $tmpl; } return; # load_file errror; } sub new_string { my $pkg = shift; my ($str, %param) = @_; my $tmpl = $pkg->new; $tmpl->{include_path} = $param{path}; $tmpl->{include_filter} = $param{filter}; if (ref($str) && defined($$str)) { if ($tmpl->{include_filter}) { $tmpl->{include_filter}->($str); } $tmpl->text($$str); } return $tmpl; } sub load_file { my $tmpl = shift; my ($file) = @_; unless (File::Spec->file_name_is_absolute($file)) { my @paths = @{ $tmpl->{include_path} || [] }; foreach my $path (@paths) { my $test_file = File::Spec->catfile($path, $file); $file = $test_file, last if -f $test_file; } } return $tmpl->trans_error(Carp::longmess("File not found: [_1]"), $file) unless -e $file; local *FH; open FH, $file or return $tmpl->trans_error("Error reading file '[_1]': [_2]", $file, $!); my $c; do { local $/; $c = <FH> }; close FH; return $c; } sub context { my $tmpl = shift; return $tmpl->{context} = shift if @_; require MT::Template::Context; my $ctx = $tmpl->{context} ||= MT::Template::Context->new; $ctx->stash('template', $tmpl); return $ctx; } sub param { my $tmpl = shift; my $ctx = $tmpl->context; if (@_ == 1) { if (ref($_[0]) eq 'HASH') { $ctx->var($_, $_[0]->{$_}) for keys %{ $_[0] }; } else { return $ctx->var($_[0]); } } elsif (@_ == 2) { $ctx->var($_[0], $_[1]); } else { return $ctx->{__stash}{vars}; } } sub clear_params { my $tmpl = shift; my $ctx = $tmpl->context; %{$ctx->{__stash}{vars}} = (); } sub reflow { my $tmpl = shift; my ($tokens) = @_; $tokens ||= $tmpl->tokens; # reconstitute text of template based on tokens my $str = ''; foreach my $token (@$tokens) { if ($token->[0] eq 'TEXT') { $str .= $token->[1]; } else { my $tag = $token->[0]; $str .= '<mt' . $tag; if (my $attrs = $token->[4]) { my $attrh = $token->[1]; foreach my $a (@$attrs) { delete $attrh->{$a->[0]}; my $v = $a->[1]; $v = $v =~ m/"/ ? qq{'$v'} : qq{"$v"}; $str .= ' ' . $a->[0] . '=' . $v; } foreach my $a (keys %$attrh) { my $v = $attrh->{$a}; $v = $v =~ m/"/ ? qq{'$v'} : qq{"$v"}; $str .= ' ' . $a . '=' . $v; } } $str .= '>'; if ($token->[2]) { # container tag $str .= $tmpl->reflow( $token->[2] ); $str .= '</mt' . $tag . '>'; } } } return $str; } sub build { my $tmpl = shift; my($ctx, $cond) = @_; $ctx ||= $tmpl->context; local $ctx->{__stash}{template} = $tmpl; my $tokens = $tmpl->tokens or return; my $build = MT::Builder->new; if (my $blog_id = $tmpl->blog_id) { $ctx->stash('blog_id', $blog_id); my $blog = $ctx->stash('blog'); unless ($blog) { $blog = MT::Blog->load($blog_id) or return $tmpl->error(MT->translate( "Load of blog '[_1]' failed: [_2]", $blog_id, MT::Blog->errstr )); $ctx->stash('blog', $blog); } else { $ctx->stash('blog_id', $blog->id); } MT->config->TimeOffset($blog->server_offset); $ctx->var( 'page_layout', $blog->page_layout ) if $blog->page_layout; } $ctx->var( 'page_layout', $tmpl->page_layout ) if $tmpl->page_layout; if (my $layout = $ctx->var('page_layout')) { my $columns = { 'layout-wt' => 2, 'layout-tw' => 2, 'layout-wm' => 2, 'layout-mw' => 2, 'layout-wtt' => 3, 'layout-twt' => 3, }->{$layout}; $ctx->var( 'page_columns', $columns ) if $columns; } defined(my $res = $build->build($ctx, $tokens, $cond)) or return $tmpl->error(MT->translate( "Publish error in template '[_1]': [_2]", $tmpl->name || $tmpl->{__file}, $build->errstr)); $res =~ s/^\s*//; return $res; } sub output { my $tmpl = shift; my ($param) = @_; $tmpl->param($param) if $param; return $tmpl->build(); } sub save { my $tmpl = shift; my $existing = MT::Template->load({ name => $tmpl->name, blog_id => $tmpl->blog_id }); if ($existing && (!$tmpl->id || ($tmpl->id && ($existing->id ne $tmpl->id))) && ($existing->type eq $tmpl->type)) { return $tmpl->error(MT->translate('Template with the same name already exists in this blog.')); } if ($tmpl->linked_file) { $tmpl->_sync_to_disk($tmpl->SUPER::text) or return; } $tmpl->{needs_db_sync} = 0; if ((!$tmpl->id) && (my $blog = $tmpl->blog)) { my $dcty = $blog->custom_dynamic_templates; if ($dcty eq 'all') { if (('index' eq $tmpl->type) || ('archive' eq $tmpl->type) || ('individual' eq $tmpl->type) || ('page' eq $tmpl->type) || ('category' eq $tmpl->type)) { $tmpl->build_dynamic(1); } } elsif (($dcty eq 'archives') && ('archive' eq $tmpl->type)) { $tmpl->build_dynamic(1); } } $tmpl->SUPER::save; } sub blog { my $this = shift; return $this->{__blog} if $this->{__blog}; return $this->{__blog} = MT::Blog->load($this->blog_id); } sub set_values_internal { my $tmpl = shift; my ($cols) = @_; if (exists $cols->{text}) { # The text column of the MT::Template object can be associated # with a physical file. When loading the record data from the # database, we should observe whether or not it is in sync with # the physical file. This logic handles the case where the # record is loaded through the MT::ObjectDriver and should # not apply for any other use of $tmpl->set_values, since those # should all be explicitly setting the template text. my @info = caller(); if ($info[0] =~ m/^MT::ObjectDriver::/) { if ($cols->{linked_file}) { my %local_cols = %$cols; delete $local_cols{text}; $tmpl->SUPER::set_values_internal(\%local_cols); my $sync_text = $tmpl->text(); if (!defined $sync_text) { $tmpl->text($cols->{text}); } return; } } } $tmpl->SUPER::set_values_internal(@_); } sub text { my $tmpl = shift; my $text; if ($tmpl->{reflow_flag}) { $tmpl->{reflow_flag} = 0; $text = $tmpl->reflow(); } $text = $tmpl->SUPER::text(@_); $tmpl->{needs_db_sync} = 0; unless (@_) { if ($tmpl->linked_file) { if (my $res = $tmpl->_sync_from_disk) { $text = $res; $tmpl->SUPER::text($text); ## We used to save the template here; now we don't, because ## it causes deadlock (the DB is locked from loading the ## template, so saving would try to write-lock it). if (!defined $resync_to_db) { $resync_to_db = {}; MT->add_callback('TakeDown', 9, undef, \&_resync_to_db); } $resync_to_db->{$tmpl->id} = $tmpl; $tmpl->{needs_db_sync} = 1; } } $tmpl->reset_tokens; } $text; } sub _resync_to_db { return unless defined $resync_to_db; return unless %$resync_to_db; foreach my $tmpl_id (keys %$resync_to_db) { my $tmpl = $resync_to_db->{$tmpl_id}; next unless $tmpl->{needs_db_sync}; $tmpl->save; } $resync_to_db = {}; } sub _sync_from_disk { my $tmpl = shift; my $lfile = $tmpl->linked_file; unless (File::Spec->file_name_is_absolute($lfile)) { if ($tmpl->blog_id) { my $blog = MT::Blog->load($tmpl->blog_id); $lfile = File::Spec->catfile($blog->site_path, $lfile); } else { # use MT path to base relative paths $lfile = File::Spec->catfile(MT->instance->server_path, $lfile); } } return unless -e $lfile; my($size, $mtime) = (stat _)[7,9]; return if $size == $tmpl->linked_file_size && $mtime == $tmpl->linked_file_mtime; local *FH; open FH, $lfile or return; my $c; do { local $/; $c = <FH> }; close FH; $tmpl->linked_file_size($size); $tmpl->linked_file_mtime($mtime); $c; } sub _sync_to_disk { my $tmpl = shift; my($text) = @_; my $lfile = $tmpl->linked_file; my $cfg = MT->config; if ($cfg->SafeMode) { ## Check for a set of extensions that aren't allowed. for my $ext (qw( pl pm cgi cfg )) { if ($lfile =~ /\.$ext$/i) { return $tmpl->error(MT->translate( "You cannot use a [_1] extension for a linked file.", ".$ext")); } } } unless (File::Spec->file_name_is_absolute($lfile)) { if ($tmpl->blog_id) { my $blog = MT::Blog->load($tmpl->blog_id); $lfile = File::Spec->catfile($blog->site_path, $lfile); } else { $lfile = File::Spec->catfile(MT->instance->server_path, $lfile); } } local *FH; ## If the linked file already exists, and there is no template text ## (empty textarea, etc.), then we read the template text from the ## linked file, assuming that it should not be overwritten. If the ## file does not already exist, or if there is template text, assume ## that we should update the linked file. if (-e $lfile && !$tmpl->SUPER::text) { open FH, $lfile or return; do { local $/; $tmpl->SUPER::text(<FH>) }; close FH; } else { my $umask = oct $cfg->HTMLUmask; my $old = umask($umask); ## Untaint. We assume that the user knows what he/she is doing, ## and allow anything. ($lfile) = $lfile =~ /(.+)/s; open FH, ">$lfile" or return $tmpl->error(MT->translate( "Opening linked file '[_1]' failed: [_2]", $lfile, "$!" )); print FH $text; close FH; umask($old); } my($size, $mtime) = (stat $lfile)[7,9]; $tmpl->linked_file_size($size); $tmpl->linked_file_mtime($mtime); 1; } sub rescan { my $tmpl = shift; my ($tokens) = @_; unless ($tokens) { # top of tree; reset $tmpl->{__ids} = {}; $tmpl->{__classes} = {}; # Use tokens if we already have them, otherwise compile $tokens = $tmpl->{__tokens} || $tmpl->compile; } return unless $tokens; foreach my $t (@$tokens) { if ($t->[0] ne 'TEXT') { if ($t->[1]->{id}) { my $ids = $tmpl->{__ids} ||= {}; $ids->{lc $t->[1]->{id}} = $t; } elsif ($t->[1]->{class}) { my $classes = $tmpl->{__classes} ||= {}; push @{ $classes->{lc $t->[1]->{class}} ||= [] }, $t; } $tmpl->rescan($t->[2]) if $t->[2]; } } } sub compile { my $tmpl = shift; require MT::Builder; my $b = new MT::Builder; $b->compile($tmpl) or return $tmpl->error($b->errstr); return $tmpl->{__tokens}; } sub errors { my $tmpl = shift; $tmpl->{errors} = shift if @_; $tmpl->{errors}; } sub reset_tokens { my $tmpl = shift; $tmpl->{__tokens} = undef; $tmpl->{__classes} = undef; $tmpl->{__ids} = undef; } sub reset_ids { my $tmpl = shift; $tmpl->{__ids} = undef; } sub reset_classes { my $tmpl = shift; $tmpl->{__classes} = undef; } sub reset_markers { my $tmpl = shift; $tmpl->{__classes} = undef; $tmpl->{__ids} = undef; } sub token_ids { my $tmpl = shift; if (@_) { return $tmpl->{__ids} = shift; } $tmpl->rescan unless $tmpl->{__ids}; return $tmpl->{__ids}; } sub token_classes { my $tmpl = shift; if (@_) { return $tmpl->{__classes} = shift; } $tmpl->rescan unless $tmpl->{__classes}; return $tmpl->{__classes}; } sub tokens { my $tmpl = shift; if (@_) { return bless $tmpl->{__tokens} = shift, 'MT::Template::Tokens'; } my $t = $tmpl->{__tokens} || $tmpl->compile; return bless $t, 'MT::Template::Tokens' if $t; return undef; } sub published_url { my $tmpl = shift; return undef unless $tmpl->outfile; return undef unless ($tmpl->type eq 'index'); my $blog = $tmpl->blog; return undef unless $blog; my $site_url = $blog->site_url || ''; $site_url .= '/' if $site_url !~ m!/$!; my $url = $site_url . $tmpl->outfile; if ($tmpl->build_dynamic) { require MT::FileInfo; my @finfos = MT::FileInfo->load({blog_id => $tmpl->blog_id, template_id => $tmpl->id}); if (scalar @finfos == 1) { return $url; } } else { my $site_path = $blog->site_path || ''; my $tmpl_path = File::Spec->catfile($site_path, $tmpl->outfile); if (-f $tmpl_path) { return $url; } } undef; } sub pre_remove_children { my $tmpl = shift; $tmpl->remove_children({ key => 'template_id' }); } # Some DOM-inspired methods (replicating the interface, so it's more # familiar to those who know DOM) sub getElementsByTagName { my $tmpl = shift; return MT::Template::Tokens::getElementsByTagName($tmpl->tokens, @_); } sub getElementsByClassName { my $tmpl = shift; my ($name) = @_; my $classes = $tmpl->token_classes; my $tokens = $classes->{lc $name}; if ($tokens && @$tokens) { #@$tokens = map { bless $_, NODE } @$tokens; return @$tokens; } return (); } sub getElementsByName { my $tmpl = shift; return MT::Template::Tokens::getElementsByName($tmpl->tokens, @_); } sub getElementById { my $tmpl = shift; my ($id) = @_; if (my $node = $tmpl->token_ids->{$id}) { return bless $node, NODE; } undef; } sub createElement { my $tmpl = shift; my ($tag, $attr) = @_; return bless [ $tag, $attr, undef, undef, undef, undef, $tmpl ], NODE; } sub createTextNode { my $tmpl = shift; my ($text) = @_; return bless [ 'TEXT', $text, undef, undef, undef, undef, $tmpl ], NODE; } sub insertAfter { my $tmpl = shift; my ($node1, $node2) = @_; my $parent_node = $node2 ? $node2->parentNode : $tmpl; my $parent_array = $parent_node->childNodes; if ( $node2 ) { for (my $i = 0; $i < scalar @$parent_array; $i++) { if ($parent_array->[$i] == $node2) { $node1->parentNode($parent_node); splice(@$parent_array, $i + 1, 0, $node1); return 1; } } return 0; } else { $node1->parentNode($parent_node); push @$parent_array, $node1; return 1; } return 0; } sub insertBefore { my $tmpl = shift; my ($node1, $node2) = @_; my $parent_node = $node2 ? $node2->parentNode : $tmpl; my $parent_array = $parent_node->childNodes; if ( $node2 ) { for (my $i = 0; $i < scalar @$parent_array; $i++) { if ($parent_array->[$i] == $node2) { $node1->parentNode($parent_node); splice(@$parent_array, $i, 0, $node1); return 1; } } return 0; } else { $node1->parentNode($parent_node); unshift @$parent_array, $node1; return 1; } return 0; } sub childNodes { my $tmpl = shift; return $tmpl->tokens; } sub hasChildNodes { my $tmpl = shift; my $nodes = $tmpl->childNodes; return $nodes && (@$nodes) ? 1 : 0; } sub appendChild { my $tmpl = shift; my ($new_node) = @_; my $nodes = $tmpl->childNodes; push @$nodes, $new_node; $tmpl->{reflow_flag} = 1; } # Alias to perl_function_names for those that may prefer that. # *get_elements_by_tag_name = \&getElementsByTagName; # *get_elements_by_name = \&getElementsByName; # *get_element_by_id = \&getElementById; # *create_element = \&createElement; # functionality for individual nodes gathered by DOM-like query operations. package MT::Template::Tokens; use strict; use constant NODE_TEXT => 1; use constant NODE_BLOCK => 2; use constant NODE_FUNCTION => 3; sub getElementsByTagName { my ($tokens, $name) = @_; my @list; $name = lc $name; foreach my $t (@$tokens) { if (lc $t->[0] eq $name) { push @list, $t; } if ($t->[2]) { my $subt = getElementsByTagName($t->[2], $name); push @list, @$subt if $subt; } } scalar @list ? \@list : undef; } sub getElementsByName { my ($tokens, $name) = @_; my @list; $name = lc $name; foreach my $t (@$tokens) { if ((ref($t->[1]) eq 'HASH') && (lc ($t->[1]{'name'} || '') eq $name)) { push @list, $t; } if ($t->[2]) { my $subt = getElementsByName($t->[2], $name); push @list, @$subt if $subt; } } scalar @list ? \@list : undef; } package MT::Template::Node; use strict; sub setAttribute { my $node = shift; my ($attr, $val) = @_; if ($attr eq 'id') { # assign into ids my $tmpl = $node->template; my $ids = $tmpl->token_ids; my $old_id = $node->getAttribute("id"); if ($old_id && $ids) { delete $ids->{$old_id}; } } elsif ($attr eq 'class') { # assign into classes my $tmpl = $node->template; my $classes = $tmpl->token_classes; my $old_class = $node->getAttribute("class"); if ($old_class && $classes->{$old_class}) { @{$classes->{$old_class}} = grep { $_ != $node } @{$classes->{$old_class}}; } push @{$classes->{$val} ||= []}, $node; } ($node->[1] ||= {})->{$attr} = $val; } sub template { my $node = shift; return $node->[6]; } sub getAttribute { my $node = shift; my ($attr) = @_; ($node->[1] || {})->{$attr}; } # sub attributes { # my $node = shift; # return $node->[1] ||= {}; # } sub nextSibling { my $node = shift; my $parent = $node->parentNode->childNodes; my $max = (scalar @$parent) - 1; return undef unless $max; my $last = $parent->[0]; foreach my $n ($parent->[1..$max]) { return $n if $node == $last; $last = $n; } return $parent->[$max] if $node == $last; return undef; } sub lastChild { my $node = shift; my $children = $node->childNodes or return undef; @$children ? $children->[scalar @$children - 1] : undef; } sub firstChild { my $node = shift; my $children = $node->[2] or return undef; @$children ? $children->[0] : undef; } sub previousSibling { my $node = shift; my $parent = $node->parentNode->childNodes; my $last; foreach my $n (@$parent) { return $last if $node == $n; $last = $n; } return undef; } sub parentNode { my $node = shift; $node->[5] = shift if @_; $node->[5]; } sub childNodes { my $node = shift; $node->[2] = shift if @_; $node->[2]; } sub ownerDocument { #template my $node = shift; return $node->template; } sub hasChildNodes { my $node = shift; $node->[2] && (@{$node->[2]}) ? 1 : 0; } sub nodeType { my $node = shift; if ($node->[0] eq 'TEXT') { return NODE_TEXT(); } elsif (defined $node->[2]) { return NODE_BLOCK(); } else { return NODE_FUNCTION(); } } sub nodeName { my $node = shift; if ($node->[0] eq 'TEXT') { return undef; } # normalize: # MTEntry => mt:entry # MTAPP:WIDGET => mtapp:widget my $tag = lc $node->[0]; if (($tag !~ m/:/) && ($tag =~ m/^mt/)) { $tag =~ s/^mt/mt:/; } return $tag; } # Returns text of a text node; inner text for a block tag, or undef # for a function tag. sub nodeValue { my $node = shift; if ($node->[0] eq 'TEXT') { return $node->[1]; } else { if (defined $node->[3]) { return $node->[3]; } } return undef; } sub innerHTML { my $node = shift; if (@_) { my ($text) = @_; $node->[3] = $text; my $builder = new MT::Builder; my $ctx = MT::Template::Context->new; $node->[2] = $builder->compile($ctx, $text); my $tmpl = $node->ownerDocument; if ($tmpl) { $tmpl->reset_markers; $tmpl->{reflow_flag} = 1; } } return $node->[3]; } # TBD: what about new nodes that are added with id elements? sub appendChild { my $node = shift; my ($new_node) = @_; my $nodes = $node->childNodes; push @$nodes, $new_node; my $tmpl = $node->ownerDocument; if ($tmpl) { $tmpl->{reflow_flag} = 1; } } sub removeChild { my $node = shift; } *inner_html = \&innerHTML; *append_child = \&appendChild; *insert_before = \&insertBefore; *remove_child = \&removeChild; # trans('Index') # trans('Archive') # trans('Category Archive') # trans('Individual') # trans('Page') # trans('Comment Listing') # trans('Ping Listing') # trans('Comment Preview') # trans('Comment Error') # trans('Comment Pending') # trans('Dynamic Error') # trans('Uploaded Image') # trans('Search Results') # trans('Module') # trans('Widget') 1; __END__ =head1 NAME MT::Template - Movable Type template record =head1 SYNOPSIS use MT::Template; my $tmpl = MT::Template->load($tmpl_id); defined(my $html = $tmpl->build($ctx)) or die $tmpl->errstr; $tmpl->name('New Template name'); $tmpl->save or die $tmpl->errstr; =head1 DESCRIPTION An I<MT::Template> object represents a template in the Movable Type system. It contains the actual template body, along with metadata used for keeping the template in sync with a linked file, etc. It also contains the functionality necessary to build an output file from a generic template. Linking a template to an external file means that any updates to the template through the Movable Type CMS will be synced automatically to the file on disk, and vice versa. This allows authors to edit their templates in an external editor that supports FTP, which is preferable for users who do not like editing in textareas. =head1 USAGE As a subclass of I<MT::Object>, I<MT::Template> inherits all of the data-management and -storage methods from that class; thus you should look at the I<MT::Object> documentation for details about creating a new object, loading an existing object, saving an object, etc. The following methods are unique to the I<MT::Template> interface: =head2 $tmpl->build($ctx [, \%cond ]) Given a context I<$ctx> (an I<MT::Template::Context> object) and an optional set of conditions \%cond, builds a template into its output form. The template is first parsed into a list of tokens, then is interpreted/executed to generate the final output. If specified, I<\%cond> should be a reference to a hash with MT tag names (without the leading C<MT>) as the keys, and boolean flags as the values--the flags specify whether the template interpreter should include any conditional containers found in the template body. Returns the output as a scalar string, C<undef> on error. Because the empty string C<''> and the value C<0> are both valid return values for this method, you should check specifically for C<undef>: defined(my $html = $tmpl->build($ctx)) or die $tmpl->errstr; =head2 $tmpl->published_url Only applicable if the template is an Index Template, this method returns the url for the page which is the result of building the index template. If the template is not of type index, or if the index template has not built yet (if the template is static), or if the index template does not have corresponding FileInfo record (if the template is dynamic), this method returns undef. =head2 $tmpl->blog Returns the I<MT::Blog> object associated with the template. =head2 $tmpl->save Saves the template and if linked to a physical file, updates the file. =head2 $tmpl->remove Removes the template object and any related objects in I<MT::TemplateMap> and I<MT::FileInfo>. =head2 $tmpl->set_values Updates the values of the C<$tmpl> object. When this is called through the I<MT::ObjectDriver> classes (upon loading a template object), and if the template is linked to a file, it will also load the contents of that file, setting the 'text' property. =head1 DATA ACCESS METHODS The I<MT::Template> object holds the following pieces of data. These fields can be accessed and set using the standard data access methods described in the I<MT::Object> documentation. =over 4 =item * id The numeric ID of the template. =item * blog_id The numeric ID of the blog to which this template belongs. =item * name The name of the template. This should be unique on a per-blog basis, because templates--particularly template modules, which are stored as regular templates--are included by name, using C<E<lt>MTIncludeE<gt>>. =item * type The type of the template. This can be any of the following values: C<index>, an Index Template; C<archive>, an Archive Template; C<category>, also an Archive Template; C<individual>, also an Archive Template; C<comments>, a Comment Listing Template; C<comment_preview>, a Comment Preview Template; C<comment_error>, a Comment Error Template; C<popup_image>, an Uploaded Image Popup Template; or C<custom>, a Template Module. =item * outfile The name/path of the output file of this template. This is only applicable if the template is an Index Template. =item * text The body of the template, containing the markup and Movable Type template tags. If the template is linked to an external file, the body of the template is automatically synced between this data field and the external file. =item * rebuild_me A boolean flag specifying whether or not the index template will be rebuilt automatically when rebuilding indexes, rebuilding all, or saving a new entry. =item * linked_file The name/path of the file to which this template is linked in the filesystem, if it is linked. =item * linked_file_mtime The last modified time of the linked file. This, along with I<linked_file_size>, is used to determine whether a file has been updated on disk, and needs to be re-synced. =item * linked_file_size The size of the linked file, in bytes. This, along with I<linked_file_mtime>, is used to determine whether a file has been updated on disk, and needs to be re-synced. =back =head1 DATA LOOKUP In addition to numeric ID lookup, you can look up or sort records by any combination of the following fields. See the I<load> documentation in I<MT::Object> for more information. =over 4 =item * blog_id =item * name =item * type =back =head1 NOTES =over 4 =item * When you remove a template using I<MT::Template::remove>, in addition to removing the template record, all of the I<MT::TemplateMap> objects associated with this template will be removed. =item * If a template is linked to an external file, I<MT::Template::save> will sync the template body to disk, and I<MT::Template::text> (the data access method to retrieve the body of the template) will sync the template body from disk. =back =head1 AUTHOR & COPYRIGHTS Please see the I<MT> manpage for author, copyright, and license information. =cut