jordanbeattie/craftcms-hubspot-forms

CraftCMS的HubSpot表单字段

维护者

详细信息

github.com/jordannbeattie/craftcms-hubspot-forms

源代码

问题

安装: 561

依赖: 0

建议者: 0

安全: 0

星星: 0

关注者: 1

分支: 2

开放问题: 0

类型:craft-plugin

5.1.0 2024-08-07 19:49 UTC

Requires

Requires (Dev)

MIT d449705975d449c4d65e0956bf78f89e85a5e60a

cmsFormsCraftcraftcmshubspotcraft-plugin

This package is auto-updated.

Last update: 2024-09-07 20:09:09 UTC

README

直接从CMS字段中选择您的HubSpot表单，并使用Twig进行渲染。无需再复制粘贴嵌入代码！

免责声明：此插件“HubSpot Forms”是独立开发的，并非由HubSpot，Inc.官方认可或关联。虽然它与HubSpot API交互，但它是一个第三方工具，任何支持或问题应直接联系此插件的开发者，而不是HubSpot。使用HubSpot标志仅用于识别目的，表示与HubSpot服务的兼容性。

安装

从浏览器

  1. 从Craft插件商店下载插件
  2. 从设置页面安装插件
  3. 从设置页面启用插件

从终端

composer require jordanbeattie/craftcms-hubspot-forms

php craft plugin/install hubspot-forms

php craft plugin/enable hubspot-forms

配置

使用带有forms范围的HubSpot私有应用创建。复制您的访问令牌并将其添加到插件设置中的HubSpot Token字段。

HubSpot令牌字段可以接受.env变量。强烈建议您将访问令牌保存在您的.env文件中。

CMS字段

该插件添加了一个“HubSpot表单”字段类型，您可以使用它允许用户从您的HubSpot账户中选择一个表单。有关如何从字段中渲染表单的详细信息，请参阅模板部分。

模板

使用插件中的render()函数将表单输出到模板。这要求您传递HubSpot表单字段（或表单ID）。

{{ craft.hubspotforms.render( myHubspotFormField ) }}

示例

{{ craft.hubspotforms.render( entry.form ) }}

可选属性

您可以通过loadOnEvent属性传递JavaScript事件，在JavaScript事件被触发时触发表单的加载。

{{ craft.hubspotforms.render( myHubspotFormField, {
    loadOnEvent: 'myJavaScriptEvent'
}) }}

示例

{{ craft.hubspotforms.render( entry.form, {
    loadOnEvent: 'DOMContentLoaded'
}) }}

从HubCraft迁移

如果您之前使用过jordanbeattie/craftcms-hubspot插件，您可以使用简单的命令将现有字段更新到此插件提供的表单字段。

php craft hubspot-forms/migrate

这将确保您的插件已正确安装和配置，然后列出每个旧字段，在询问您是否继续之前。

继续操作后，每个旧字段都将更新到此插件提供的HubspotFormDropdown。

运行命令后，您应使用php ./craft project-config/rebuild重新构建项目配置，以确保所有字段都正确同步。

完成后，您应更新模板以使用新语法。

旧语法

{{ craft.hubspot.render( myFieldHandle ) }}

新语法

{{ craft.hubspotforms.render( myFieldHandle ) }}

更新模板后，您可以安全地卸载HubCraft插件。

支持

jordanbeattie.com