catalystx::simplelogin::controller::login(3pm) [debian man page]

CatalystX::SimpleLogin::Controller::Login(3pm)		User Contributed Perl Documentation	    CatalystX::SimpleLogin::Controller::Login(3pm)

NAME

       CatalystX::SimpleLogin::Controller::Login - Configurable login controller

SYNOPSIS

	   # For simple useage exmple, see CatalystX::SimpleLogin, this is a
	   # full config example
	   __PACKAGE__->config(
	       'Controller::Login' => {
		   traits => [
		       'WithRedirect', # Optional, enables redirect-back feature
		       '-RenderAsTTTemplate', # Optional, allows you to use your own template
		   ],
		   actions => {
		       login => { # Also optional
			   PathPart => ['theloginpage'], # Change login action to /theloginpage
		       },
		   },
	       },
	   );

       See CatalystX::SimpleLogin::Form::Login for configuring the form.

DESCRIPTION

       Controller base class which exists to have login roles composed onto it for the login and logout actions.

ATTRIBUTES

   login_form_class
       A class attribute containing the class of the form to be initialised. One can override it in a derived class with the class of a new form,
       possibly subclassing CatalystX::SimpleLogin::Form::Login. For example:

	   package MyApp::Controller::Login;

	   use Moose;

	   extends('CatalystX::SimpleLogin::Controller::Login');

	   has '+login_form_class' => (
	       default => "MyApp::Form::Login",
	   );

	   1;

   login_form_class_roles
       An attribute containing an array reference of roles to be consumed by the form. One can override it in a similar way to "login_form_class":

	   package MyApp::Controller::Login;

	   use Moose;

	   extends('CatalystX::SimpleLogin::Controller::Login');

	   has '+login_form_class_roles' => (
	       default => sub { [qw(MyApp::FormRole::Foo MyApp::FormRole::Bar)] },
	   );

	   1;

METHODS

   BUILD
       Cause form instance to be built at application startup.

   do_post_login_redirect
       This method does a post-login redirect. TODO for BOBTFISH - should it even be public? If it does need to be public, then document it
       because the Pod coverage test failed.

   login
       Login action.

   login_redirect
       Redirect to the login action.

   login_GET
       Displays the login form

   login_POST
       Processes a submitted login form, and if correct, logs the user in and redirects

   not_required
       A stub action that is anchored at the root of the site ("/") and does not require registration (hence the name).

   redirect_after_login_uri
       If you are using WithRedirect (i.e. by default), then this methd is overridden to redirect the user back to the page they intially hit
       which required authentication.

       Note that even if the original URI was a post, then the redirect back will only be a GET.

       If you choose NOT to compose the WithRedirect trait, then you can set the uri users are redirected to with the "redirect_after_login_uri"
       config key, or by overriding the redirect_after_login_uri method in your own login controller if you need custom logic.

   render_login_form
       Renders the login form. By default it just calls the form's render method. If you want to do something different, like rendering the form
       with a template through your view, this is the place to hook into.

   required
       A stub action that is anchored at the root of the site ("/") and does require registration (hence the name).

SEE ALSO

       CatalystX::SimpleLogin::TraitFor::Controller::Login::WithRedirect
       CatalystX::SimpleLogin::Form::Login

AUTHORS

       See CatalystX::SimpleLogin for authors.

LICENSE

       See CatalystX::SimpleLogin for license.

perl v5.14.2							    2012-07-15			    CatalystX::SimpleLogin::Controller::Login(3pm)

CatalystX::InjectComponent(3pm) 			User Contributed Perl Documentation			   CatalystX::InjectComponent(3pm)

NAME

       CatalystX::InjectComponent - Inject components into your Catalyst application

VERSION

       Version 0.024

SYNOPSIS

	   package My::App;

	   use Catalyst::Runtime '5.80';

	   use Moose;
	   BEGIN { extends qw/Catalyst/ }

	   ...

	   after 'setup_components' => sub {
	       my $class = shift;
	       CatalystX::InjectComponent->inject( into => $class, component => 'MyModel' );
	       if ( $class->config->{ ... ) {
		   CatalystX::InjectComponent->inject( into => $class, component => 'MyRootV2', as => 'Controller::Root' );
	       }
	       else {
		   CatalystX::InjectComponent->inject( into => $class, component => 'MyRootV1', as => 'Root' ); # Controller:: will be automatically prefixed
	       }
	   };

DESCRIPTION

       CatalystX::InjectComponent will inject Controller, Model, and View components into your Catalyst application at setup (run)time. It does
       this by creating a new package on-the-fly, having that package extend the given component, and then having Catalyst setup the new component
       (via "->setup_component")

So, how do I use this thing?
       You should inject your components when appropriate, typically after "setup_compenents" runs

       If you're using the Moose version of Catalyst, then you can use the following technique:

	   use Moose;
	   BEGIN { extends qw/Catalyst/ }

	   after 'setup_components' => sub {
	       my $class = shift;

	       CatalystX::InjectComponent->inject( into => $class, ... )
	   };

METHODS

   CatalystX::InjectComponent->inject( ... )
	   into        The Catalyst package to inject into (e.g. My::App)
	   component   The component package to inject
	   as	       An optional moniker to use as the package name for the derived component

       For example:

	   ->inject( into => My::App, component => Other::App::Controller::Apple )

	       The above will create 'My::App::Controller::Other::App::Controller::Apple'

	   ->inject( into => My::App, component => Other::App::Controller::Apple, as => Apple )

	       The above will create 'My::App::Controller::Apple'

ACKNOWLEDGEMENTS

       Inspired by Catalyst::Plugin::AutoCRUD

AUTHOR

       Robert Krimen, "<rkrimen at cpan.org>"

BUGS

       Please report any bugs or feature requests to "bug-catalystx-injectcomponent at rt.cpan.org", or through the web interface at
       http://rt.cpan.org/NoAuth/ReportBug.html?Queue=CatalystX-InjectComponent <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=CatalystX-
       InjectComponent>.  I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

       You can find documentation for this module with the perldoc command.

	   perldoc CatalystX::InjectComponent

       You can also look for information at:

       o   RT: CPAN's request tracker

	   http://rt.cpan.org/NoAuth/Bugs.html?Dist=CatalystX-InjectComponent <http://rt.cpan.org/NoAuth/Bugs.html?Dist=CatalystX-InjectComponent>

       o   AnnoCPAN: Annotated CPAN documentation

	   http://annocpan.org/dist/CatalystX-InjectComponent <http://annocpan.org/dist/CatalystX-InjectComponent>

       o   CPAN Ratings

	   http://cpanratings.perl.org/d/CatalystX-InjectComponent <http://cpanratings.perl.org/d/CatalystX-InjectComponent>

       o   Search CPAN

	   http://search.cpan.org/dist/CatalystX-InjectComponent/ <http://search.cpan.org/dist/CatalystX-InjectComponent/>

ACKNOWLEDGEMENTS

COPYRIGHT &; LICENSE
       Copyright 2009 Robert Krimen, all rights reserved.

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

perl v5.14.2							    2012-04-06					   CatalystX::InjectComponent(3pm)