, (*1)
Installation
1 - After install Laravel framework, insert on file composer.json, inside require object this value, (*2)
"syscover/shopping-cart": "~2.0"
and execute on console:, (*3)
composer update
2 - Register service provider, on file config/app.php add to providers array, (*4)
Syscover\ShoppingCart\ShoppingCartServiceProvider::class,
And register alias, on file config/app.php add to aliases array, (*5)
'CartProvider' => Syscover\ShoppingCart\Facades\CartProvider::class,
3 - Execute publish command, (*6)
php artisan vendor:publish
To run laravel testing
publish testing files, (*7)
php artisan vendor:publish --provider="Syscover\ShoppingCart\ShoppingCartServiceProvider"
and run the test using the following command:, (*8)
phpunit tests/ShoppingCartProviderTest
General configuration environment values
We indicate configuration variables available, to change them what you should do from the file environment variables .env, (*9)
Set product price tax [default value 1]
Defines the types of prices that are introduced in products, this option is consulted when you create or update a product
You have this values:
* Value: 1 Excluding tax
* Value: 2 Including tax, (*10)
TAX_PRODUCT_PRICES=1
Set shipping price tax [default value 1]
Defines the types of prices that are introduced in shipping prices, this option is consulted when you create or update a shipping price
* Value: 1 Excluding tax
* Value: 2 Including tax, (*11)
TAX_SHIPPING_PRICES=1
Set product display price tax [default value 1]
Defines how you want display product prices
You have this values:
* Value: 1 Excluding tax
* Value: 2 Including tax, (*12)
TAX_PRODUCT_DISPLAY_PRICES=1
Set shipping display price tax [default value 1]
Defines how you want display shipping prices
* Value: 1 Excluding tax
* Value: 2 Including tax, (*13)
TAX_SHIPPING_DISPLAY_PRICES=1
The Item Cart gives you the following methods to use:
To add items we have create a Item object with this properties:
* id:string = Id of product
* name:string = Name of product
* quantity:float = Quantity of product than you want add
* inputPrice:float = Price product by unit
* weight:float [default 1.000] = Weight of product
* transportable:boolean [default true] = Set if product can to be delivery
* taxRule:TaxRule[] [default []] = Set tax rules for this product
* options:array [default []] = Set a associative array to set custom options, (*14)
Add car item to cart, you need create Item objects to add cart, you can use a Item object or Items array if you want add various elements., (*15)
// Basic add Item to Cart
CartProvider::instance()->add(new Item('293ad', 'Product 1', 1, 9.99));
// Multiple add Items to Cart
CartProvider::instance()->add([
new Item('293ad', 'Product 1', 1, 9.99),
new Item('979ze', 'Product 2', 1, 12.90)
]);
// Multiple add Items with options to Cart
CartProvider::instance()->add([
new Item('293ad', 'Product 1', 1, 9.99, 1.000, true, [], ['size' => 'L']),
new Item('979ze', 'Product 2', 1, 12.90, 1.000, true, [], ['size' => 'M'])
]);
We have created TaxRule object to calculate tax from shopping cart, this object has this properties:
* name:string = Name of tax
* taxRate:float = Percentage of tax
* priority:int [default 0] = Order to calculate tax over subtotal. If are different priorities, the highest tax is calculated on the subtotal more taxes lower priority
* sortOrder:int [default 0] = Order to appear tax on screen, (*16)
Cart is ready to TaxRule object, you can add tax rules to each cartItem object. You can add only one TaxRule or various with a array tax rules, (*17)
// Multiple add Items to Cart with options and one tax rule
CartProvider::instance()->add([
new Item('293ad', 'Product 1', 1, 9.99, 1.000, true, new TaxRule('IVA', 21), ['size' => 'L']),
new Item('979ze', 'Product 2', 1, 12.90, 1.000, true, new TaxRule('IVA', 21), ['size' => 'M'])
]);
// Multiple add Items to Cart with options and various tax rules
CartProvider::instance()->add([
new Item('293ad', 'Product 1', 1, 9.99, 1.000, true, [
new TaxRule('IVA', 21, 0, 0),
new TaxRule('Customs', 10, 1, 1),
], ['size' => 'L']),
new Item('979ze', 'Product 2', 1, 12.90, 1.000, true,
new TaxRule('IVA', 21, 0, 0),
new TaxRule('Customs', 10, 1, 1),
], ['size' => 'M'])
]);
Once defined the rules, you can change them using this method, (*18)
foreach (CartProvider::instance()->getCartItems() as $item)
{
$item->resetTaxRules();
}
Of course, you can also reload other rules if necessary, (*19)
foreach (CartProvider::instance()->getCartItems() as $item)
{
$item->addTaxRule(new TaxRule('IVA', 18, 0, 0),);
}
Remember this, if you reset taxRules or add new tax rules to item, you must force calculate amounts from subtotal, (*20)
$item->calculateAmounts(Cart::PRICE_WITHOUT_TAX);
To update quantity from a item you have setQuantity method, you'll pass the update method the rowId and the new quantity, (*21)
$rowId = 'da39a3ee5e6b4b0d3255bfef95601890afd80709';
CartProvider::instance()->setQuantity($rowId, 2);
If you want to update more attributes of the item, you can pass Item object to the update method with rowId from item to update., (*22)
CartProvider::instance()->update($rowId, new Item('293ad', 'Product 1', 1, 19.99, 1.000, true, new TaxRule('IVA', 21), ['size' => 'L']));
To remove element from the cart, the remove() method on the cart and pass it the rowId, (*23)
$rowId = 'da39a3ee5e6b4b0d3255bfef95601890afd80709';
CartProvider::instance()->remove($rowId);
If you want to get the cart items, you have getCartItems method.
This method will return a Collection of CartItems which you can iterate over and show the content to your customers., (*24)
CartProvider::instance()->getCartItems();
If you want to get quantity from each items, you can use getQuantity method over each item, (*25)
foreach(CartProvider::instance()->getCartItems() as $item)
{
$item->getQuantity();
}
If you want to get an item from the cart using its rowId, you can simply call the get() method on the cart and pass it the rowId., (*26)
$rowId = 'da39a3ee5e6b4b0d3255bfef95601890afd80709';
CartProvider::instance()->getCartItems()->get($rowId);
If you want to completely remove the content of a cart, you can call the destroy method on the cart. This will remove all CartItems from the cart for the current cart instance., (*27)
CartProvider::instance()->destroy();
Get the subtotal price, without tax, (*28)
CartProvider::instance()->subtotal;
// or subtotal price formatted
CartProvider::instance()->getSubtotal();
Get tax amount from all items, (*29)
CartProvider::instance()->taxAmount;
// or tax amount formatted
CartProvider::instance()->getTaxAmount();
To get total price, (*30)
CartProvider::instance()->total;
// or total price formatted
CartProvider::instance()->getTotal();
To set shipping amount, (*31)
CartProvider::instance()->shippingAmount = 10.00;
To get shipping amount, (*32)
CartProvider::instance()->shippingAmount;
// or shipping amount formatted
CartProvider::instance()->getShippingAmount();
To know if cart contain any item transportable, you have method, (*33)
CartProvider::instance()->hasItemTransportable();
Get the number of items in the cart, total items, (*34)
CartProvider::instance()->getQuantity();
To find an item in the cart, you can use the search() method.
As you can see the Closure will receive two parameters. The first is the CartItem to perform the check against. The second parameter is the rowId of this CartItem., (*35)
The method will return a Collection containing all Items that where found, (*36)
This way of searching gives you total control over the search process and gives you the ability to create very precise and specific searches., (*37)
CartProvider::instance()->search(function ($cartItem, $rowId) {
return $cartItem->id === 1;
});
The package also supports multiple instances of the cart. The way this works is like this:
You can set the current instance of the cart with CartProvider::instance('newInstance'), at that moment, the active instance of the cart is newInstance, so when you add, remove or get the content of the cart, you work with the newInstance instance of the cart.
If you want to switch instances, you just call CartProvider::instance('otherInstance') again, and you're working with the otherInstance again., (*38)
The default cart instance is called default, so when you're not using instances, CartProvider::instance()->getCartItems(); is the same as CartProvider::instance('default')->getCartItems()., (*39)
So a little example:, (*40)
CartProvider::instance('shopping')->add(new Item('192ao12', 'Product 1', 1, 9.99));
// Get items of the 'shopping' cart
CartProvider::instance('shopping')->getCartItems();
CartProvider::instance('wishlist')->add(new Item('sdjk922', 'Product 2', 1, 19.95));
// Get items of the 'wishlist' cart
CartProvider::instance('wishlist')->getCartItems();
We have created PriceRule object to apply discounts over items cart
* name:string = Name of price rule
* description:string = Description of rule
* discountType:int = You have various options, below you have all options
* freeShipping:boolean [default false] = Check this option to set a rule whith free shipping
* discountFixed:float [default null] = Set a discount amount fixed
* discountPercentage:float [default null] = Set a rate percentage to discount
* maximumDiscountAmount:float [default null] = If you choose a discount percentage, you can set a maximum amount to discount
* applyShippingAmount:boolean [default false] = Check this option if you want apply discount to shipping amount too
* combinable:boolean [default true] = Set if this price rule can to have other one in the same cart, (*41)
With this constants from PriceRule class, you can define discount type, (*42)
WITHOUT_DISCOUNT
DISCOUNT_SUBTOTAL_PERCENTAGE
DISCOUNT_SUBTOTAL_FIXED_AMOUNT
DISCOUNT_TOTAL_PERCENTAGE
DISCOUNT_TOTAL_FIXED_AMOUNT
To set price rules you can use addCartPriceRule methop, (*43)
CartProvider::instance()->addCartPriceRule(
new PriceRule(
'My first price rule', // name
'For being a good customer', // description
PriceRule::DISCOUNT_SUBTOTAL_PERCENTAGE, // discount type
false, // free shipping
10.00 // discount fixed amount
)
);
Scenarios to consider when applying to the pricing rules
* We have created discounts over subtotal and total price, but you can not apply both discounts to the same cart.
* If apply percentage discount and fixed, first will apply fixed discount and last the percentage discount., (*44)
Wallogit.com
