Handel::Manual::QuickStart 1.00009

Handel::Manual::QuickStart it's a quick start guide to getting Handel up and running.

This guide is meant for those who want to get a shopping cart up and running as quickly as possible using Handel as a stand alone set of classes, as a complete Catalyst application, or as an addition to an existing Catalyst application.

INSTALLATION

See Handel::Manual::Requirements for the list of requirements needed for Handel to run properly. These should be installed automatically by CPAN or CPANPLUS.

CPAN
$ cpan -i Handel
CPANPLUS
$ cpanp -i Handel

NO CUSTOMIZATION

If you don't plan on customizing the default schema or classes, then you're done. Simply use the stock classes in your existing program as you would any other CPAN module.

STAND ALONE APPLICATIONS

If you plan on customizing the default schema (adding columns, changing table names, etc), it is recommended that you create your own set of subclasses, and customize those instead of altering the behaviour of the Handel classes themselves.

To create a new application with Handel classes, run handel: and give it a new application name:

$ handel MyApp

Created MyApp
Created MyApplib
Created MyApplibMyApp.pm
Created MyApplibMyApp
Created MyApplibMyAppCart.pm
Created MyApplibMyAppCart
Created MyApplibMyAppCartItem.pm
Created MyApplibMyAppStorage
Created MyApplibMyAppStorageCart.pm
Created MyApplibMyAppStorageCart
Created MyApplibMyAppStorageCartItem.pm
Created MyApplibMyAppOrder.pm
Created MyApplibMyAppOrder
Created MyApplibMyAppOrderItem.pm
Created MyApplibMyAppStorageOrder.pm
Created MyApplibMyAppStorageOrder
Created MyApplibMyAppStorageOrderItem.pm
Created MyApplibMyAppCheckout.pm
Created MyAppt
Created MyApptpod_syntax.t
Created MyApptpod_spelling.t
Created MyApptbasic.t
Created MyApptpod_coverage.t
Created MyApp.cvsignore
Created MyAppMakefile.PL
Created MyAppMANIFEST
Created MyAppscriptmyapp_handel.pl
Created starter directories and files

This creates a new CPAN style distribution with all of the recommended Handel subclasses. If you need to change any table names, or add columns, etc, simply alter the various Storage classes using the options in Handel::Storage::DBIC. For example, if you wanted to change the carts table to be named myapp_carts instead, add this to MyApp::Storage::Cart:
__PACKAGE__->table_name('myapp_carts');

Once you are done customizing the storage classes, we need to install the database schema. To do that, run the setup script created in the step above, passing it the DBI dsn /user/pass for the database you wish to install into.

Note: The database you specify must already exist and you need to use a user/password that has permissions to create tables.

$ cd MyApp
$ perl script/myapp_handel.pl schema --install --dsn dbi:mysql:handel:localhost --user myuser --pass mypass
Installed/created database schema

If you want to use a local SQLite database, you can simply pass the --default option which will create a database in MyApp/data/handel.db

$ cd MyApp
$ perl script/myapp_handel.pl schema --install --default
Installed/created database schema

Now, simply treat the newly created code as any other CPAN distribution:

$ perl Makefile.PL
$ make
$ make test
$ make install

Product's homepage

Requirements:

· Perl