NAME
    Handel - Simple commerce framework with AxKit/TT2 support

DESCRIPTION
    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.

FEATURES
    Add/Update/Delete/Save/Restore Cart Contents
    Full AxKit XSP Taglib Support
    Template Toolkit 2 Plugin Support
    Currency Conversion
    Currency Formatting
    Basic Localization Support
    Multiple Database Support

REQUIREMENTS
  Prerequisites
    The following modules are required for Handel to work properly. Older
    versions may work fine, but hese are the versions I have installed and
    verified to work correctly. IF you have older versious and all tests
    pass, send me an email and I'll lower the version requirements.

    Class::DBI
        "Class::DBI" version 0.96 or greater.

    DBI "DBI" version 1.36 or greater.

    Error
        "Error" version 0.14 or greater.

    Locale::Maketext
        "Locale::Maketext" version 1.06 or greater.

    Data::UUID
        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.

  Optional Modules
    The following modules are not required for Handel to run, although some
    features may be unavailable without them.

    AxKit
        "AxKit" version 1.61 or greater.

        "AxKit" is only required if you plan on using "Handel" within XSP
        using the supplied taglibs.

    Locale::Currency::Format
        "Locale::Currency::Format" version 1.22 or greater.

        When present, this module allows all prices to be formatted to
        specific currency codes and formats.

    Finance::Currency::Convert::WebserviceX
        "Finance::Currency::Convert::WebserviceX" version 0.03 or greater.

        When present, this module allows all prices to be converted from one
        currency to another.

    Locale::Currency
        "Locale::Currency" version 2.07 or greater.

        When present, this module allows all conversion and currency codes
        to be verified as real 3 letter ISO currency codes.

    Template
        "Template" version 2.07 or greater.

        "Template" (TT2/Template ToolKit) is only required if you plan on
        using Handel within TT2 based websites.

  Build/Test Modules
    The following modules are only required for the test suite when running
    "make test".

    Test::More
        "Test::More" version 0.48 or greater.

        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 reveive these during
        "make test", try upgrading "Test::More".

    Pod::Coverage
        "Pod::Coverage" version 0.14 or greater.

        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
        "Test::Pod" version 1.00 or greater.

        "Test::Pod" 1.00 added the "all_pod_files_ok()" method which makes
        my life easier. :-)

    Test::Pod::Coverage
        "Test::Pod::Coverage" version 1.04 or greater.

        "Test::Pod::Coverage" 1.04 was made taint safe, and we run the tests
        with -wT like good girls and boys.

    Test:Strict
        "Test::Strict" version 0.01 or greater.

        This keeps me honest and makes sure I always "use strict".

SEE ALSO
    Handel::Cart

AUTHOR
        Christopher H. Laco
        CPAN ID: CLACO
        claco@chrislaco.com
        http://today.icantfocus.com/blog/
