README

该模块代表了一个在线商店的后端。

包括管理（CRUD）功能：

• 分类
• 制造商
• 产品
• 价格
• 过滤器（选项）
• 附加字段

如有需要，也可以使用我的其他模块

• pistol88/yii2-cart - 购物车
• pistol88/yii2-order - 订单
• pistol88/yii2-promocode - 优惠码

安装

建议在 common/modules/pistol88 下安装

git clone https://github.com/pistol88/yii2-shop.git

并通过 composer.json 中的 psr-4 部分进行连接

"autoload": {
    "psr-4": {
        "pistol88\\shop\\": "common/modules/pistol88/yii2-shop"
    }
}

该模块依赖于许多其他包，请将其从我的 composer.json 复制到您的 composer.json 中的 require 部分。然后不要忘记执行 composer update 和每个模块的迁移。

如果您想通过 composer 将其安装到 vendor 目录并保持不变，请按照标准操作：在命令行中执行 'php composer require pistol88/yii2-shop' 和 'php composer update'。

迁移

php yii migrate --migrationPath=vendor/pistol88/yii2-shop/migrations

配置

在配置文件（可能是 bootstrap.php）中添加

Yii::setAlias('@storageUrl','/frontend/web/images');

在配置文件的 modules 部分添加

    'modules' => [
        //..
        'shop' => [
            'class' => 'pistol88\shop\Module',
            'adminRoles' => ['administrator'],
        ],
        'filter' => [
            'class' => 'pistol88\filter\Module',
            'adminRoles' => ['administrator'],
            'relationFieldName' => 'category_id',
            'relationFieldValues' =>
                function() {
                    return \pistol88\shop\models\Category::buildTextTree();
                },
        ],
        'field' => [
            'class' => 'pistol88\field\Module',
            'relationModels' => [
                'pistol88\shop\models\Product' => 'Продукты',
                'pistol88\shop\models\Category' => 'Категории',
                'pistol88\shop\models\Producer' => 'Производители',
            ],
            'adminRoles' => ['administrator'],
        ],
        'relations' => [
            'class' => 'pistol88\relations\Module',
            'fields' => ['code'],
        ],
        'gallery' => [
            'class' => 'pistol88\gallery\Module',
            'imagesStorePath' => dirname(dirname(__DIR__)).'/storage/web/images/store',
            'imagesCachePath' => dirname(dirname(__DIR__)).'/storage/web/images/cache',
            'graphicsLibrary' => 'GD',
            'placeHolderPath' => dirname(dirname(__DIR__)).'/storage/web/images/placeHolder.png',
        ],
        //..
    ]

在 shop 中可以传递 modelMap，其中指定所需的模型。也可以指定标准的 yii controllerMap 和 viewPath，以替换您的商店开发过程中的控制器和视图。

在 components 部分中

    'components' => [
        //..
        'fileStorage' => [
            'class' => '\trntv\filekit\Storage',
            'baseUrl' => '@storageUrl/source',
            'filesystem'=> function() {
                $adapter = new \League\Flysystem\Adapter\Local(dirname(dirname(__DIR__)).'/frontend/web/images/source');
                return new League\Flysystem\Filesystem($adapter);
            },
        ],
        //..
    ]

使用

• ?r=shop/product - 产品
• ?r=shop/category - 分类
• ?r=shop/producer - 制造商
• ?r=filter/filter - 过滤器（选项）
• ?r=field/field - 附加字段

小部件

• pistol88\shop\widgets\ShowPrice - 传递 'model'，输出价格。通过 jQuery 事件与 pistol88\cart\widgets\ChangeOptions 相关联，可以确定所选修改并动态更改价格。

商品卡片示例，其中包含商店和购物车的小部件，它们协同工作并动态更改彼此的数据。

<?php
use pistol88\shop\widgets\ShowPrice;
use pistol88\cart\widgets\BuyButton;
use pistol88\cart\widgets\TruncateButton;
use pistol88\cart\widgets\CartInformer;
use pistol88\cart\widgets\ElementsList;
use pistol88\cart\widgets\ChangeCount;
use pistol88\cart\widgets\ChangeOptions;

$product = \pistol88\shop\models\Product::findOne(1); //from controller
?>
<div class="site-index">
    <h1><?=$product->name;?></h1>
    
    <h2>Shop</h2>
    <div class="block row">
        <h3>ShowPrice</h3>
        <?=ShowPrice::widget(['model' => $product]);?>
    </div>
    
    <h2>Cart</h2>
    <div class="block row">
        <div class="col-md-3">
            <h3>ChangeCount</h3>
            <?=ChangeCount::widget(['model' => $product]);?>
        </div>
        <div class="col-md-3">
            <h3>ChangeOptions</h3>
            <?=ChangeOptions::widget(['model' => $product]);?>
        </div>
        <div class="col-md-3">
            <h3>BuyButton</h3>
            <?=BuyButton::widget(['model' => $product]);?>
        </div>
        <div class="col-md-3">
            <h3>TruncateButton</h3>
            <?=TruncateButton::widget();?>
        </div>
        <div class="col-md-3">
            <h3>CartInformer</h3>
            <?=CartInformer::widget();?>
        </div>
        <div class="col-md-3">
            <h3>ElementsList</h3>
            <?=ElementsList::widget(['type' => 'dropdown']);?>
        </div>
    </div>
    
    <style>
        .block {
            border: 2px solid blue;
        }
    </style>
    
</div>