Advert Feed v1.0
myholidaycaravan.co.uk now accepts advert feeds onto the website, meaning listings for caravans currently for sale by other companies may be passed into our system and advertised on our site.
The format for the feed itself is XML and is very simple...
| Element | Description | Required | Data Type |
|---|
| ref | This is the unique reference number for the advert | Required | All Characters allowed. Max 15 Characters |
| name | A small descriptive name for the advert | Required | All Characters allowed. Max 100 Characters |
| description | A full description of the caravan being advertised | Required | All Characters allowed. Max 4000 Characters |
| price | The price of the caravan being advertised | Required | Numerical |
| year | The build year of the caravan being advertised | Optional | Numerical |
| dimensions | The physical dimensions of the caravan being advertised | Optional | All characters allowed |
| bedrooms | The number of bedrooms the caravan being advertised contains | Optional | Numerical |
| sleeps | The number of people the caravan being advertised can sleep | Optional | Numerical |
| features | A pipe-separated (|) list of features of the caravan | Optional | All Characters allowed. Max 2000 Characters |
| vantype | The type of the caravan being advertised | Optional | Caravan / Lodge |
| image1url | The full URL to the web-ready main image of the caravan | Optional | All Characters allowed. Max 255 Characters |
| image2url | The full URL to the web-ready second image of the caravan | Optional | All Characters allowed. Max 255 Characters |
| image3url | The full URL to the web-ready third image of the caravan | Optional | All Characters allowed. Max 255 Characters |
Please review the latest DTD (right-click --> Save As...) for this XML feed.
Example:
<?xml version="1.0" ?>
<!DOCTYPE ads SYSTEM "http://www.myholidaycaravan.co.uk/mhc-adsfeed-1.1.2.dtd">
<ads>
<adlisting>
<ref>1234</ref>
<name>Listing One</name>
<description>The description of the first listing goes</description>
<price>65,432</price>
<year>2013</year>
<dimensions>28x10</dimensions>
<bedrooms>2</bedrooms>
<sleeps>6</sleeps>
<features>Balcony|Air conditioning|Satellite TV</features>
<vantype>Lodge</vantype>
<image1url>http://www.website.com/path/to/1234/image1.jpg</image1url>
<image2url>http://www.website.com/path/to/1234/image2.jpg</image2url>
<image3url>http://www.website.com/path/to/1234/image2.jpg</image3url>
</adlisting>
<adlisting>
<ref>1235</ref>
<name>Listing Two</name>
<description>The description of the second listing goes</description>
<price>54,321</price>
<vantype>Caravan</vantype>
<image1url>http://www.website.com/path/to/1235/image1.jpg</image1url>
</adlisting>
</ads>
These XML files are to be hosted on YOUR servers. Our systems will regularly pull the data to retrieve the latest information.
Each park within your group must have it's own XML file containing the listings relevant to that park.
To ensure your XML feed adheres to the DTD, please test using the W3Schools XML Validator (please note that to test your XML against a DTD, you must visit this site using Internet Explorer).