Methods
JS API Methods
Opens the Reserve In-Store modal so the shopper can place a new reservation.
Example: Custom button to open the reserve modal
<button onclick="ris.showReserveModal();">Show Reserve Modal</button>
If the user is currently looking at a product the reserve modal will assume that the customer wants to reserve the current product in store.
If the user is currently NOT looking at a product and a shopping cart is available, the the reserve modal will assume that the customer wants to reserve their entire cart in-store.
Opens the "Choose Location" modal so the shopper can choose their preferred location that the app can default to from now on.
Example: Custom link to open the choose location modal.
<a href="#" onclick="ris.showChooseLocationModal()">Choose Preferred Location</a>
Adds a new event listener to the system for the specified event.
Example: Trigger alert log when reserve modal is submitted
// Using the push buffer method since we don't know if RIS is loaded yet.
window.ris = window.ris || [];
window.ris.push('on', {
event: 'reserve_modal.submit',
callback: function() {
alert("New reservation created!");
}
});
See all Events at the events section for the JS API:
You can call JS API methods with the push buffer if you aren't totally sure if the Reserve In-store system has loaded yet.
Example: Trigger some code upon initialization of the reserve in-store system
window.ris = window.ris || [];
window.ris.push('on', {
event: 'init',
callback: function() {
alert("Reserve in store system has initialized.");
alert("Current product variant ID is:" + ris.getVariant().id);
}
});
Get the shopper's current preferred or geolocated nearest store location.
Example: Get currently preferred location
ris.getLocation(function(location) {
console.log("Currently preferred location is: ", location);
});
Get all the store locations available for selection by the shopper.
Example: Get all the available store locations.
ris.getLocations(function(locations) {
console.log("Store locations available are", locations);
});
Get the product that the system currently detects that the shopper is looking at.
Example: Get the current product ID
console.log("Current product ID:", ris.getProduct().id);
Get the product variant that the system currently has selected.
Example: Get the current variant ID
console.log("The ID of the variant currently selected is: ", ris.getVariant().id);
Last modified 4yr ago