axllent / silverstripe-enquiry-page
带有咨询表单的简单联系页面
3.0.0
2023-08-04 06:49 UTC
Requires
README
这是一个向CMS添加咨询页面类型页面的简单模块。该模块使用可选的JavaScript表单验证,因此不需要第三方JavaScript库(例如:jQuery)。咨询表单可以配置以添加和排序自己的字段,包括以下类型
- 文本(TextField/TextAreaField)
- 电子邮件(EmailField)
- 选择(DropdownField),可配置选项
- 复选框(CheckboxSetField),可配置选项
- 选项(OptionsetField),可配置选项
- 只读(HTMLReadonlyField),可选的html文本
- HTML部分(HTMLText)
配置选项包括
- 发送至电子邮件地址
- 发送电子邮件地址(默认情况下,“回复到”将设置为表单中的第一个电子邮件字段,或者可以选择此值)
- 电子邮件主题
- 完成后的消息
- BCC副本
- 提交按钮文本
- 可选的内置验证码图像
验证码图像
可以通过CMS轻松地在表单中启用随机生成的验证码图像。默认情况下,它将生成一个60x30px的4位数字图像,旁边有一个输入字段。如果您希望更改图像的高度(例如,以匹配bootstrap输入样式),您可以在YAML中进行配置
Axllent\EnquiryPage\EnquiryPage:
captcha_img_height: 35
请注意,高度不应小于20(否则数字可能无法正确显示)。
如果您使用动态更改REMOTE_ADDR
字段的Web服务(最著名的是CloudFlare),您可以配置另一个字段,例如
Axllent\EnquiryPage\EnquiryPage:
# Try $_SERVER['HTTP_CF_CONNECTING_IP'] (CloudFlare custom field) before
# $_SERVER['REMOTE_ADDR'], so it will work with and without CloudFlare
client_ip_fields:
- HTTP_CF_CONNECTING_IP
- REMOTE_ADDR
如果需要,您可以完全禁用客户端IP检索,通过取消设置该选项。
JavaScript验证
如果您希望启用内置的JavaScript验证,则可以在网站的YAML配置中添加它
Axllent\EnquiryPage\EnquiryPage:
js_validation: true
需求
- Silverstripe ^5
- GridFieldExtensions
安装
composer require axllent/silverstripe-enquiry-page