How does my web developer create an availability search form on my website?
Your web developer can easily create a search form on your own website that links to the SuperControl availability search.
Doing this gives you complete control over the look and feel of the form and how it integrates into your website.
The HTML form should post data using the GET method to the following URL:
Compulsory hidden form fields:
You can send additional parameters if you want the country/region/town fields to appear in the SuperControl search form.
To show regions and towns (click here for list of ISO country codes):
show_regions=1&iso=[default iso country code]&show_towns=1
An example of how you would send this is to amend the URL you are posting to, for example please see the updated URL highlighted below:
https://secure.supercontrol.co.uk/availability/availability_search.asp?show_regions=1&iso=[default iso country code]&show_towns=1
To show countries regions and towns:
To show property types (if used on your account):
To show star grading:
To show property name:
You can send the following data in your request. If you send a startdate you must send either numbernights or enddate.
Otherwise all fields are optional.
Example form code
A basic example can be downloaded from: https://secure.supercontrol.co.uk/downloads/example_search_form.htm
Relevant API requests
Clients using the SuperControl API can create dynamic country / region / town fields in their search.
Property types: http://secure.supercontrol.co.uk/xml/types_[your siteID].xml
Countries: https://secure.supercontrol.co.uk/xml/countries.asp?siteID=[your siteID]
Regions and towns: http://secure.supercontrol.co.uk/xml/rcv/rcv_regions.asp?siteID=[your siteID]
The above URL will request the top level regions and all towns.
The regions API can accept additional parameters:
|country The two char ISO country code
|| regionID The regionID (used to filter towns)
|level Default is zero. E.g. level=1 will show second level regions
||parentID Combine with level to drill down regions
For example to create a series of dynamic country / region / town drop downs:
Show all top level regions in GB http://secure.supercontrol.co.uk/xml/rcv/rcv_regions.asp?siteID=123&country=GB
Display a second field for sub regions http://secure.supercontrol.co.uk/xml/rcv/rcv_regions.asp?siteID=123&country=GB&parentID=456&level=1
Towns will be filtered appropriately as you drill down.