Home › Reference › How-To Guide

How do I integrate forms with my own website?

Sat, 05/10/2008 - 16:56 — admin

Using an IFRAME you can either:

  1. embed a whole Mini-site page without the header and with/without the navigation or
  2. embed any of the individual pages without the header and navigation
  3. embed a customized calendar - you can just link to this too if you want

To embed a page/pages from the mini-site

Set the 'src' of an IFRAME on your site to a URL of the following form: http://www.myvrzone.com/?cid=UID-PID&embed=1
Where UID is your MyVRZone User ID and PID is an optional property ID number.

To turn on/off the header and navigation, use the following additional arguments in your URL (see examples below for the format)

 

  • eh=1 - to display a simple header (defaults to not show)
  • em=1 - to display the navigation menu (defaults to not show)
  • nmp=1 - to stop displaying multiple properties if you have more than one (defaults to show all)

To display specific pages, add the following before the ? in the URL:

  • Guest/Availability - for the Availability page - essentially shows the calendar in the Mini-site format
  • Guest/GuestBook - for the GuestBook page - see prior feedback/comments
  • Guest/Feedback - for the Feedback page - guests submit their rating and comments here
  • Guest/Ccard - for the Credit Card Payment form (if this is enabled for your account)
  • Guest/ - same as the Availability unless it's a Gold or Platinum plan...

For Gold and Platinum subscribers:

  • Guest/Request - for the Inquiry/Request page
  • Guest/Booking - for the Booking form
  • Guest/ - the property overview (this is the default)

For Gold and Platinum plan subscribers, don't integrate the Booking and Credit Card forms onto your website in this way as the forms need extra information in order to pre-fill and link up to the system correctly. Use the Mini-site for these forms unless you are able to perform a more advanced integration using dynamic server-side code - ask me for further details if interested.

Examples (for User ID UID=4)

For the whole minisite:

For the Request/Inquiry Form:

For the Guest Book:

For the Feedback/Comment Form:

    Note that the Guest Book links to this form so you can just use the Guest Book and ask your guests to add new feedback using the link there. Otherwise use the following:
  • http://www.myvrzone.com/Guest/Feedback/?cid=4&embed=1&nmp=1 to display a page for requesting comments on a guest's stay. Guests are required to register/log in so that they can provide their feedback securely.

For the Credit Card Payment Form:

NOTE that integrating this form requires the site embedding the IFRAME to use the https protocol for SSL (Secure Sockets Layer) to avoid browser confusion. The data will always be securely submitted because the IFRAME uses SSL but the browser may not show the usual locked symbol. If you do not have an SSL certificate for your site then you can obtain one and create a secure page in which to embed this form. If in doubt, the simplest thing is to use the Guest Zone for online payments.

Calendar - customizable

The calendar can be customized to display in many ways and colors. Please visit this page for interactive help on setting up your preferred format and colors etc. Choose various options there and click the Display button to see what the calendar would look like. When you are happy, paste the IFRAME code there into your website to get the same look.

Rates Table

The rates table has a few configurations that allow you to control how far into the future is displayed, the max number of lines and whether the season name is displayed. The basic view can be reached at the following URL:

  • http://www.myvrzone.com/Data/Rates/?cid=4-1 to display the Rates for UID=4 and PID=1
  • append &t=# to choose a theme, set # to the theme number. Default is your own default theme.
  • append &l=# to set the maximum number of lines to display to #
  • append &ss=1 to include the special dates - by default they are not displayed
  • append &m=# to display rates covering a maximum of # months - default is 12 months
  • append &s=YYYY-MM-DD to set the start date for the table - format must be YYYY-MM-DD, eg 2009-07-01 for 1st July 2009
  • append &ns=1 to hide the display of the season names in the table

Examples for UID=4 and PID=1