Handel - Simple commerce framework with AxKit/TT/Catalyst support
Handel is a quick and not-so-dirty ecommerce framework with AxKit taglib support and TT2 (Template Toolkit) support. It was started for the conversion of an IIS/ASP based commerce site to Apache/ModPerl, but I decided that is might be useful to others so here it is on CPAN.
For the curious, Handel is German for commerce.
You can get the latest news, source, documentation and wiki help at http://handelframework.com/.
Join the mailing list at http://lists.rawmode.org/cgi-bin/mailman/listinfo/handel. Big thanks to gabb@#catalyst for the list space.
The following modules are required for Handel to work properly. Older versions may work fine, but these are the versions I have installed and verified to work correctly. If you have older versions and all tests pass, send me an email and I'll lower the version requirements.
Class::DBI version 0.96 or greater.
Class::DBI
DBI version 1.36 or greater.
DBI
Error version 0.14 or greater.
Error
Locale::Maketext version 1.06 or greater.
Locale::Maketext
At least one of the following modules are required to create uuids: UUID 0.02, Win32::Guidgen 0.04, Win32API::GUID 0.02, or Data::UUID 0.10.
UUID
Win32::Guidgen
Win32API::GUID
Data::UUID
The following modules are not required for Handel to run, although some features may be unavailable without them.
AxKit version 1.61 or greater.
AxKit
AxKit is only required if you plan on using Handel within XSP using the supplied taglibs.
Handel
Locale::Currency::Format version 1.22 or greater.
Locale::Currency::Format
When present, this module allows all prices to be formatted to specific currency codes and formats.
Finance::Currency::Convert::WebserviceX version 0.03 or greater.
Finance::Currency::Convert::WebserviceX
When present, this module allows all prices to be converted from one currency to another.
Locale::Currency version 2.07 or greater.
Locale::Currency
When present, this module allows all conversion and currency codes to be verified as real 3 letter ISO currency codes.
Template version 2.07 or greater.
Template
Template (TT2/Template ToolKit) is only required if you plan on using Handel within TT2 based websites.
The following modules are only required for the test suite when running make test.
make test
Test::More version 0.48 or greater.
Test::More
The Test::More included with perl 5.8.4 and Test::More <= 0.48 have issues with ithreads that usually cause crashes in tests that use Class::DBI or DBIx:ContextualFetch. The errors usual mention "attempt to free unreferenced scalar". If you receive these during make test, try upgrading Test::More.
DBIx:ContextualFetch
Pod::Coverage version 0.14 or greater.
Pod::Coverage
The pod coverage tests may fail complaining about missing pod for methods if Pod::Coverage < 0.14 is installed. This is due to certain syntax variations of the pod with escaped gt/lt. I may just alter the pod and bump this version down if there is enough feedback to do so.
Test::Pod version 1.00 or greater.
Test::Pod
Test::Pod 1.00 added the all_pod_files_ok() method which makes my life easier. :-)
all_pod_files_ok()
Test::Pod::Coverage version 1.04 or greater.
Test::Pod::Coverage
Test::Pod::Coverage 1.04 was made taint safe, and we run the tests with -wT like good girls and boys.
Test::Strict version 0.01 or greater.
Test::Strict
This keeps me honest and makes sure I always use strict.
use strict
When using item_class to specify the item class returned from add/items in your subclass under Class::DBI < 3.0.8, the item_class specified will be returned from all cart classes, including Handel::Cart itself. In most cases, people are only using one subclass of Handel::Cart so this won't effect them.
If you plan on using multiple subclasses of Handel::Cart that may or may not return custom items, upgrade your Class::DBI to version 3.0.8 or greater.
Handel::Cart
Christopher H. Laco CPAN ID: CLACO claco@chrislaco.com http://today.icantfocus.com/blog/
To install Handel, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Handel
CPAN shell
perl -MCPAN -e shell install Handel
For more information on module installation, please visit the detailed CPAN module installation guide.