README

此插件向客户添加了一个选项，可以将他们的订单标记为送给另一个人。此信息通过订单的备注字段传递。

• 安装
• 故障排除

安装

步骤 1：下载插件

$ composer require tomsgu/sylius-gift-plugin

此命令要求您全局安装 Composer，具体请参阅 Composer 文档中的安装章节。

步骤 2：启用插件

通过将其添加到已注册的包列表中启用插件

<?php
# config/bundles.php

return [
    // ...
    
    Tomsgu\SyliusGiftPlugin\TomsguSyliusGiftPlugin::class => ['all' => true],
    
    // It is important to add plugin before the grid bundle
    Sylius\Bundle\GridBundle\SyliusGridBundle::class => ['all' => true],
    
    // ...
];

步骤 3：导入配置

# config/packages/_sylius.yaml
imports:
    # ...
    - { resource: '@TomsguSyliusGiftPlugin/Resources/config/app/config.yaml' }
    # ...

步骤 4：导入路由

# config/routes/tomsgu_sylius_gift.yaml

tomsgu_sylius_gift_admin:
    resource: "@TomsguSyliusGiftPlugin/Resources/config/routes/admin.yaml"
    prefix: /admin

步骤 5：更新数据库模式

$ php bin/console doctrine:migrations:diff
$ php bin/console doctrine:migrations:migrate

步骤 6：覆盖结账完成表单

覆盖以下Sylius 表单

• 如果您尚未覆盖 templates/bundles/SyliusShopBundle/Checkout/Complete/_form.html.twig 模板，请将 src/Resources/views/bundles/SyliusShopBundle/Checkout/Complete/_form.html.twig 文件复制到： templates/bundles/SyliusShopBundle/Checkout/Complete/_form.html.twig

  $ cp vendor/tomsgu/sylius-gift-plugin/src/Resources/views/bundles/SyliusShopBundle/Checkout/Complete/_form.html.twig \
  templates/bundles/SyliusShopBundle/Checkout/Complete/_form.html.twig

• 如果您已覆盖它，请将以下片段添加到该模板中

  {# templates/bundles/SyliusShopBundle/Checkout/Complete/_form.html.twig #}
  {% if form.gift_option is defined %}
      {{ form_row(form.gift_option) }}
  {% endif %}

故障排除

• 如果您遇到 您请求的参数 "tomsgu_sylius_gift.model.gift_option.class" 不存在 异常，必须在网格包之前实例化插件。请参阅步骤 3：导入配置部分。