README

This extension will help displaying Hubspot forms in our pages by dynamically loading in any given form using the HubSpot API

Installation (Composer)

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

Configuration

Create a HubSpot access token with the following scope: forms
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 settings 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

itx / hubspot-forms

Maintainers

Details