oomphinc / gravity-forms-google-places
添加一个位置字段类型,该类型与 Google Places API 集成。
Requires
- php: >=5.4
README
Gravity Forms 的 Google Places 字段提供了一个新的字段类型,该类型与 Google Places API 集成,提供方便的地址和某些兴趣点的查找。用户从结果集中选择的条目将作为 Google Places 表单字段的值提交,并且可以从 Google Places API 响应数据中收集额外的信息(隐藏或公开的字段)。
通过 Geocomplete jQuery 插件 实现了与 Google Places API 的集成。
安装
您可以从 GitHub 下载此插件的 ZIP 文件,并在您的 WordPress 网站上安装,就像安装任何其他插件一样。还需要 Gravity Forms 插件,并且此插件已测试到 Gravity Forms v2.2.5。安装并激活这两个插件后,您就可以开始向表单中添加 Google Places 字段了。
如何使用
在 Gravity Forms 表单编辑器的“高级字段”部分应出现一个名为“Google Places”的新字段类型。要使用它,只需将新的 Google Places 字段拖动到所需位置。该字段无需任何额外的配置即可工作。如果您只需要收集单行形式的地址(如 Google Places API 在字段中填充的),那么您就设置好了!如果您需要收集额外的地点数据或收集所选地址的各个部分,请继续阅读。
收集额外的数据
Google Places API 返回的关于所选地址的数据比 Google Places 字段中填充的数据更多,并且这些额外的组件可以单独收集。此外,在 Google Places 字段的填充值中出现的组件也可以单独收集,以便在表单条目上更容易地进行数据处理。例如,您可能希望单独收集城市、州和/或国家值,或收集地址的纬度和经度值。
地址组件可以填充到“单行文本”或“隐藏”字段中。要收集额外的地址组件,请添加一个新字段,然后选择新字段的编辑表单的“高级”选项卡。您应该会看到一组标记为“用 Google Places 地址组件填充”的配置选项。在“字段 ID”框中,输入您希望填充的字段的“Google Places 查找”字段 ID。在“组件”选项中,填写您想要收集的地址组件;有关可能组件的列表,请参阅 Geocomplete 文档 中的“地址和地点组件类型”部分。一些组件包括简短版本(例如,“RI”代替“Rhode Island”),但默认情况下,结果将包含完整版本。要访问简短版本,请将 _short
添加到组件类型。例如,要收集美国地址的州值的简短值,组件将是 administrative_area_level_1_short
。
可以在单个表单上放置多个Google地点字段。在收集额外的地址组件时,请确保您输入的是与地点字段对应的正确字段ID。
问题
如果您在使用此插件时遇到问题,请随时新建一个问题!