README

这是一个基于事件的 Symfony2 联系包。

安装

使用 composer 安装包

 $ composer require dankempster/contact-bundle:1.0.*

将包添加到您的 AppKernel 类

    public function registerBundles()
    {
        return array(
            // ... Your bundles
            new \FrequenceWeb\Bundle\ContactBundle\FrequenceWebContactBundle(),
        );
    }

配置

此包提供了一些配置选项

frequence_web_contact:
    send_mails: true                # True to use the bundle EmailListener that send emails when contact form is submited
    to:         null                # The contact mail recipient
    from:       null                # The contact mail sender
    subject:    contact.message.new # The contact mail subject translation key

路由

如果您想使用默认的包 URL，只需将路由文件导入到您的应用程序路由中

    _frequence_web_contact:
        resource: '@FrequenceWebContactBundle/Resources/config/routing.xml'

这将创建2个路由，具有相同的 URL (/contact.html)，一个用于显示联系表单（GET），另一个用于提交数据（POST）

创建监听器

如果您想创建一个功能更强大的邮件监听器或任何其他监听器，您必须定义自己的。在成功提交联系表单时触发的事件是 contact.submit，并接收一个 FrequenceWeb\Bundle\ContactBundle\EventDispatcher\Event\MessageSubmitEvent。

如果您需要示例，请查看 FrequenceWeb\Bundle\ContactBundle\EventDispatcher\Listener\EmailContactListener。

扩展

如果您需要比 Contact 类和 ContactType 表单类型提供的更少的资料，只需覆盖 frequence_web_contact.type.class 和 frequence_web_contact.model.class 配置参数，它们用于实例化服务，并且可以无限制地扩展。