Maypole-2.10.tar.gz

[maypole.git] / lib / Maypole / View / TT.pm

diff --git a/lib/Maypole/View/TT.pm b/lib/Maypole/View/TT.pm
index 3c2e05fef0f209fd4a772894f1f065890ff4a727..1a16a84ac7491734c1af9a0f886fe4a49174ddcf 100644 (file)
--- a/lib/Maypole/View/TT.pm
+++ b/lib/Maypole/View/TT.pm
@@ -1,82 +1,81 @@
 package Maypole::View::TT;
-use Apache::Constants;
-use Lingua::EN::Inflect;
+use base 'Maypole::View::Base';
+use Maypole::Constants;
 use Template;
-use File::Spec;
-use UNIVERSAL::moniker;
-use strict;
-
+use File::Spec::Functions qw(catdir tmpdir);
 
-sub new { bless {}, shift } # Not worth having
+use strict;
+our $VERSION = "1." . sprintf "%04d", q$Rev: 333 $ =~ /: (\d+)/;
 
-sub _tt {
-    my ($self, $r) = @_;
-    my $root = $r->{ar}->document_root . "/". $r->{ar}->location;
-    warn "Root was $root";
-    Template->new({ INCLUDE_PATH => [
-        $root,
-        ($r->model_class && File::Spec->catdir($root, $r->model_class->moniker)),
-        File::Spec->catdir($root, "custom"),
-        File::Spec->catdir($root, "factory")
-    ]});
-}
+sub template {
+    my ( $self, $r ) = @_;
 
-sub _args {
-    my ($self, $r) = @_;
-    my $class = $r->model_class;
-    my %args = (
-        request => $r,
-        objects => $r->objects,
-        base    => $r->config->{uri_base},
-        config  => $r->config
-        # ...
-    ) ;
-    if ($class) { 
-        $args{classmetadata} = {
-            name => $class,
-            columns => [ $class->columns ],
-            colnames => { $class->column_names },
-            related_accessors => [ $class->related($r) ],
-            moniker => $class->moniker,
-            plural  => $class->plural_moniker,
-            cgi => { $class->to_cgi },
-            description => $class->description
-        };
-
-        # User-friendliness facility for custom template writers.
-        if (@{$r->objects || []} > 1) { 
-            $args{$r->model_class->plural_moniker} = $r->objects;
-        } else {
-            ($args{$r->model_class->moniker}) = @{$r->objects};
-        }
+    unless ($self->{tt}) {
+        my $view_options = $r->config->view_options || {};
+        $self->{provider} = Template::Provider->new($view_options);
+        $self->{tt}       = Template->new({
+            %$view_options,
+            LOAD_TEMPLATES => [ $self->{provider} ],
+        });
     }
 
-    # Overrides
-    %args = (%args, %{$r->{template_args}||{}});
-    %args;
-}
+    $self->{provider}->include_path([ $self->paths($r) ]);
 
-sub process {
-    my ($self, $r) = @_;
-    my $template = $self->_tt($r);
-    my $output;
-    $template->process($r->template, { $self->_args($r) }, \$output)
-    || return $self->error($r, $template->error);
-
-    $r->{ar}->content_type("text/html");
-    $r->{ar}->headers_out->set("Content-Length" => length $output);
-    $r->{ar}->send_http_header;
-    $r->{ar}->print($output);
-    return 200;
-}
+    my $template_file = $r->template;
+    my $ext = $r->config->template_extension;
+    $template_file .= $ext if defined $ext;
 
-sub error {
-    my ($self, $r, $error) = @_;
-    warn $error;
-    if ($error =~ /not found$/) { return DECLINED }
-    $r->{ar}->send_http_header("text/plain");
-    $r->{ar}->print($error);
-    exit;
+    my $output;
+    if ($self->{tt}->process($template_file, { $self->vars($r) }, \$output )) {
+        $r->{output} = $output;
+        return OK;
+    }
+    else {
+        $r->{error} = $self->{tt}->error;
+        return ERROR;
+    }
 }
 
 1;
+
+=head1 NAME
+
+Maypole::View::TT - A Template Toolkit view class for Maypole
+
+=head1 SYNOPSIS
+
+    BeerDB->config->view("Maypole::View::TT"); # The default anyway
+
+    # Set some Template Toolkit options
+    BeerDB->config->view_options( {
+        TRIM        => 1,
+        COMPILE_DIR => '/var/tmp/mysite/templates',
+    } );
+
+=head1 DESCRIPTION
+
+This is the default view class for Maypole; it uses the Template Toolkit to
+fill in templates with the objects produced by Maypole's model classes.  Please
+see the L<Maypole manual|Maypole::Manual>, and in particular, the
+L<view|Maypole::Manual::View> chapter for the template variables available and
+for a refresher on how template components are resolved.
+
+The underlying Template toolkit object is configured through
+C<$r-E<gt>config-E<gt>view_options>. See L<Template|Template> for available
+options.
+
+=over 4
+
+=item template
+
+Processes the template and sets the output. See L<Maypole::View::Base>
+
+=back
+
+
+=head1 AUTHOR
+
+Simon Cozens
+
+=cut
+