owenr88 / wufoo-html-wrapper
使用Wufoo API输出Wufoo表单HTML。还管理答案验证和提交。
Requires
- php: >=5.3.0
This package is not auto-updated.
Last update: 2024-09-14 18:58:37 UTC
README
Wufoo HTML包装器是一个PHP类,用于使用它们的API输出Wufoo字段。还有一个内置的Bootstrap选项来使用这些类和样式。
该类在提交错误时返回错误,显示必填字段,甚至显示说明文本。它还支持单页上的多个表单。
以下列出了该类支持的字段列表。这仍然是一个正在进行中的工作,所以非常欢迎pull requests(请确保使用dev
分支!)
遇到麻烦?在Twitter上联系我 @OwenTheTwit。
安装
您可以使用composer安装此软件包或下载文件并将其包含到项目中。
别忘了在Wufoo上创建账户。
Composer
composer require owenr88/wufoo-html-wrapper
手动
include_once 'WufooHTMLWrapper.php';
使用类
在开始使用类之前,有几个要求
- 获取您的API密钥
- 获取您的账户子域 - 例如 https://biglemon.wufoo.com
项目根目录中的example.php文件是一个很好的起点,它涵盖了所有必需的函数和选项。
初始化
在您的页面上初始化类以开始包装器
$wrapper = new WufooHTMLWrapper();
启用Bootstrap
$wrapper->enableBootstrap();
构建表单
此函数接受表单ID或表单URL缩略语。ID可以通过在Wufoo中点击“分享表单”并从URL中获取ID(例如,'z172ip8e07gen9n'),或者可以直接从URL中获取缩略语(例如,'test-form')来找到。
此函数返回HTML。请确保将其输出到页面。
$wrapper->buildForm( 'z172ip8e07gen9n' );
或
$wrapper->buildForm( 'test-form' );
提交表单数据
$wrapper->sendSubmission();
当前支持的字段
标准
- 单行文本
- 段落文本
- 多项选择
- 数字
- 复选框
- 下拉菜单
花哨的裤子
- 电子邮件
其他格式可能被支持,但它们只是使用它们的类型(例如数字、电子邮件等)作为输入字段的type属性
变更日志
1.0.5
- 从类中删除了默认API密钥和子域
1.0.4
- Composer格式化
1.0.3
- 更新了readme... 哎呀
1.0.2
- 更新了composer文件
1.0.1
- 更新了readme
1.0.0
- 第一个版本!包括类、示例和所有必需的文档。