NAME

Handel::Constants - Common constants used in Handel

SYNOPSIS

use Handel::Constants qw(:cart);

my $cart = Handel::Cart->new({
    shopper => 'D597DEED-5B9F-11D1-8DD2-00AA004ABD5E'
});

if ($cart->type == CART_TYPE_SAVED) {
    print 'This cart is saved!';
};

DESCRIPTION

Handel::Constants contains a set of constants used throughout Handel. It may be useful (or even a good idea) to use these in your code. :-)

By default, Handel::Constants export nothing. Use can use the export tags below to export all or only certain groups of constants.

METHODS

str_to_const($)

Converts a string version of a constant into that constants value.

print str_to_const('CART_TYPE_SAVED');  ## prints 1

CONSTANTS

CART_MODE_APPEND

All items in the saved cart will be appended to the list of items in the current cart. No effort will be made to merge items with the same SKU and duplicates will be left as seperate items.

CART_MODE_MERGE

If an item with the same SKU exists in both the current cart and the saved cart, the quantity of each will be added together and applied to the same sku in the current cart. Any price differences are ignored and we assume that the price in the current cart is more up to date.

CART_MODE_REPLACE

All items in the current cart will be deleted before the saved cart is restored into it. This is the default if no mode is specified.

CART_TYPE_SAVED

Marks the cart as permanent. Carts with this value set should never be automatically reaped from the database during cleanup.

CART_TYPE_TEMP

Any cart with this type could be purged form the database during cleanup at any time.

RETURNAS_AUTO

When calling load or items on Handel::Cart, it will attempt to return the most appropriate object. In list context, it will return a list. In scalar context, it will return a Handel::Iterator object. If the iterator only contains one item, that item will be returns instead.

RETURNAS_ITERATOR

Always return a Handel::Iterator object regardless of context or the amount of retults.

RETURNAS_LIST

Always return a list regardless of context or the amount of results.

RETURNAS_ARRAY

Same as RETURNAS_LIST

EXPORT_TAGS

The following %EXPORT_TAGS are defined for Handel::Constants. See Exporter for further details on using export tags.

:all

This exports all constants found in this module.

:cart

This exports all CART_* constants in this module.

:returnas

This exports all RETURNAS_* constants in this module.

AUTHOR

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