Pre-Select Values – Overview
How it Works
By adding certain key-value pairs (called query string parameters) to the URL of your Booking page on your website, you can tell the Launch27 booking form which values to pre-select when the form loads.
Step 1: How to find the ID of the Service/ Frequency/or other value you want to preselect inside the system
Go to Settings -> Services -> Services or Frequencies > Categories
Hover over the edit icon
You will see a URL in your browser’s status bar that looks like this: http://www.yoursite.launch27.com/admin/services/10/edit
http://www.yoursite.launch27.com/admin/frequencies/3/edit
The bold numbers in the URL above are the IDs you would use for the parameters
(Optional) If you have a pricing parameter, you just need to pass in a number to
represent the Quantity. If your quantities are 1-6 for the pricing parameter, you can use any number from 1 to 6.
Step 2: Add the parameters to the URL
Let’s assume this is the URL of the booking page on your website.
Please note: Your website booking URL may look slightly different than below but we'll use this one throughout the doc to build our pre selected links.
A Single Parameter:
When you are adding a single parameter, you always add a ‘?’ before the name of the parameter.
Service Only
This would be used if you want the service with ID ‘3’ to be pre-selected:
Frequency Only
This would be used if you want the frequency with ID ‘3’ to be pre-selected:
Extras
This would be used if you want to pre-select an extra:
extra[<extra_id>]=<extra_quantity>
Zip Code
This sets the zip code to be pre-filled on the form:
Phone
This would be used to pre-enter a phone number:
phone=test
This would be used to pre-enter an email:
email=test
Number of Workers
Sets the number of workers to be pre-selected on the form (for hourly services):
service_id=<ID of your hourly service>
quantity=2
Number of Hours
Sets the number of hours (in minutes) to be pre-selected on the form (for hourly services):
service_id=<ID of your hourly service>
minutes=120
Discount Code
Enters a discount code into the Discount Field of the booking form. For a discount code called “springclean”:
rcode=springclean
Service Date and Time
Enters a service date into the Date field, and a time into the Time field of the booking form:
date – for Service Date. Format – YYYY-MM-DD i.e. date=2018-12-13.
time – for Service Time. Format – HH-MM (24 hours) i.e. 1:45PM would be time=13-45.
arrival_window – for Arrival Window. Format – N (integer, in minutes) i.e. a 2 hour arrival window would be arrival_window=120
Service Category
Selects a service category on the booking form:
category_id – ID of the service category i.e. category_id=10
Multiple Parameters:
When you are adding multiple parameters, you always add a ‘?’ before the name of the FIRST parameter, then a ‘&’ before the name of each subsequent parameter
Service and Pricing Parameter
This would be used if you want the service with ID ‘3’ and pricing parameter with quantity 3 to be pre-selected:
Service and Pricing Parameter
This would be used if you want the service with ID ‘3’ with a pricing parameter of quantity 3 and frequency with ID ‘3’ to be pre-selected:
http://www.yourwebsite.com/book-now/ service_id=3&pricing_param_quantity=3&frequency_id=3
How to Add Multiple Pricing Parameters
If you have multiple pricing parameters associated with your service, you can pre-select the quantities for each pricing parameter.
For example, if you have a Service (whose ID = 3) and two pricing parameters (whose IDs are 1 and 2), your link would look like this
http://www.yoursite.com?service_id=3&pricing_parameter[2]=5&frequency_id=7&pricing_parameter[1]=5