README

一个专门为开发者构建的WordPress表单解决方案。此插件会将所有表单提交发送到Constant Contact。

安装

OMG Forms可以通过composer安装。

$ composer require developwithwp/omg-forms-constant-contact

一旦安装了此包，如果您项目尚未使用，则需要调用Composer的自动加载器。

if ( file_exists( get_template_directory() . '/vendor/autoload.php' ) ) {
    require( 'vendor/autoload.php' );
}

用法

为了使此插件正常工作，您必须有一个有效的Constant Contact API密钥以及访问令牌。这两个都可以从Mashery获取。

现在您可以创建第一个表单了。OMG Forms提供了一个用于创建新表单的辅助方法\OMGForms\Core\register_form()。

此函数期望一个类似于register_post_type期望的参数数组。

让我们先定义一个非常简单的表单。

$args = [
		'name'              =>  'my-form-name',
		'redirect'          =>  false,
		'email'             =>  false,
		'form_type'         =>  'constant-contact',
		'success_message'   =>  'Thank you!',
		'list_id'           =>  '1233',
		'fields' => [
			[
				'slug'      =>   'first_name',
				'label'     =>   'First Name',
				'type'      =>   'text',
				'required'  =>   true
			],
			[
				'slug'      =>   'last_name',
				'label'     =>   'Last Name',
				'type'      =>   'text',
				'required'  =>   true
			],
			[
				'slug'      =>  'email-address',
				'label'     =>  'Email',
				'type'      =>  'email',
				'required'  =>   true
			]
		]
	];

如您所见，表单允许在表单和字段级别进行大量的配置。

定义表单后，您可以调用display_form来渲染它。

echo \OMGForms\Core\display_form( 'my-form-name' );

注意

为了使Constant Contact插件正常工作，您需要在注册表单时提供一些关键设置。

1. form-type必须设置为constant-contact
2. 每个表单都必须设置一个list_id。这样我们才能将联系人添加到正确的列表中。
3. 姓名和姓氏字段应具有first_name和last_name的别名。
4. 必须提供一个具有email-address别名的电子邮件字段。

有关OMG Forms的更多信息，请参阅基本存储库。