Nitesi::Cart - Cart class for Nitesi Shop Machine
Generic cart class for Nitesi.
Each item in the cart has at least the following attributes:
Unique item identifier.
Item name.
Item quantity.
Item price.
Initializer which receives the constructor arguments, but does nothing. May be overridden in a subclass.
Returns items in the cart.
Returns subtotal of the cart.
Returns total of the cart.
Add item to the cart. Returns item in case of success.
The item is a hash (reference) which is subject to the following conditions:
Item identifier is required.
Item name is required.
Item quantity is optional and has to be a natural number greater than zero. Default for quantity is 1.
Item price is required and a positive number.
Price is required, because you want to maintain the price that was valid at the time of adding to the cart. Should the price in the shop change in the meantime, it will maintain this price. If you would like to update the pages, you have to do it before loading the cart page on your shop.
Example: Add 5 BMX2012 products to the cart
$cart->add( sku => 'BMX2012', quantity => 5, price => 200);
Example: Add a BMX2012 product to the cart.
$cart->add( sku => 'BMX2012', price => 200);
Remove item from the cart. Takes SKU of item to identify the item.
Update quantity of items in the cart.
Parameters are pairs of SKUs and quantities, e.g.
$cart->update(9780977920174 => 5, 9780596004927 => 3);
Triggers before_cart_update and after_cart_update hooks.
A quantity of zero is equivalent to removing this item, so in this case the remove hooks will be invoked instead of the update hooks.
Removes all items from the cart.
Searches for an cart item with the given SKU. Returns cart item in case of sucess.
if ($item = $cart->find(9780977920174)) { print "Quantity: $item->{quantity}.\n"; }
Returns the sum of the quantity of all items in the shopping cart, which is commonly used as number of items. If you have 5 apples and 6 pears it will return 11.
print 'Items in your cart: ', $cart->quantity, "\n";
Returns the time (epoch) when the cart was created.
Returns the time (epoch) when the cart was last modified.
Returns the number of different items in the shopping cart. If you have 5 apples and 6 pears it will return 2 (2 different items).
Apply cost to cart. apply_cost is a generic method typicaly used for taxes, discounts, coupons, gift certificates,...
Example: Absolute cost
Uses absolute value for amount. Amount 5 is 5 units of currency used (ie. $5). $cart->apply_cost(amount => 5, name => 'shipping', label => 'Shipping');
Example: Relative cost
Uses percentage instead of value for amount. Amount 0.19 in example is 19%. relative is a boolean value (0/1). $cart->apply_cost(amount => 0.19, name => 'tax', label => 'VAT', relative => 1);
Example: Inclusive cost
Same as relative cost, but it assumes that tax was included in the subtotal already, and only displays it (19% of subtotal value in example). Inclusive is a boolean value (0/1). $cart->apply_cost(amount => 0.19, name => 'tax', label => 'Sales Tax', relative => 1, inclusive => 1);
It removes all the costs previously applied (using apply_cost). Used typically if you have free shipping or something similar, you can clear the costs.
Returns particular cost by position or by name.
Example: Return tax value by name
$cart->cost('tax'); Returns value of the tax (absolute value in your currency, not percantage)
Example: Return tax value by position
$cart->cost(0); Returns the cost that was first applied to subtotal. By increasing the number you can retrieve other costs applied.
Get or set id of the cart. This can be used for subclasses, e.g. primary key value for carts in the database.
Get or set the name of the cart.
Returns last error.
Seeds items within the cart from $item_ref.
Example:
$cart->seed([ { sku => 'BMX2015', price => 20, quantity = 1 }, { sku => 'KTM2018', price => 400, quantity = 5 }, { sku => 'DBF2020', price => 200, quantity = 5 }, ]);
Stefan Hornburg (Racke), <racke@linuxia.de>
Copyright 2011-2012 Stefan Hornburg (Racke) <racke@linuxia.de>.
This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.
See http://dev.perl.org/licenses/ for more information.
To install Nitesi, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Nitesi
CPAN shell
perl -MCPAN -e shell install Nitesi
For more information on module installation, please visit the detailed CPAN module installation guide.