NAME

Catalyst::View::XSLT - XSLT View Class

SYNOPSIS

    # use the helper
    create.pl view XSLT XSLT

    # lib/MyApp/View/XSLT.pm
    package MyApp::View::XSLT;

    use base 'Catalyst::View::XSLT';

    __PACKAGE__->config(
	  # paths to search the templates
	  INCLUDE_PATH => [
	    MyApp->path_to( 'root', 'xslt' ),
		MyApp->path_to( 'templates', 'xsl' ),
	  ],
	    
	  # default template extension to use
	  # when you don't provide template name
	  TEMPLATE_EXTENSION => '.xsl',
		
	  # use this for debug purposes
	  # it will dump the the final (merged) config
	  DUMP_CONFIG => 1,
	
	  # XML::LibXSLT specific configuration 
	  LibXSLT => {
	    register_function => [
		  {
		    uri => 'urn:catalyst',
			name => 'add',
			subref => sub { return $_[0] + $_[1] },
		  },
		  {
		    uri => 'urn:foo',
			name => 'Hello',
			subref => sub { return 'Hello, Catalyst\'s user.' },
		  }
	    ],
	  },
    );

    # don't need nothing more

    1;

    # In your controller(s) :
    sub someAction : Local {
		
      # 'template' could be string or path to file
      # see 'xml' for more info about string version 
	  
      # path to the template could be absolute
      $c->stash->{template} = $c->config->{home} . 'root/some.xsl';

      # or relative
      $c->stash->{template} = 'some.xsl'; # this file will be searched in include paths

      # or if you didn't provide any template name 
      # then the last chance is 'someAction.xsl' ($c->action . $config->{TEMPLATE_EXTENSION})
		
      # 'xml' could be string
      $c->stash->{xml} =<<XML;
<root>
	<level1>data</level>
</root>
XML
      # or a relative path which will se searched in include paths
      # $c->stash->{xml} = 'my.xml';

      # or an absolute path 
      # $c->stash->{xml} = '/some/where/around.xml';

      # add more subrefs (these will predefine config ones if they overlap)
      $c->stash->{additional_register_function} = [
        {
          uri => 'urn:catalyst',
          name => 'doIt',
          subref => sub { return $obj->method(@_) },
        }
      ];
		
      # everything else in the stash will be used for parameters (<xsl:param name="param1" />)
      $c->stash->{param1} = 'Param1 value';'
      $c->stash->{param2} = 'Param2 value';
    }

    # Meanwhile, maybe in an 'end' action
        
    $c->forward('MyApp::View::XSLT');
    
    # to use your registered functions in some.xsl:
    <xsl:stylesheet 
	  xmlns:xsl="http://www.w3.org/1999/XSL/Transform" 
	  xmlns:catalyst="urn:catalyst"
	  xmlns:foo="urn:foo"
	  version="1.0">
	  ...
   	  <xsl:value-of select="catalyst:add(4, 5)" />
   	  <xsl:value-of select="foo:Hello()" />
   	  <xsl:value-of select="catalyst:doIt($param1, 3)" />
   	  ...
    </xsl:stylesheet>

DESCRIPTION

This is a XSLT view class for Catalyst. Your subclass should inherit from this class.

METHODS

new

The constructor for the XSLT view. Reads the application config.

process

Renders the template specified in $c->stash->{template} or $c->action. Template params are set up from the contents of $c->stash. Output is stored in $c->response->body.

NOTE

This version works only with XML::LibXSLT.

SEE ALSO

Catalyst, Catalyst::Base, XML::LibXSLT.

AUTHOR

Martin Grigorov, mcgregory@e-card.bg

COPYRIGHT

This program is free software, you can redistribute it and/or modify it under the same terms as Perl itself.