Gianni Ceccarelli > CatalystX-ComponentsFromConfig > CatalystX::ComponentsFromConfig::ViewPlugin

Download:
CatalystX-ComponentsFromConfig-1.005.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
View/Report Bugs
Module Version: 1.005   Source  

NAME ^

CatalystX::ComponentsFromConfig::ViewPlugin - plugin to create Views from configuration

VERSION ^

version 1.005

SYNOPSIS ^

In your application:

  package My::App;
  use Catalyst qw(
      ConfigLoader
      +CatalystX::ComponentsFromConfig::ViewPlugin
  );

In your config:

   <View::MyClass>
    class My::Class
    <args>
      some  param
    </args>
    <traits>
      +My::Special::Role
    </traits>
   </View::MyClass>

Now, $c->view('MyClass') will contain an object built just like:

  my $obj = My::Class->new({some=>'param'});
  apply_all_roles($obj,'My::Special::Role');

DESCRIPTION ^

This plugin, built on CatalystX::ComponentsFromConfig::Role::PluginRole, allows you to create view components at application setup time, just by specifying them in the configuration.

GLOBAL CONFIGURATION ^

  <views_from_config>
   base_class My::ViewAdaptor
  </views_from_config>

The default base_class is CatalystX::ComponentsFromConfig::ViewAdaptor, but you can specify whatever adaptor you want. Of course, you have to make sure that the view-specific configuration block is in the format that your adaptor expects.

A useful example is when you want to use Catalyst::View::TT:

 <View::Template>
  base_class Catalyst::View::TT
  INCLUDE_PATH __path_to('root/src')__
  INCLUDE_PATH __path_to('root/lib')__
  TEMPLATE_EXTENSION .tt
  CATALYST_VAR Catalyst
  TIMER 0
 </View::Template>

Note that, since we're not using CatalystX::ComponentsFromConfig::ViewAdaptor, the way you pass the various parameters is different than what is shown at the top.

AUTHORS ^

COPYRIGHT AND LICENSE ^

This software is copyright (c) 2012 by Net-a-porter.com.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

syntax highlighting: