owenr88/wufoo-html-wrapper

此包的最新版本(v1.0.5)没有提供许可证信息。

使用Wufoo API输出Wufoo表单HTML。还管理答案验证和提交。

v1.0.5 2016-01-26 14:39 UTC

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';

使用类

在开始使用类之前,有几个要求

  1. 获取您的API密钥
  2. 获取您的账户子域 - 例如 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

  • 第一个版本!包括类、示例和所有必需的文档。