Introduced in version 5.8.19, CabGrid Pro provides 3 event hooks that enable you to manipulate the price calculator and booking form on your website. These are JavaScript functions that are called when specific events occur during the calculation or booking process. Some basic information is passed to these functions, but the functionality is defined by you. The 3 functions are as follows:

  • hookCabGridProGetPrice(“done|fail“)
    • Fires when the calculation is performed.
    • Receives a single string parameter of either “done” or “fail”
      • done: if the calculation or some message is returned
      • fail: if the calculation results in an error
  • hookCabGridProBookButtonClick([CabGrid Instance])
    • Fires when the BOOK button is clicked
    • Receives a jQuery object representing the currently active CabGrid Pro instance
  • hookCabGridBookingSubmit(“done|fail“,[form data])
    • Fires when the booking form is submitted
    • Receives two parameters
      • a status of “done” or “fail” as a string
        • done: if the booking form is submitted and processed successfully
        • fail: if there is an error and the booking form is not processed successfully
      • the booking form data as a serialised string

How to implement custom functionality

Your custom functions will need to be loaded on your page ready to be called when events occur. There are several ways to achieve this. For example, enqueue a Javascript file within your theme, add Javascript to the head of your page via a custom plugin, or use a third-party plugin to inject Javascript.

If you have the free CabGrid Defaults add-on plugin installed, you can also add custom JavaScript to the cab-grid-custom.js file.

Once you have chosen the method to inject your function(s) to your page, you need to write code to execute when it is called. Here is a simple example:

<script>
function hookCabGridProGetPrice(status) {
	//alert the calculation status (replace with your code)
	alert("Price calculation status = "+status);
}
function hookCabGridProBookButtonClick(cgp) {
	//change this calculator's background colour when book button clicked (replace with your code)
	cgp.css("background-color","red");
}
function hookCabGridBookingSubmit(status,data) {
	//display an alert based on status when booking submitted (replace with your code)
	if(status=="done") {
		alert("Booking request sent successfully");
	} else {
		alert("An error occurred, please contact us");
	}
}
</script>

Tags: , ,

x
  •  
  • Discount/Promo Code
  • Extras

    Select additional items to add to your booking

    • Water

      Water

      Chilled mineral water

      -+

      $1.491.49


No price found for this journey