Notice - A MVC (DBIC,TT,CAS) CGI::Application Customer Resource and Account Manager inspired by C:A:Structured
Perl JavaScript CSS Other
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
config
lib
script
t
.gitignore
ABOUT
Changes
INSTALL
INSTALL.json
MANIFEST
MANIFEST.SKIP
META.yml
Makefile.PL
README
README.hackers
README.whois
SIGNATURE
debug.sh
server.pl

README

Notice

Notice - An MVC (DBIC,TT,CGI::Application) Customer Resource and Account Manager, (and more).

FEATURES

    Sign-up; Login; Remember me; Passphrase recovery, (Forgotten Password?); Logout

    Optional client-side AES encryption for functions; 
        SSL isn't as good as SSH, and why tempt the DBadmin?
        (see http://localhost:8060/cgi-bin/index.cgi/email/edit_alias/f/1/ )

    Page load time - how long it took for the page to load

    Pagination - You can page through data using the _page function in Noitce.pm

    Security - Access to areas of the site can be monitored and controlled.
               If a user is having problems with a module or function, then it can be highlighted. This also enabled the site admin to limit a data leak from a flood to a trickle;
               no more taking the customer database with you when you leave.

    Anything you want or need - Notice can easily be extended, though it already has many many additional features.
                    (see http://localhost:8060/cgi-bin/index.cgi/modules )

INTRODUCTION

CGI:Application:Structured got a lot of things right but I prefer not to name my runmodes after perl functions. i.e. 
sub main: StartRunmode{ } #seems better than the default of sub index: StartRunmode{ }

I had a hard time getting sessions; authentication; dispatch; query (the cgi query) all working at the same time with C:A:S. That said I'm very grateful to C:A:S in my transition from Catalyst to CGI:App

Is it $self or $c ? I've chosen $self

If you have just cloned this from github then you might have to install the deps; You can do this, (if you have cpanm installed) with

    sudo cpanm --installdeps .  

or you can use this shell one liner:

    for i in `grep :: Makefile.PL|grep -v '>='|sed -e 's/^use //g' -e "s/^\s*'//g" -e "s/'.*//g" -e 's/;$//'`;do sudo perl -MCPAN -e "install $i"; done


INSTALLATION

CHANGE the default password in config/config.pl
    
Create the database: (there is a script that will do that for you)

    ./script/create_notice_db.pl

Then for your cgi-bin
    cp -pari config t/cgi-bin/* /var/www/sites/www.example.com/cgi-bin/
and where ever your www is
    cp -pari t/www/* /var/www/sites/www.example.com/www/

(This is why the TT templates are in t/cgi-bin/templates.)

To install this module, I run the following commands:

	perl Makefile.PL
	make
	make test
	sudo make install

Check the install (default login is with a@b.com with a password of 123Abc).

If you forgot to change the db_pw in config:

CHANGE the password in ~www/cgi-bin/config/config.pl and in the the db to match:
    mysql -p mysql  #on some systems you don't need the -p if you are root
    mysql> update user set password=PASSWORD('NEW-PASSWORD') where User='notice_adminuser';


BUGS and LIMITATIONS

Notice should check for a valid DB and offer to install via https if $CFG{installing}=1;
(Anyone feel like writing that?)
Notice has only been tested with mySQL and SQLite, though because of DBIx::Class it should
work with postgres and other even comercial systems.

DONATIONS

I would like to thank, for their donations to the development of Notice: SDR,SMD,CLA
; Donations are gratefully received.

SUPPORT AND DOCUMENTATION

After installing, you can find documentation for this module with the perldoc command.

    perldoc Notice

You could also look for information at:

    Notice@GitHub
        http://github.com/alexxroche/Notice

    (Contact the author)

    RT, CPAN's request tracker
        http://rt.cpan.org/NoAuth/Bugs.html?Dist=Notice

    AnnoCPAN, Annotated CPAN documentation
        http://annocpan.org/dist/Notice

    CPAN Ratings
        http://cpanratings.perl.org/d/Notice

    Search CPAN
        http://search.cpan.org/dist/Notice/

AUTHOR

Alexx Roche, <alexx@cpan.org>


LICENSE AND COPYRIGHT

Copyright (C) 2011-2013 Alexx Roche

This program is free software; you can redistribute it and/or modify it
under the following license: Eclipse Public License, Version 1.0
or the Artistic License, Version 2.0.

(Contact the author if you require another license)

See http://www.opensource.org/licenses/ for more information.