README

联系表单插件

功能

• 扩展联系表单
• 向联系表单添加 ReCaptcha 验证（仅支持不可见的 ReCaptcha V2）
• 添加消息管理面板
  • 会话历史记录
  • 即时回复的可能性

安装

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

2. 将插件类添加到您的 config/bundles.php。

   return [
      ...
      MangoSylius\SyliusContactFormPlugin\MangoSyliusContactFormPlugin::class => ['all' => true],
   ];

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

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

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

   mango_sylius_contact_form:
       resource: "@MangoSyliusContactFormPlugin/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 一起工作，创建时必须选择此版本。
• 插件将渠道的联系方式（可在管理面板的“配置”部分中的“渠道”选项卡中配置）定义为管理员的电子邮件地址。

配置

 mango_sylius_contact_form:
     # 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 许可。

致谢

由 manGoweb 开发。