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';

Usage

• First, 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

• Additionally, you can send emails with the contents of the form submissions if you configure it in the Plugin tab of the content element

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
• The same goes for the template of the optional mail

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