README

提供高级自定义字段，允许 WordPress 编辑用户或管理员在选择字段组配置时选择 Gravity 表单。

入门

此插件主要可在 WordPress 插件库 中找到。它允许您在 WordPress 管理员中选择的 Gravity 表单，并在您的主题或插件中使用选定的表单 ID 输出表单。

此插件对网站的输出没有任何影响。 它为 自定义 ACF 字段类型 添加了使用 ACF 字段组。

安装和使用

1. 将插件文件上传到 /wp-content/plugins/acf-gravityforms-add-on 目录，或直接通过 WordPress 插件屏幕安装插件。
2. 通过 WordPress 的“插件”屏幕激活插件。
3. 将新的“表单”类型字段添加到所需的 ACF 字段组中。

您还可以使用 Composer 安装 Advanced Custom Fields: Gravity Forms Add-on。

composer require dannyvanholten/acf-gravityforms-add-on

…或者如果您使用 WPackagist，…

composer require wpackagist-plugin/acf-gravityforms-add-on

使用 Advanced Custom Fields: Gravity Forms Add-on

要使用该字段，您只需了解高级自定义字段的工作原理。您可以查看 他们的文档。

Gravity Forms 扩展插件返回单个表单对象/ID 或对象/ID 的数组。现在我们知道我们可以轻松地用它来构建我们的字段 :)

前端表单的输出

此插件不将任何代码集成到网站的客户端。您需要确保您的插件或主题处理表单的输出。有关如何操作的示例，请参阅 Gravity Forms 网站上的 这篇博客文章。

获取表单 ID

请参阅 ACF 方法 get_field 的文档以获取如何使用它的完整详细信息。

如果您从您的 ACF 字段配置返回一个 ID

$form_id = get_field('my-form');
gravity_form($form_id);

如果您从您的 ACF 字段配置返回一个对象/数组

$form = get_field('my-form');
gravity_form($form['id']);

如果您从您的 ACF 字段配置返回多个表单 ID

$form_ids = get_field('my-form');

foreach($form_ids as $form_id) {
    gravity_form($form_id);
}

过滤字段 HTML

版本 1.3.4 向字段的输出添加了一个纯 HTML 过滤器。此过滤器不适用于 ACF 版本 4 中的字段。

apply_filters('acf-gravityforms-add-on/field_html', string $field_html, array $field, string $field_options, string $multiple)

参与其中

想要参与并改进 Advanced Custom Fields: Gravity Forms Add-on 吗？Fork 此存储库，并随时创建一个 pull request。审查后，我们可能会将其添加到我们的 GitHub 存储库 中。

鸣谢

此插件由位于瑞士 Spiez 的专业 WordPress 代理机构 Say Hello GmbH 维护。

该插件最初由 Danny van Holten 开发，基于 @stormuk（@lgladdy 和 @adampope）的工作。