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.
Download the latest version of our WordPress plugin from this website: https://github.com/caagsoftware/wordpress-hq-rental-software/archive/master.zip
Install the plugin in WordPress from the Plugin menu; click on the new plugin and then upload plugin.
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. If you have xxx.caagcrm.com, your region is in America. For Europe, it would be xxx.hqrentals.eu and for Asia, it would be xxx.hqrentals.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.
Due to an incompatibility with Safari and Opera browsers, the domain name of the iframe has to be updated. You will need to add an A record in your DNS records where the value is the name of your tenant. For example if your link is rentals.caagcrm.com the value for the A record has to be “rentals” and the IP address will be dependent on your installation:
Once you have created the A 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.