README

使用 metabox.io 和 MB Frontend Submission 的可重用插件，提供具有代码强大和可扩展的表单。表单定义与 metabox 相同，并添加了一些额外功能。

额外 Metabox 参数

`选项`

额外 Metabox 字段参数

短代码

[tghpcontact_form]

可用过滤器

tghpcontact_forms

tghpcontact_fields

tghpcontact_fields_{$formId}

$formId 是相关表单的 ID（键/值数组中的键）

tghpcontact_email_subject

tghpcontact_email_content

有用功能

Recaptcha

该插件提供了一个新的 recaptcha 字段类型。

array(
    'id' => 'g-recaptcha',
    'type' => 'recaptcha',
),

然而，提供了一个网站和密钥。插件将使用以下格式的 getenv 来查找这些密钥

RECAPTCHA_KEY_SITE_{$formId}
RECAPTCHA_KEY_SECRET_{$formId}

因此，每个表单都需要一个 recaptcha 实例和环境变量。这一点很重要，因为页面只能使用一次一个网站/密钥。所以如果我们只使用一对，页面上就只能放置一个具有任何 ID 的表单。这样，你可以放置更多的内容

JavaScript

消息事件

当一个消息触发（确认或错误）时，将在 body 元素上分发一个 tghpcontact:message-show 事件。这可以用来添加滚动到消息的逻辑。此事件传递一个匹配消息元素的 jQuery 对象作为单个参数。

示例用法

var $header = $('#masthead'),
    $window = $(window);
$(body).on('tghpcontact:message-shown', function (e, el) {
    $window.scrollTop($(el).offset().top - $masthead.height() - 20);
});

这很重要，因为这个插件没有实现这一点，因为每个网站都需要根据头部大小调整不同的偏移位置。

tghp / tghp-mb-contact

维护者

详细信息