added 2 new useful CART APIs

Author: darryldecode

src/Darryldecode/Cart/Cart.php

@@ -221,6 +221,45 @@ public function update($id, $data)
         $this->save($cart);
     }
 
+    /**
+     * add condition on an existing item on the cart
+     *
+     * @param int|string $productId
+     * @param CartCondition $itemCondition
+     * @return $this
+     */
+    public function addItemCondition($productId, $itemCondition)
+    {
+        if( $product = $this->get($productId) )
+        {
+            $conditionInstance = "\\Darryldecode\\Cart\\CartCondition";
+
+            if( $itemCondition instanceof $conditionInstance )
+            {
+                // we need to copy first to a temporary variable to hold the conditions
+                // to avoid hitting this error "Indirect modification of overloaded element of Darryldecode\Cart\ItemCollection has no effect"
+                // this is due to laravel Collection instance that implements Array Access
+                // // see link for more info: http://stackoverflow.com/questions/20053269/indirect-modification-of-overloaded-element-of-splfixedarray-has-no-effect
+                $itemConditionTempHolder = $product['conditions'];
+
+                if( is_array($itemConditionTempHolder) )
+                {
+                    array_push($itemConditionTempHolder, $itemCondition);
+                }
+                else
+                {
+                    $itemConditionTempHolder = $itemCondition;
+                }
+
+                $this->update($productId, array(
+                    'conditions' => $itemConditionTempHolder // the newly updated conditions
+                ));
+            }
+        }
+
+        return $this;
+    }
+
     /**
      * removes an item on cart by item ID
      *
@@ -523,6 +562,25 @@ public function getTotal()
         return $newTotal;
     }
 
+    /**
+     * get total quantity of items in the cart
+     *
+     * @return int
+     */
+    public function getTotalQuantity()
+    {
+        $items = $this->getContent();
+
+        if( $items->isEmpty() ) return 0;
+
+        $count = $items->sum(function($item)
+        {
+            return $item['quantity'];
+        });
+
+        return $count;
+    }
+
     /**
      * get the cart
      *

tests/CartConditionsTest.php

@@ -327,6 +327,41 @@ public function test_add_item_with_multiple_item_conditions_with_one_condition_w
         $this->assertEquals(85.00, $this->cart->getSubTotal(), 'Cart subtotal with 1 item should be 70');
     }
 
+    public function test_add_item_condition()
+    {
+        $itemCondition2 = new CartCondition(array(
+            'name' => 'Item Gift Pack 25.00',
+            'type' => 'promo',
+            'target' => 'item',
+            'value' => '-25',
+        ));
+        $coupon101 = new CartCondition(array(
+            'name' => 'COUPON 101',
+            'type' => 'coupon',
+            'target' => 'item',
+            'value' => '-5%',
+        ));
+
+        $item = array(
+            'id' => 456,
+            'name' => 'Sample Item 1',
+            'price' => 100,
+            'quantity' => 1,
+            'attributes' => array(),
+            'conditions' => [$itemCondition2]
+        );
+
+        $this->cart->add($item);
+
+        // let's prove first we have 1 condition on this item
+        $this->assertCount(1, $this->cart->get($item['id'])['conditions'], "Item should have 1 condition");
+
+        // now let's insert a condition on an existing item on the cart
+        $this->cart->addItemCondition($item['id'], $coupon101);
+
+        $this->assertCount(2, $this->cart->get($item['id'])['conditions'], "Item should have 2 conditions");
+    }
+
     public function test_get_cart_condition_by_condition_name()
     {
         $itemCondition1 = new CartCondition(array(

tests/CartTest.php

@@ -400,4 +400,31 @@ public function test_clearing_cart()
         $this->assertTrue($this->cart->isEmpty(),'cart should now be empty');
     }
 
+    public function test_cart_get_total_quantity()
+    {
+        $items = array(
+            array(
+                'id' => 456,
+                'name' => 'Sample Item 1',
+                'price' => 67.99,
+                'quantity' => 3,
+                'attributes' => array()
+            ),
+            array(
+                'id' => 568,
+                'name' => 'Sample Item 2',
+                'price' => 69.25,
+                'quantity' => 1,
+                'attributes' => array()
+            ),
+        );
+
+        $this->cart->add($items);
+
+        $this->assertFalse($this->cart->isEmpty(),'prove first cart is not empty');
+
+        // now let's count the cart's quantity
+        $this->assertInternalType("int", $this->cart->getTotalQuantity(), 'Return type should be INT');
+        $this->assertEquals(4, $this->cart->getTotalQuantity(),'Cart\'s quantity should be 4.');
+    }
 }