Cart plugin for CakePHP

NOTE: It's still in development mode, do not use in production yet!

Requirements

It is developed for CakePHP min. 4.3.

Installation

You can install plugin into your CakePHP application using composer.

The recommended way to install composer packages is:

composer require kicaj/cart dev-master

Load the Plugin

Ensure the Cart plugin is loaded in your src/Application.php file

$this->addPlugin('Cart');

or add manually by cake command

cake plugin load Cart

Configuration

Firstly, use Migrations plugin to create tables in your database.

cake migrations migrate -p Cart

Now, if everything is correct, You can open URL with fragment localhost/app/cart/carts and You should see "Cart is empty".

Next, You should set global association to work with your products with Cart plugin.

// AppController::initialize()
public function initialize()
{
    parent::initialize();
        
    // ...
        
    // Cart relations.
    $this->loadModel('Cart.Carts');
        
    $this->Carts->CartItems->addAssociations([
        'belongsTo' => [
            'CartItemProducts' => [
                'className' => 'Products', // Class name of existing table of your products
                'type' => 'INNER',
                'foreignKey' => 'identifier',
                'bindingKey' => 'sku', // Unique key for your product (eg. SKU number)
            ],
        ],
    ]);
}   

The last thing you should do is add button "Add do cart" in your product view.
Open view of product, probably src/Template/Products/view.ctp and load the cell:

echo $this->cell('Cart.Cart::add', [$product->sku]); // First argument is product unique identiefier

Check again localhost/app/cart/cars!

That's all!

Troubleshooting

1. I'm getting message "SQLSTATE[23000]: Integrity constraint violation: 1048 Column 'price' cannot be null" when I clicked "Add to cart" button.
   If You haven't got column price in Your relation table (eg. products), then you can set virtual property in /Model/Entity/Product.php.

protected $_virtual = ['price'];

protected function _getPrice()
{
    return $this->cost; // Field cost (or value, amout, etc.) in Your table
}