1. Go to this page and download the library: Download ozanmuyes/laravel5cart library. Choose the download type require.
2. Extract the ZIP file and open the index.php.
3. Add this code to the index.php.
<?php
require_once('vendor/autoload.php');
/* Start to develop here. Best regards https://php-download.com/ */
/**
* add item to the cart, it can be an array or multi dimensional array
*
* @param string|array $id
* @param string $name
* @param float $price
* @param int $quantity
* @param array $attributes
* @param CartCondition|array $conditions
* @return $this
* @throws InvalidItemException
*/
// Simplest form to add item on your cart
Cart::add(455, 'Sample Item', 100.99, 2, array());
// array format
Cart::add(array(
'id' => 456,
'name' => 'Sample Item',
'price' => 67.99,
'quantity' => 4,
'attributes' => array()
));
// add multiple items at one time
Cart::add(array(
array(
'id' => 456,
'name' => 'Sample Item 1',
'price' => 67.99,
'quantity' => 4,
'attributes' => array()
),
array(
'id' => 568,
'name' => 'Sample Item 2',
'price' => 69.25,
'quantity' => 4,
'attributes' => array(
'size' => 'L',
'color' => 'blue'
)
),
));
// NOTE:
// Please keep in mind that when adding an item on cart, the "id" should be unique as it serves as
// row identifier as well. If you provide same ID, it will assume the operation will be an update to its quantity
// to avoid cart item duplicates
/**
* update a cart
*
* @param $id (the item ID)
* @param array $data
*
* the $data will be an associative array, you don't need to pass all the data, only the key value
* of the item you want to update on it
*/
Cart::update(456, array(
'name' => 'New Item Name', // new item name
'price' => 98.67, // new item price, price can also be a string format like so: '98.67'
));
// you may also want to update a product's quantity
Cart::update(456, array(
'quantity' => 2, // so if the current product has a quantity of 4, another 2 will be added so this will result to 6
));
// you may also want to update a product by reducing its quantity, you do this like so:
Cart::update(456, array(
'quantity' => -1, // so if the current product has a quantity of 4, it will subtract 1 and will result to 3
));
// NOTE: as you can see by default, the quantity update is relative to its current value
// if you want to just totally replace the quantity instead of incrementing or decrementing its current quantity value
// you can pass an array in quantity value like so:
Cart::update(456, array(
'quantity' => array(
'relative' => false,
'value' => 5
),
));
// so with that code above as relative is flagged as false, if the item's quantity before is 2 it will now be 5 instead of
// 5 + 2 which results to 7 if updated relatively..
/**
* removes an item on cart by item ID
*
* @param $id
*/
Cart::remove(456);
/**
* get an item on a cart by item ID
* if item ID is not found, this will return null
*
* @param $itemId
* @return null|array
*/
$itemId = 456;
Cart::get($itemId);
// You can also get the sum of the Item multiplied by its quantity, see below:
$summedPrice = Cart::get($itemId)->getPriceSum();
/**
* get the cart
*
* @return CartCollection
*/
$cartCollection = Cart::getContent();
// NOTE: Because cart collection extends Laravel's Collection
// You can use methods you already know about Laravel's Collection
// See some of its method below:
// count carts contents
$cartCollection->count();
// transformations
$cartCollection->toArray();
$cartCollection->toJson();
/**
* check if cart is empty
*
* @return bool
*/
Cart::isEmpty();
/**
* get total quantity of items in the cart
*
* @return int
*/
$cartTotalQuantity = Cart::getTotalQuantity();
/**
* get cart sub total
*
* @return float
*/
$subTotal = Cart::getSubTotal();
/**
* the new total in which conditions are already applied
*
* @return float
*/
$total = Cart::getTotal();
// add single condition on a cart bases
$condition = new \Ozanmuyes\Cart\CartCondition(array(
'name' => 'VAT 12.5%',
'type' => 'tax',
'target' => 'subtotal',
'value' => '12.5%',
'attributes' => array( // attributes field is optional
'description' => 'Value added tax',
'more_data' => 'more data here'
)
));
Cart::condition($condition);
// or add multiple conditions from different condition instances
$condition1 = new \Ozanmuyes\Cart\CartCondition(array(
'name' => 'VAT 12.5%',
'type' => 'tax',
'target' => 'subtotal',
'value' => '12.5%',
));
$condition2 = new \Ozanmuyes\Cart\CartCondition(array(
'name' => 'Express Shipping $15',
'type' => 'shipping',
'target' => 'subtotal',
'value' => '+15',
));
Cart::condition($condition1);
Cart::condition($condition2);
// or add multiple conditions as array
Cart::condition([$condition1, $condition2]);
// To get all applied conditions on a cart, use below:
$cartConditions = Cart::getConditions();
foreach($carConditions as $condition)
{
$condition->getTarget(); // the target of which the condition was applied
$condition->getName(); // the name of the condition
$condition->getType(); // the type
$condition->getValue(); // the value of the condition
$condition->getAttributes(); // the attributes of the condition, returns an empty [] if no attributes added
}
// You can also get a condition that has been applied on the cart by using its name, use below:
$condition = Cart::getCondition('VAT 12.5%');
$condition->getTarget(); // the target of which the condition was applied
$condition->getName(); // the name of the condition
$condition->getType(); // the type
$condition->getValue(); // the value of the condition
$condition->getAttributes(); // the attributes of the condition, returns an empty [] if no attributes added
// You can get the conditions calculated value by providing the subtotal, see below:
$subTotal = Cart::getSubTotal();
$condition = Cart::getCondition('VAT 12.5%');
$conditionCalculatedValue = $condition->getCalculatedValue($subTotal);
$cartTotal = Cart::getTotal(); // the total will be calculated based on the conditions you ave provided
// lets create first our condition instance
$saleCondition = new \Ozanmuyes\Cart\CartCondition(array(
'name' => 'SALE 5%',
'type' => 'tax',
'target' => 'item',
'value' => '-5%',
));
// now the product to be added on cart
$product = array(
'id' => 456,
'name' => 'Sample Item 1',
'price' => 100,
'quantity' => 1,
'attributes' => array(),
'conditions' => $saleCondition
);
// finally add the product on the cart
Cart::add($product);
// you may also add multiple condition on an item
$itemCondition1 = new \Ozanmuyes\Cart\CartCondition(array(
'name' => 'SALE 5%',
'type' => 'sale',
'target' => 'item',
'value' => '-5%',
));
$itemCondition2 = new CartCondition(array(
'name' => 'Item Gift Pack 25.00',
'type' => 'promo',
'target' => 'item',
'value' => '-25',
));
$itemCondition3 = new \Ozanmuyes\Cart\CartCondition(array(
'name' => 'MISC',
'type' => 'misc',
'target' => 'item',
'value' => '+10',
));
$item = array(
'id' => 456,
'name' => 'Sample Item 1',
'price' => 100,
'quantity' => 1,
'attributes' => array(),
'conditions' => [$itemCondition1, $itemCondition2, $itemCondition3]
);
Cart::add($item);
$cartSubTotal = Cart::getSubTotal(); // the subtotal will be calculated based on the conditions you have provided
/**
* clears all conditions on a cart,
* this does not remove conditions that has been added specifically to an item/product.
* If you wish to remove a specific condition to a product, you may use the method: removeItemCondition($itemId,$conditionName)
*
* @return void
*/
Cart::clearCartConditions()
/**
* removes a condition on a cart by condition name,
* this can only remove conditions that are added on cart bases not conditions that are added on an item/product.
* If you wish to remove a condition that has been added for a specific item/product, you may
* use the removeItemCondition(itemId, conditionName) method instead.
*
* @param $conditionName
* @return void
*/
$conditionName = 'Summer Sale 5%';
Cart::removeCartCondition($conditionName)
/**
* remove a condition that has been applied on an item that is already on the cart
*
* @param $itemId
* @param $conditionName
* @return bool
*/
Cart::removeItemCondition($itemId, $conditionName)
/**
* Get all the condition filtered by Type
* Please Note that this will only return condition added on cart bases, not those conditions added
* specifically on an per item bases
*
* @param $type
* @return CartConditionCollection
*/
public function getConditionsByType($type)
/**
* Remove all the condition with the $type specified
* Please Note that this will only remove condition added on cart bases, not those conditions added
* specifically on an per item bases
*
* @param $type
* @return $this
*/
public function removeConditionsByType($type)
$this->app['wishlist'] = $this->app->share(function($app)
{
$storage = $app['session']; // laravel session storage
$events = $app['events']; // laravel event handler
$instanceName = 'wishlist'; // your cart instance name
$session_key = 'AsASDMCks0ks1'; // your unique session key to hold cart items
return new Cart(
$storage,
$events,
$instanceName,
$session_key
);
});
// add items to cart
Cart::add(array(
array(
'id' => 456,
'name' => 'Sample Item 1',
'price' => 67.99,
'quantity' => 4,
'attributes' => array()
),
array(
'id' => 568,
'name' => 'Sample Item 2',
'price' => 69.25,
'quantity' => 4,
'attributes' => array(
'size' => 'L',
'color' => 'blue'
)
),
));
// then you can:
$items = Cart::getContent();
foreach($items as $item)
{
$item->id; // the Id of the item
$item->name; // the name
$item->price; // the price
$item->quantity; // the quantity
$item->attributes; // the attributes
// Note that attribute returns ItemAttributeCollection object that extends the native laravel collection
// so you can do things like below:
if( $item->attributes->has('size') )
{
// item has attribute size
}
else
{
// item has no attribute size
}
}
// or
$items->each(function($item)
{
$item->id; // the Id of the item
$item->name; // the name
$item->price; // the price
$item->quantity; // the quantity
$item->attributes; // the attributes
if( $item->attributes->has('size') )
{
// item has attribute size
}
else
{
// item has no attribute size
}
});
Loading please wait ...
Before you can download the PHP files, the dependencies should be resolved. This can take some minutes. Please be patient.