Our system has two main ways to integrate with your website, a WordPress Plugin or a direct iFrame implementation. This article is a step by step breakdown of how to integrate if you are using a WordPress based website. To learn how to integrate if you are not using a WordPress based website, click here.
On the main menu of your WordPress Website back-end navigate to Plugins > Add New
Search for HQ Rental Software in the search box, and select “Install Now” as shown in the image below.
Once you have installed the plugin, please select “Activate” as shown in the image below.
Next, set up the credentials to connect to the system. In WordPress go to Settings > HQ Rentals.
You can find the Tenant Token inside the system under Settings > Integrations. Click on the “Generate new token” button, highlighted in orange in the picture below.
For User Token, you can navigate to Settings > User Management > Users
You will see a table with the user where you can click on the user that you would like to use to manage, as shown in the image below.
Once you click on the user you will be able to see the following screen with a link to generate the new token as shown and marked in orange in the picture below.
Once you have generated the new tokens, paste them in the fields marked in the image below. Next, select the API Region that you are currently in circled in orange in the picture below.
To find out which API region you are currently on, check your URL.
- For xxx.caagcrm.com, your region is America
- For xxx.hqrentals.app, your region is in America 2
- For xxx.west.hqrentals.app, your region is in America West
- For xxx.hqrentals.eu, your region is Europe
- For xxx.hqrentals.asia, your region is Asia
Once you have copied both tokens you will see HQ Rentals inside the WordPress menu and you
should see this table; now just copy the “HTML shortcode reservations” and paste that on the page
where you would like to display the bookings process. The system will automatically resize the iFrame
on this page.
To learn how to do custom styling for your reservation form to suit your website, follow this link here.
Safari & Opera Browser
Due to an incompatibility with Safari and Opera browsers, the domain name of the iframe has to be updated. You will need to add a CNAME record in your DNS records where the value is the name of your tenant. For example, if your link is my-company.caagcrm.com or my-company.hqrentals.app the value for the CNAME record has to be “my-company”, and the value needs to be your link for example my-company.caagcrm.com
Once you have created the CNAME record on your domain, you will receive an SSL error. Please create a support ticket inside the HQ application so our team can proceed with the installation.