NAME
    Plack::App::Login - Plack login application.

SYNOPSIS
     use Plack::App::Login;

     my $obj = Plack::App::Login->new(%parameters);
     my $psgi_ar = $obj->call($env);
     my $app = $obj->to_app;

METHODS
  "new"
     my $obj = Plack::App::Login->new(%parameters);

    Constructor.

    Returns instance of object.

    *       "css"

            Instance of CSS::Struct::Output object.

            Default value is CSS::Struct::Output::Raw instance.

    *       "generator"

            HTML generator string.

            Default value is 'Plack::App::Login; Version: __VERSION__'.

    *       "login_link"

            Login link.

            Default value is 'login'.

    *       "login_title"

            Login title.

            Default value is 'LOGIN'.

    *       "tags"

            Instance of Tags::Output object.

            Default value is Tags::Output::Raw->new('xml' => 1) instance.

    *       "title"

            Page title.

            Default value is 'Login page'.

  "call"
     my $psgi_ar = $obj->call($env);

    Implementation of login page.

    Returns reference to array (PSGI structure).

  "to_app"
     my $app = $obj->to_app;

    Creates Plack application.

    Returns Plack::Component object.

EXAMPLE
     use strict;
     use warnings;

     use CSS::Struct::Output::Indent;
     use Plack::App::Login;
     use Plack::Runner;
     use Tags::Output::Indent;

     # Run application.
     my $app = Plack::App::Login->new(
             'css' => CSS::Struct::Output::Indent->new,
             'tags' => Tags::Output::Indent->new(
                     'preserved' => ['style'],
                     'xml' => 1,
             ),
     )->to_app;
     Plack::Runner->new->run($app);

     # Output:
     # HTTP::Server::PSGI: Accepting connections at http://0:5000/

     # > curl http://localhost:5000/
     # <!DOCTYPE html>
     # <html>
     #   <head>
     #     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
     #     <meta charset="UTF-8" />
     #     <meta name="generator" content=
     #       "Perl module: Tags::HTML::Page::Begin, Version: 0.08" />
     #     <title>
     #       Login page
     #     </title>
     #     <style type="text/css">
     # .outer {
     #         position: fixed;
     #         top: 50%;
     #         left: 50%;
     #         transform: translate(-50%, -50%);
     # }
     # .login {
     #         text-align: center;
     #         background-color: blue;
     #         padding: 1em;
     # }
     # .login a {
     #         text-decoration: none;
     #         color: white;
     #         font-size: 3em;
     # }
     # </style>
     #   </head>
     #   <body class="outer">
     #     <div class="login">
     #       <a href="login">
     #         LOGIN
     #       </a>
     #     </div>
     #   </body>
     # </html>

DEPENDENCIES
    CSS::Struct::Output::Raw, Plack::Util::Accessor,
    Tags::HTML::Login::Button, Tags::HTML::Page::Begin,
    Tags::HTML::Page::End, Tags::Output::Raw, Unicode::UTF8.

REPOSITORY
    <https://github.com/michal-josef-spacek/Plack-App-Login>

AUTHOR
    Michal Josef Špaček <mailto:skim@cpan.org>

    <http://skim.cz>

LICENSE AND COPYRIGHT
    © 2020-2022 Michal Josef Špaček

    BSD 2-Clause License

VERSION
    0.04

