zby/webprototypes-registration

Plack application for registering a new user

SYNOPSIS

# connecting with DBIx::Class
{
    package My::Register;
    use parent 'WebPrototypes::Registration';
    use Plack::Util::Accessor qw( schema );

    sub find_user {
        my( $self, $name ) = @_;
        return $self->schema->resultset( 'User' )->search({ username =>  $name })->next;
    }

    sub create_user {
        my( $self, %fields ) = @_;
        return $self->schema->resultset( 'User' )->create({ %fields });
    }
}

use Plack::Builder;

my $app = My::Register->new( schema => $schema );

builder {
    mount "/register" => builder {
        $app->to_app;
    };
};

DESCRIPTION

This application implements a user registration mechanism. After the registration and email address verification letter is sent.

The examples here are with DBIx::Class but they can be easily ported to other storage layers.

This application uses the Template Method design pattern.

PURE VIRTUAL METHODS

These methods need to be overriden in subclass.

find_user ( name )

Should return a true value if the name is already registered

create_user ( attributes )

Should create the user object.

VIRTUAL METHODS

These methods have defaults - but should probably be overriden anyway.

wrap_text ( text )

Should return the html page containing the passed text fragment. By default it just adds the html and body tags.

build_mail ( to_address, link_to_the_reset_page )

Should create the email containing the link.

send_mail ( mail )

Should send the mail (created by build_mail).

OTHER METHODS

call ( env )

SEE ALSO

Plack Plack::Middleware::Auth::Form