How can we help you?

Articles in this section

Wordpress plugin

Gabriele
  • Updated
Follow

To install the WordPress plugin, please contact support@hostaway.com and we will activate the option.

The plugin is provided through a public Github repository where you can find a Readme file with instructions to download and set up the plugin:

https://github.com/Hostaway/wordpress-plugin 

How to install and configure the plugin:

  1. Download the latest hostaway-wp-plugin.zip from Releases and install it: the easiest is to install the plugin through Plugins->Add New->Upload Plugins, or (advanced) upload the plugin files to the /wp-content/plugins/ directory on the web-server.

  1. On Plugins page for Hostaway choose Activate Plugin.
  2. Use the Plugins->Hostaway->Settings page to configure the plugin:

Enter your Account ID and Secret code and press Get access token button (it will fetch JWT token used to access Hostaway API).
Find more information here about Hostaway API key (Secret Code). IMPORTANT: Note that generating a new key will deactivate the previous one and any 3rd party that is connected to Hostaway.

  • `Google Maps API key` parameter allows using Google map on the search and listing pages. Without that key maps will not be shown.
  • `Price markup` parameter defines the % mark up that will be added to the base rate. E.g. 1.1 = 10%; 1.2 = 20%
  • `Debug mode` allows debugging twig templates. Please don't forget to set it to 1 then you want to change something in twig templates.
  • `Clear cache` button allows clearing the cache of twig templates and API requests.

If you want to adjust CSS for your theme please go to Hostaway → Custom CSSand paste your styles there.

How to test that the connection works

After plugin activation, you can find several new pages in Pages → All pages

You can click `view` on `Vacation Rentals Search` page and it will show you a list of listings with enabled Wordpress.

All these pages contain only shortcodes supported by the plugin. 

[hostaway_listing] shortcode allows to display listing details. It takes a listingMapId parameter from the query parameters and displays details for that listing.

If listingMapId is not defined this shortcode can accept it from arguments. For example, you can use [hostaway_listing 123] construction to show listing details for listing 123.

If none of the possible parameters are defied this shortcode will get a list of listings and display information for a first of them.

Parameters for [hostaway_booking] shortcode works exactly the same.

How to upgrade

https://wordpress.org/support/article/managing-plugins/#plugin-updates

Since the installation process is manual, in order to upgrade plugin you have to remove the previous version from WP website using admin panel and install a new version manually.

How to uninstall if needed

https://wordpress.org/support/article/managing-plugins/#uninstalling-plugins

Use WP admin panel to uninstall the plugin. All of the plugin pages, configuration and files will be deleted.

How to activate listings

Go to Hostaway Dashboard > Integrations > Hostaway Wordpress plugin > Select the listings you wish yo show on your website.