overtrue / laravel-shopping-cart Goto Github PK

View Code? Open in Web Editor NEW

391.0 28.0 80.0 118 KB

:shopping_cart: Shopping cart for Laravel Application.

License: MIT License

PHP 100.00%

shopping-cart laravel

laravel-shopping-cart's Introduction

Laravel Shopping Cart

Shopping cart for Laravel Application.

Installation

$ composer require "overtrue/laravel-shopping-cart:~2.0"

or add the following line to your project's composer.json:

"require": {
    "overtrue/laravel-shopping-cart": "~2.0"
}

then

$ composer update

After completion of the above, add the follow line to the section providers of config/app.php:

Overtrue\LaravelShoppingCart\ServiceProvider::class,

And add the follow line to the section aliases:

'ShoppingCart'      => Overtrue\LaravelShoppingCart\Facade::class,

Usage

Add item to cart

Add a new item.

Item | null ShoppingCart::add(
                    string | int $id,
                    string $name,
                    int $quantity,
                    int | float $price
                    [, array $attributes = []]
                 );

example:

$row = ShoppingCart::add(37, 'Item name', 5, 100.00, ['color' => 'red', 'size' => 'M']);
// Item:
//    id       => 37
//    name     => 'Item name'
//    qty      => 5
//    price    => 100.00
//    color    => 'red'
//    size     => 'M'
//    total    => 500.00
//    __raw_id => '8a48aa7c8e5202841ddaf767bb4d10da'
$rawId = $row->rawId();// get __raw_id
$row->qty; // 5
...

Update item

Update the specified item.

Item ShoppingCart::update(string $rawId, int $quantity);
Item ShoppingCart::update(string $rawId, array $arrtibutes);

example:

ShoppingCart::update('8a48aa7c8e5202841ddaf767bb4d10da', ['name' => 'New item name']);
// or only update quantity
ShoppingCart::update('8a48aa7c8e5202841ddaf767bb4d10da', 5);

Get all items

Get all the items.

Collection ShoppingCart::all();

example:

$items = ShoppingCart::all();

Get item

Get the specified item.

Item ShoppingCart::get(string $rawId);

example:

$item = ShoppingCart::get('8a48aa7c8e5202841ddaf767bb4d10da');

Remove item

Remove the specified item by raw ID.

boolean ShoppingCart::remove(string $rawId);

example:

ShoppingCart::remove('8a48aa7c8e5202841ddaf767bb4d10da');

Destroy cart

Clean Shopping Cart.

boolean ShoppingCart::destroy();
boolean ShoppingCart::clean(); // alias of destroy();

example:

ShoppingCart::destroy();// or ShoppingCart::clean();

Total price

Returns the total of all items.

int | float ShoppingCart::total(); // alias of totalPrice();
int | float ShoppingCart::totalPrice();

example:

$total = ShoppingCart::total();
// or
$total = ShoppingCart::totalPrice();

Count rows

Return the number of rows.

int ShoppingCart::countRows();

example:

ShoppingCart::add(37, 'Item name', 5, 100.00, ['color' => 'red', 'size' => 'M']);
ShoppingCart::add(37, 'Item name', 1, 100.00, ['color' => 'red', 'size' => 'M']);
ShoppingCart::add(37, 'Item name', 5, 100.00, ['color' => 'red', 'size' => 'M']);
ShoppingCart::add(127, 'foobar', 15, 100.00, ['color' => 'green', 'size' => 'S']);
$rows = ShoppingCart::countRows(); // 2

Count quantity

Returns the quantity of all items

int ShoppingCart::count($totalItems = true);

$totalItems : When false,will return the number of rows.

example:

ShoppingCart::add(37, 'Item name', 5, 100.00, ['color' => 'red', 'size' => 'M']);
ShoppingCart::add(37, 'Item name', 1, 100.00, ['color' => 'red', 'size' => 'M']);
ShoppingCart::add(37, 'Item name', 5, 100.00, ['color' => 'red', 'size' => 'M']);
$count = ShoppingCart::count(); // 11 (5+1+5)

Search items

Search items by property.

Collection ShoppingCart::search(array $conditions);

example:

$items = ShoppingCart::search(['color' => 'red']);
$items = ShoppingCart::search(['name' => 'Item name']);
$items = ShoppingCart::search(['qty' => 10]);

Check empty

bool ShoppingCart::isEmpty();

Specifies the associated model

Specifies the associated model of item before you add items to cart.

Cart ShoppingCart::associate(string $modelName);

example:

ShoppingCart::associate('App\Models\Product');

ShoppingCart::add(37, 'Item name', 5, 100.00, ['color' => 'red', 'size' => 'M']);

$item = ShoppingCart::get('8a48aa7c8e5202841ddaf767bb4d10da');
$item->product->name; // $item->product is instanceof 'App\Models\Product'

The Collection And Item

Collection and Overtrue\LaravelShoppingCart\Item are instanceof Illuminate\Support\Collection, Usage Refer to：Collections - Laravel doc.

properties of Overtrue\LaravelShoppingCart\Item:

id - your goods item ID.
name - Name of item.
qty - Quantity of item.
price - Unit price of item.
total - Total price of item.
__raw_id - Unique ID of row.
__model - Name of item associated Model.
... custom attributes.

And methods:

rawId() - Return the raw ID of item.

Events

Event Name	Parameters
`shopping_cart.adding`	($attributes, $cart);
`shopping_cart.added`	($attributes, $cart);
`shopping_cart.updating`	($row, $cart);
`shopping_cart.updated`	($row, $cart);
`shopping_cart.removing`	($row, $cart);
`shopping_cart.removed`	($row, $cart);
`shopping_cart.destroying`	($cart);
`shopping_cart.destroyed`	($cart);

You can easily handle these events, for example:

Event::listen('shopping_cart.adding', function($attributes, $cart){
    // code
});

PHP 扩展包开发

想知道如何从零开始构建 PHP 扩展包？

请关注我的实战课程，我会在此课程中分享一些扩展开发经验 —— 《PHP 扩展包实战教程 - 从入门到发布》

License

MIT

laravel-shopping-cart's People

Contributors

Stargazers

Watchers

laravel-shopping-cart's Issues

关于监听事件传入参数为空的BUG探讨

先看代码：

public function add($id, $name = null, $qty = null, $price = null, array $attributes = [])
    {
        $cart = $this->getCart();

        $this->event->fire('shopping_cart.adding', [$attributes, $cart]);

        $row = $this->addRow($id, $name, $qty, $price, $attributes);

        $this->event->fire('shopping_cart.added', [$attributes, $cart]);

        return $row;
    }

这一段是添加到购物车里面的代码，可以看到是先获取购物车，然后再添加到购物车，这时候触发added事件，传入的参数是$cart，可是这个是未添加入购物车之的，这样就导致传入的购物车实际上还是未添加状态的。应该要这样改：

$this->event->fire('shopping_cart.added', [$attributes, $this->getCart()]);

不知道这算是bug还有有意为之的feature？所有涉及到ed事件的应该都是存在这个问题的。

ShoppingCart::all(); return null

我$row = ShoppingCart::add();後查看$row資訊成功儲存
但我到別的controller ShoppingCart::all() 卻回傳空的

我根據$row的id下去 ShoppingCart::get('id'); 也是空的

composer 组件开发

在composer.json里面并没有看到你 require laravel 框架，但为何在代码里面却用到了laravel的组件。
另外，composer开发有相关的资料么，求推荐。我是雷俊，上回的线下聚会我也在。

Store in database and edit the order

I can get all the items and serialize that to store along with other order information.
I may need to edit the order to change the items or update the quantity or price. do you have any example of that? or is this package allow store and restore from database?

Update does not work during adding of the same item if quantity is different

Update does not work properly during adding of the same item if quantity is different

Cart::add(37, 'Item name', 5, 100.00, ['color' => 'red', 'size' => 'M']);
Cart::add(37, 'Item name', 1, 100.00, ['color' => 'red', 'size' => 'M']);
Cart::add(37, 'Item name', 5, 100.00, ['color' => 'red', 'size' => 'M']);

How to set cart name dynamically?

I want to set different carts for different vendors. How can I set a different cart name dynamically? Will have to call setName on each call? Please help.

Eager loading associate model

How i can Eager loading associate model for reduce query ?

About Specifies the associated model

我 dd ShoppingCart::associate('App\Models\Product') 的訊息
得到 #model: "App\Models\Product"
但我ShoppingCart::get('xxxxxxxx')取出購物車裡的商品時裡面的 #mode: null
請問這個功能確實有作用嗎？

文档中使用静态方法调用有误吧

安神,你文档中写的使用静态方式调用是错误的吧,要先new一个对象,方法中没有加静态

composer install error

两种安装方式都存在错误
一 composer require "overtrue/laravel-shopping-cart:1.0.*"
会提示如下错误。但是我本地已经安装了更高级的log-viewer 版本

二更新composer.json 文件后，进行composer update 操作
会出现如下错误

尝试多次后仍无法解决此问题。

第二种方式出现的symfony问题可能是官方的。

Undefined type

In my CartController.php I am pasting "use Overtrue\LaravelShoppingCart\ShoppingCart;" and

public function index()
{
return ShoppingCart::content();
}

But the error I am getting: "Undefined type 'Overtrue\LaravelShoppingCart\ShoppingCart'.intelephense(1009)"

Creates duplicate item in the cart list

When I tried to click the add to cart button pointing to the CartContoller I have made then redirect back to the previous page the cart items becomes duplicate. Please help

类中的fire方法替换dispatch方法

Illuminate/Events/Dispatcher 类中的fire 方法（在Larevel 5.4中不赞成使用，Larevel 5.8 已经被移除了）
应当使用它的替代方法 dispatch ,否则会报如下错误：
Oops! An unexpected error occurred: Call to undefined method Illuminate\Events\Dispatcher::fire()

public function add($id, $name = null, $qty = null, $price = null, array $attributes = [])
{
    $cart = $this->getCart();
    $this->event->dispatch('shopping_cart.adding', [$attributes, $cart]);
    $row = $this->addRow($id, $name, $qty, $price, $attributes);
    $this->event->dispatch('shopping_cart.added', [$attributes, $cart]);
    return $row;
}

overtrue / laravel-shopping-cart Goto Github PK

laravel-shopping-cart's Introduction

Laravel Shopping Cart

Installation

Usage

Add item to cart

Update item

Get all items

Get item

Remove item

Destroy cart

Total price

Count rows

Count quantity

Search items

Check empty

Specifies the associated model

The Collection And Item

Events

PHP 扩展包开发

License

laravel-shopping-cart's People

Contributors

Stargazers

Watchers

Forkers

laravel-shopping-cart's Issues

Recommend Projects

Recommend Topics

Recommend Org