| 1 | package CGI::Application::Plugin::TmplInnerOuter; | ||
| 2 | use strict; | ||
| 3 | use warnings; | ||
| 4 | require Exporter; | ||
| 5 | use Carp; | ||
| 6 | use vars qw($VERSION @ISA @EXPORT); | ||
| 7 | @ISA = qw/ Exporter /; | ||
| 8 | $VERSION = sprintf "%d.%02d", q$Revision: 1.2 $ =~ /(\d+)/g; | ||
| 9 | @EXPORT = (qw( | ||
| 10 | _feed_merge | ||
| 11 | _feed_vars | ||
| 12 | _feed_vars_all | ||
| 13 | _get_tmpl_default | ||
| 14 | _get_tmpl_name | ||
| 15 | _get_vars | ||
| 16 | _set_tmpl_default | ||
| 17 | _set_vars | ||
| 18 | _tmpl | ||
| 19 | _tmpl_inner | ||
| 20 | _tmpl_outer | ||
| 21 | tmpl_outer | ||
| 22 | tmpl_inner | ||
| 23 | tmpl | ||
| 24 | tmpl_main | ||
| 25 | tmpl_output | ||
| 26 | tmpl_inner_name | ||
| 27 | tmpl_inner_name_set | ||
| 28 | tmpl_set | ||
| 29 | _debug_vars | ||
| 30 | )); | ||
| 31 | |||
| 32 | *_get_tmpl_name = \&tmpl_inner_name; | ||
| 33 | *_get_tmpl_default = \&_tmplsetget_code; | ||
| 34 | *tmpl_inner_name_set = \&tmpl_inner_name; | ||
| 35 | *_tmpl_inner = \&tmpl_inner; | ||
| 36 | *_tmpl_outer = \&tmpl_outer; | ||
| 37 | *tmpl = \&tmpl_inner; | ||
| 38 | *tmpl_main = \&tmpl_outer; | ||
| 39 | *_tmpl = \&_tmplsetget_object; | ||
| 40 | |||
| 41 | *_set_vars = \&tmpl_var; | ||
| 42 | *_get_vars = \&tmpl_var; | ||
| 43 | *tmpl_param = \&tmpl_var; | ||
| 44 | *tmpl_set = \&tmpl_var; | ||
| 45 | |||
| 46 | *_set_tmpl_default = \&_tmplsetget_code; | ||
| 47 | *tmpl_code =\&_tmplsetget_code; | ||
| 48 | |||
| 49 | |||
| 50 | |||
| 51 | |||
| 52 | # storage | ||
| 53 | # if you pass a 'inner' or 'outer' arg, it returns an object | ||
| 54 | sub _tmpl_master { | ||
| 55 | my $self = shift; | ||
| 56 | |||
| 57 | my($name,$code,$object,$request); | ||
| 58 | |||
| 59 | VAL: for my $val (@_){ | ||
| 60 | defined $val or next; | ||
| 61 | my $ref = ref $val; | ||
| 62 | if ($ref and $ref=~/template/i )){ #TODO how to test for blessed, returns name of pkg | ||
| 63 | $object = $val; | ||
| 64 | next VAL; | ||
| 65 | } | ||
| 66 | elsif ($val=~/\.\w{1,5}$/){ | ||
| 67 | $name = $val; | ||
| 68 | next VAL; | ||
| 69 | } | ||
| 70 | elsif( ($val eq 'inner') or ($val eq 'outer') ){ | ||
| 71 | $request = $val; | ||
| 72 | next VAL; | ||
| 73 | } | ||
| 74 | # lastly if it's defined and we dunno what it is, assume it's a template code | ||
| 75 | $code = $val; | ||
| 76 | } | ||
| 77 | |||
| 78 | # if 'inner' or 'outer' was here, autogen name unless defined already in obj | ||
| 79 | |||
| 80 | if( $request ){ | ||
| 81 | |||
| 82 | # if no name arg, do we have one stored? | ||
| 83 | if (! defined $name ){ | ||
| 84 | |||
| 85 | if( exists $self->{_tmpl_master}->{"$request\_name"} ){ # was it already set? | ||
| 86 | $name = $self->{_tmpl_master}->{"$request\_name"}; | ||
| 87 | } | ||
| 88 | |||
| 89 | else { # autogenerate attempt | ||
| 90 | |||
| 91 | if ($request eq 'inner'){ | ||
| 92 | $name = $self->get_current_runmode or die('cant get current runmode'); | ||
| 93 | $name.='.html'; | ||
| 94 | } | ||
| 95 | |||
| 96 | elsif($request eq 'outer'){ | ||
| 97 | $name = 'main.html'; | ||
| 98 | } | ||
| 99 | |||
| 100 | else { | ||
| 101 | die("cant autogen name.html for request $request"); | ||
| 102 | } | ||
| 103 | |||
| 104 | $self->{_tmpl_master}->{"$request\_name"} = $name; | ||
| 105 | # resolved if we got here | ||
| 106 | } | ||
| 107 | |||
| 108 | # name is defined | ||
| 109 | $name or die('still no name'); | ||
| 110 | } | ||
| 111 | |||
| 112 | |||
| 113 | else { # if defined both inner/outer and name in args... | ||
| 114 | # then save | ||
| 115 | $self->{_tmpl_master}->{"$request\_name"} = $name; | ||
| 116 | |||
| 117 | } | ||
| 118 | |||
| 119 | $name or die('still no name!'); | ||
| 120 | } | ||
| 121 | |||
| 122 | |||
| 123 | |||
| 124 | # name HAS to be defined. | ||
| 125 | $name or die('missing name.ext arg'); | ||
| 126 | |||
| 127 | $self->{_tmpl_master}->{$name} ||= { code => undef, object => undef }; | ||
| 128 | |||
| 129 | if ($code){ | ||
| 130 | $self->{_tmpl_master}->{$name}->{code} = $code; | ||
| 131 | } | ||
| 132 | |||
| 133 | if ($object){ | ||
| 134 | $self->{_tmpl_master}->{$name}->{object} = $object; | ||
| 135 | } | ||
| 136 | |||
| 137 | |||
| 138 | if($request){ | ||
| 139 | # then we return an object even if none is present already | ||
| 140 | |||
| 141 | $object ||= $self->{_tmpl_master}->{$name}->{object}; | ||
| 142 | |||
| 143 | unless( $object ){ #still no object, must be first instance.. | ||
| 144 | |||
| 145 | my $coderef; | ||
| 146 | $code = $self->{_tmpl_master}->{$name}->{code}; | ||
| 147 | if ($code){ | ||
| 148 | $coderef =\$code; | ||
| 149 | } | ||
| 150 | |||
| 151 | # might be undefined, that's ok | ||
| 152 | require HTML::Template::Default; | ||
| 153 | $object = HTML::Template::Default::get_tmpl($name, $coderef) | ||
| 154 | or die("cant instace $name $request"); | ||
| 155 | |||
| 156 | $self->{_tmpl_master}->{$name}->{object} = $object; | ||
| 157 | } | ||
| 158 | |||
| 159 | } | ||
| 160 | |||
| 161 | |||
| 162 | |||
| 163 | |||
| 164 | |||
| 165 | # return object if there is one, otherwise it's undef | ||
| 166 | return $self->{_tmpl_master}->{$name}->{object}; | ||
| 167 | } | ||
| 168 | =pod | ||
| 169 | |||
| 170 | to get template | ||
| 171 | |||
| 172 | $self->_tmpl_master('inner'); | ||
| 173 | $self->_tmpl_master('outer'); | ||
| 174 | |||
| 175 | |||
| 176 | set default template code and filename without loading | ||
| 177 | |||
| 178 | $self->_tmpl_master(' | ||
| 179 | |||
| 180 | |||
| 181 | =cut | ||
| 182 | |||
| 183 | |||
| 184 | |||
| 185 | |||
| 186 | sub _tmpl_name { | ||
| 187 | my($self,$val,$name) = @_; | ||
| 188 | $self->{_tmpl_name} ||= {}; | ||
| 189 | if(defined $val and ! defined $name){ | ||
| 190 | if($val eq 'inner'){ | ||
| 191 | $self->{_tmpl_name}->{$val} ||= $self->get_current_runmode .'.html'; | ||
| 192 | return $self->{_tmpl_name}->{$val}; | ||
| 193 | } | ||
| 194 | elsif($val eq 'outer'){ | ||
| 195 | $self->{_tmpl_name}->{$val} = 'main.html'; | ||
| 196 | return $self->{_tmpl_name}->{$val}; | ||
| 197 | } | ||
| 198 | else { | ||
| 199 | return $self->{_tmpl_name}->{$val}; # might be undef, most likely | ||
| 200 | } | ||
| 201 | } | ||
| 202 | elsif( defined $val and defined $name){ | ||
| 203 | $self->{_tmpl_name}->{$val} = $name; | ||
| 204 | return $name; | ||
| 205 | } | ||
| 206 | croak('missing args'); | ||
| 207 | } | ||
| 208 | # tmpl_name( inner => 'this.html' ); # sets | ||
| 209 | # tmpl_name( inner ); # gets | ||
| 210 | |||
| 211 | sub tmpl_inner_name { | ||
| 212 | my($self,$val) = @_; | ||
| 213 | return $self->_tmpl_name('inner', $val); # val can be undef | ||
| 214 | } | ||
| 215 | |||
| 216 | sub tmpl_outer_name { | ||
| 217 | my($self,$val) = @_; | ||
| 218 | return $self->_tmpl_name('outer', $val); # val can be undef | ||
| 219 | } | ||
| 220 | |||
| 221 | sub tmpl_outer { | ||
| 222 | my ($self,$tmpl) = @_; | ||
| 223 | my $name = $self->tmpl_outer_name; | ||
| 224 | if(defined $tmpl ){ | ||
| 225 | return $self->_tmplsetget_object($name, $tmpl); | ||
| 226 | } | ||
| 227 | return $self->_tmplsetget_object($name); | ||
| 228 | } | ||
| 229 | |||
| 230 | |||
| 231 | |||
| 232 | sub tmpl_inner { | ||
| 233 | my ($self,$tmpl) = @_; | ||
| 234 | my $name = $self->tmpl_inner_name; | ||
| 235 | if(defined $tmpl ){ | ||
| 236 | return $self->_tmplsetget_object($name, $tmpl); | ||
| 237 | } | ||
| 238 | return $self->_tmplsetget_object($name); | ||
| 239 | } | ||
| 240 | |||
| 241 | sub tmpl_inner_name { | ||
| 242 | my($self,$name)= @_; | ||
| 243 | if(defined $name){ | ||
| 244 | $name=~/\.[a-z]{3,5$/i or $name.='.html'; | ||
| 245 | |||
| 246 | $self->{_tmpl_inner_name} = $name; | ||
| 247 | return $name; | ||
| 248 | } | ||
| 249 | unless( $self->{_tmpl_inner_name} ){ | ||
| 250 | my $rm = $self->get_current_runmode or die('cant get current runmode'); | ||
| 251 | $self->{_tmpl_inner_name} = "$rm.html"; | ||
| 252 | } | ||
| 253 | return $self->{_tmpl_inner_name}; | ||
| 254 | } | ||
| 255 | |||
| 256 | sub tmpl_outer_name { | ||
| 257 | my($self,$name)= @_; | ||
| 258 | if(defined $name){ | ||
| 259 | $name=~/\.[a-z]{3,5$/i or $name.='.html'; | ||
| 260 | |||
| 261 | $self->{_tmpl_outer_name} = $name; | ||
| 262 | return $name; | ||
| 263 | } | ||
| 264 | unless( $self->{_tmpl_outer_name} ){ | ||
| 265 | $self->{_tmpl_outer_name} = "main.html"; | ||
| 266 | } | ||
| 267 | return $self->{_tmpl_outer_name}; | ||
| 268 | } | ||
| 269 | |||
| 270 | |||
| 271 | |||
| 272 | sub _tmplsetget_object { | ||
| 273 | my($self,$name,$object) = @_; | ||
| 274 | |||
| 275 | $name ||= $self->tmpl_inner_name; # or outer? | ||
| 276 | |||
| 277 | if(defined $object){ | ||
| 278 | $self->{_tmplsetget}->{$name} = $object; | ||
| 279 | return $object; | ||
| 280 | } | ||
| 281 | |||
| 282 | elsif ( defined $name ){ | ||
| 283 | |||
| 284 | if( my $tmpl = $self->{_tmplsetget}->{$name} ){ | ||
| 285 | return $tmpl; | ||
| 286 | } | ||
| 287 | |||
| 288 | my $default_code = $self->_tmplsetget_code($name); | ||
| 289 | if ((! defined $default_code ) and ($self->tmpl_outer_name eq $name) ){ | ||
| 290 | $default_code = $self->_tmplsetget_code('main.html', __main_html()); | ||
| 291 | } | ||
| 292 | |||
| 293 | require HTML::Template::Default; | ||
| 294 | |||
| 295 | if ( my $tmpl = HTML::Template::Default::get_tmpl($name, $default_code) ){ | ||
| 296 | $self->{_tmplsetget}->{$name} = $tmpl; | ||
| 297 | return $tmpl; | ||
| 298 | } | ||
| 299 | else { | ||
| 300 | die("cant instance $name template"); | ||
| 301 | } | ||
| 302 | } | ||
| 303 | |||
| 304 | croak('no name or object provided.'); | ||
| 305 | } | ||
| 306 | |||
| 307 | sub _tmplsetget_code { | ||
| 308 | my $self = shift; | ||
| 309 | |||
| 310 | my($code,$name); | ||
| 311 | |||
| 312 | for my $val (@_){ | ||
| 313 | if( defined $val){ | ||
| 314 | if ($val=~/^\w+\.html$/){{ | ||
| 315 | $name = $val; | ||
| 316 | } | ||
| 317 | else { | ||
| 318 | $code =$val; | ||
| 319 | } | ||
| 320 | } | ||
| 321 | } | ||
| 322 | $name ||= $self->tmpl_outer_name; | ||
| 323 | |||
| 324 | if(defined $code){ | ||
| 325 | $self->{_tmplsetget_code}->{$name} = $code; | ||
| 326 | return $code; | ||
| 327 | } | ||
| 328 | elsif ( defined $name ){ | ||
| 329 | |||
| 330 | if( my $code = $self->{_tmplsetget_code}->{$name} ){ | ||
| 331 | return $code; | ||
| 332 | } | ||
| 333 | else { | ||
| 334 | return; #it's ok to return undef code, it just insists for a file template on disk | ||
| 335 | } | ||
| 336 | } | ||
| 337 | croak('no name or code provided'); | ||
| 338 | } | ||
| 339 | |||
| 340 | |||
| 341 | |||
| 342 | sub __main_html { | ||
| 343 | my $self = shift; | ||
| 344 | |||
| 345 | return q{<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" | ||
| 346 | "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> | ||
| 347 | <html> | ||
| 348 | <head> | ||
| 349 | <title><TMPL_VAR NAME=TITLE></title> | ||
| 350 | <meta http-equiv="Content-Type" content="text/html;charset=utf-8"/> | ||
| 351 | </head> | ||
| 352 | <body> | ||
| 353 | <TMPL_VAR NAME=BODY> | ||
| 354 | </body> | ||
| 355 | </html>}; | ||
| 356 | } | ||
| 357 | |||
| 358 | sub tmpl_output { | ||
| 359 | my $self = shift; | ||
| 360 | $self->_feed_vars_all; | ||
| 361 | $self->_feed_merge; | ||
| 362 | return $self->tmpl_outer->output; | ||
| 363 | } | ||
| 364 | |||
| 365 | sub _feed_vars_all { | ||
| 366 | my $self = shift; | ||
| 367 | $self->_feed_vars( $self->tmpl_inner ); | ||
| 368 | $self->_feed_vars( $self->tmpl_outer ); | ||
| 369 | return 1; | ||
| 370 | } | ||
| 371 | |||
| 372 | sub _feed_merge { | ||
| 373 | my $self = shift; | ||
| 374 | $self->tmpl_outer->param( BODY => $self->tmpl_inner->output ); | ||
| 375 | return 1; | ||
| 376 | } | ||
| 377 | |||
| 378 | |||
| 379 | sub tmpl_var { | ||
| 380 | my $self = shift; | ||
| 381 | $self->{_tmpl_vars} ||={}; | ||
| 382 | |||
| 383 | if ( @_ ){ | ||
| 384 | my %vars = @_; | ||
| 385 | for ( keys %vars ){ | ||
| 386 | my $key = $_; | ||
| 387 | my $val = $vars{$key}; | ||
| 388 | defined $val or next; | ||
| 389 | $self->{_tmpl_vars}->{$key} = $val; | ||
| 390 | }; | ||
| 391 | } | ||
| 392 | $self->{_tmpl_vars}; | ||
| 393 | } | ||
| 394 | |||
| 395 | |||
| 396 | sub _feed_vars { | ||
| 397 | my $self = shift; | ||
| 398 | my $tmpl = shift; | ||
| 399 | defined $tmpl or confess('missing arg'); | ||
| 400 | debug('start'); | ||
| 401 | my $vars = $self->tmpl_var; | ||
| 402 | VARS : for( keys %$vars){ | ||
| 403 | my $key = $_; | ||
| 404 | my $val = $vars->{$key}; | ||
| 405 | defined $val or next VARS; | ||
| 406 | $tmpl->param( $_ => $vars->{$_} ); | ||
| 407 | } | ||
| 408 | debug("ok\n"); | ||
| 409 | return 1; | ||
| 410 | } | ||
| 411 | |||
| 412 | |||
| 413 | sub _debug_vars { | ||
| 414 | my $self = shift; | ||
| 415 | my $neat_layout = shift; | ||
| 416 | $neat_layout ||=0; | ||
| 417 | |||
| 418 | my $v = $self->tmpl_var; | ||
| 419 | my @k = sort keys %$v; | ||
| 420 | scalar @k or return 1; | ||
| 421 | |||
| 422 | debug(); | ||
| 423 | if($neat_layout){ | ||
| 424 | map { printf STDERR " %18s : %s\n", $_, $v->{$_} } @k; | ||
| 425 | } | ||
| 426 | |||
| 427 | else { | ||
| 428 | map { printf STDERR " %s'%s', ", $_, $v->{$_} } @k; | ||
| 429 | } | ||
| 430 | print STDERR "\n"; | ||
| 431 | return 1; | ||
| 432 | } | ||
| 433 | |||
| 434 | |||
| 435 | sub debug { print STDERR "@_\n" } | ||
| 436 | |||
| 437 | 1; | ||
| 438 | |||
| 439 | __END__ |