README

联系表单插件

功能

• 扩展联系表单
• 将 ReCaptcha 验证添加到联系表单中（仅支持不可见 ReCaptcha V2）
• 添加消息管理面板
  • 会话历史
  • 可以即时回复

安装

1. 运行 $ composer require 3brs/sylius-contact-form-plugin。

2. 在您的 Kernel 中注册 \ThreeBRS\SyliusContactFormPlugin\ThreeBRSSyliusContactFormPlugin。

3. 将资源添加到 config/packages/_sylius.yaml

   imports:
        ...
        - { resource: "@ThreeBRSSyliusContactFormPlugin/Resources/config/config.yml" }

4. 将路由添加到 config/_routes.yaml

   threebrs_sylius_contact_form_plugin:
       resource: "@ThreeBRSSyliusContactFormPlugin/Resources/config/routing.yml"

5. 在 .env 文件中定义参数

   # Recaptcha public key setter for contact form
   GOOGLE_RECAPTCHA_SITE_KEY=
   # Recaptcha secret key setter for contact form
   GOOGLE_RECAPTCHA_SECRET=
   

6. 创建并运行 doctrine 数据库迁移

有关如何使用自己的实体的指南，请参阅 Sylius 文档 - 自定义模型

使用方法

• 如果您想在不进行 reCaptcha 验证的情况下运行插件，则可以将参数留空。
• 该插件旨在与不可见的 V2 reCaptcha 一起使用，因此在其创建过程中必须选择此版本。
• 该插件将渠道（可在管理面板的“配置”部分的“渠道”选项卡中配置）的联系电子邮件地址定义为管理员的电子邮件地址。

配置

 threebrs_sylius_contact_form_plugin:
     # Define if an email should be send to the manager when contact form is send
       send_manager_mail: true/false
     # Define if an email should be send to the customer when contact form is send (copy)
       send_customer_mail: true/false
     # Define 'name' field requirement in contact form
       name_required: true/false
     # Define 'phone' field requirement in contact form
       phone_required: true/false

使用方法

• 以管理员身份登录管理面板或以注册客户身份登录账户面板
• 进入“消息”部分
• 选择您想要回复的会话
• 编写您的回复消息
• 单击下面的“发送”按钮

开发

使用方法

• 从 .env.dist 创建到 .env 的符号链接或创建您自己的 .env 文件
• 在 /src 中开发您的插件
• 在 bin/ 中查看有用的命令

测试

在您的更改之后，您必须确保测试仍然通过。

$ composer install
$ bin/console doctrine:schema:create -e test
$ bin/behat.sh
$ bin/phpstan.sh
$ bin/ecs.sh

许可

此库受 MIT 许可证的约束。

致谢

由 3BRS 开发
从 manGoweb 分支。