netglue / ng-contact
ZF2 模块,为网站提供简单可重用的联系表单
Requires
- php: >=5.3.3
- netglue/ng-mtmail: 0.1
- netglue/zendframework: dev-master
- zendframework/zendframework: 2.*
This package is not auto-updated.
Last update: 2020-03-30 12:47:21 UTC
README
首先,此模块是从由 Matthew Weier O'Phinney 编写的模块改编而来,您可以在 GitHub 上找到它:weierophinney/PhlyContact
主要区别在于,控制器在成功提交后不会做任何事,只是触发一个事件。这样做的原因是我想找个借口学习一下 ZF2 事件管理器,并且我认为能够 插入 监视器以完成各种与提交联系表单相关联的任务会很好,例如,详细记录、将消息存储到数据库或文件中,当然还有发送电子邮件。
这是我使用 ZF2 开发的第一个独立模块,所以如果它有点混乱,请见谅。对我来说,它似乎配置比较复杂,我还不确定这是否是我必须接受的现实,还是我在做事情时犯了错误!
安装
到目前为止,最简单的事情是通过 composer 安装,只需将 "netglue/ng-contact": "dev-master"
添加到顶级 composer.json
文件的 require 块中,然后运行 $ php composer.phar update
将模块拉入您的 vendor 目录 (假设您已设置了一个标准 ZF2 应用程序,如 Skeleton App)。
请注意,您可能还需要在顶级 composer 文件中添加 "minimum-stability":"dev"
,因为这个包及其所有依赖项都不是 '稳定' 的。
这将安装依赖项。安装完成后,在配置目录中有一个名为 module.netglue-contact.global.php.dist
的文件。将其复制到您的 config/autoload
目录,删除 .dist 并根据您的需求进行修改 (.dist 配置文件中有很多您可能需要删除的冗余。一个很好的起点是简单地提供有效的电子邮件地址)。配置文件有相当好的文档,理论上,无需任何补充配置即可直接使用,但您可能不太喜欢视图脚本和电子邮件模板!
依赖项
- Zend Framework
- Net Glue ZF 扩展。这是一段额外的库代码。具体来说,需要 HtmlToText 过滤器来提供纯文本替代方案,并且使用 Mail Transport Factory 来配置传输。
- Net Glue 模板邮件模块。这个小模块提供了一种简单的方法来初始化使用 Zend View 组件渲染 HTML 的多部分电子邮件消息。
待办事项
- 实现 Captcha
- 提供修改表单以包含额外字段的示例配置
- 可能修改观察者以包含对前者的帮助
- 添加测试和清理