itx/hubspot-forms

it.x Hubspot Forms Extension

dev-main 2024-11-05 12:10 UTC

This package is auto-updated.

Last update: 2024-11-05 12:10:55 UTC


README

This extension will help displaying Hubspot forms in our pages by dynamically loading in any given Form using your PortalID and Access Token through the HubSpot API

Installation (Composer)

To install the extension using composer, run composer req itx/hubspot-forms

Configuration

  • To start using the extension, you will first have to set your Access Token and PortalID in the TYPO3 Backend Settings > Extension Configuration > hubspot_forms
  • Alternatively you can configure these paths inside your AdditionalConfiguration.php file located under public/typo3conf/AdditionalConfiguration.php e.g.
$GLOBALS['TYPO3_CONF_VARS']['EXTENSIONS']['hubspot_forms']['accessToken'] = 'Your Access Token';
$GLOBALS['TYPO3_CONF_VARS']['EXTENSIONS']['hubspot_forms']['portalID'] = 'Your PortalID';
  • Next, you can add a General Plugin content element where you want your form to be on your website
  • After that, go to the Plugin Tab in the settings of your new content element. Here, you can select which form you want to load from your given HubSpot Portal in Form of a select list
  • After selecting your form, switch over to the frontend to see it all loaded in
  • There is an option to only simulate form submissions in the Extension Settings. This toggle disables the line of code responsible for the POST request to HubSpot after submitting a form

Styling

  • Every field type of the forms is rendered by a partial, if you want to individually style your form fields, overwrite the partials and add your own styling

Known Issues

Multiple Multiple-Checkboxes

  • When a form contains more than one multiple checkbox field, if any checkbox of any of the fields is checked, the browser won't prompt you to check at least one of the checkboxes in each field
  • Submitting the form while there isn't at least one checkbox checked in the required fields causes TYPO3 to throw a Bad Request Error
  • The error gets caught, so the site continues to operate, but the form will not be sent to HubSpot