Advanced Settings

If the general patterns for integrating RESMARK Systems online reservation engine into your site aren't quite what you are looking for, there are more powerful tools for custumization available. These include the ability to auto-login agents without a URL redirect, restricting payment options, tailoring the presentation of the confirmation etc.

RESMARK Container Custom Attributes

The main HTML element that holds the RESMARK Systems content must be a div element. No span, p or article elements, only div elements will be respected.

These are attributes that can be applied to the div element with id="rsmk-container". For example:

<div id="rsmk-container" data-context="currentPage"></div>

Attribute Name Format
data-context String There are only two possible values:
  • page - indicates the the reservation engine is the main content on the page. Use this when you want to present the RESMARK Systems user experience inside your own page layout. This allows you to have your own header, background and markup surround the RESMARK reservation engine workflow.
  • embedded - indicates the the reservation engine is not front and center. This is a more commonly used value for situations where you want the RESMARK reservation engine to "support" another page by showing the user Cart, or to have RESMARK power your own Book Now buttons.
data-hide-content-ids CSV List

This is an attribute that complements the class="rsmk-hideContent" style. Since the rsmk-hideContent class can only be applied to div elements, you may need the option to hide elements of a different type. For instance: some older markup manages content in td tags (we don't suggest doing this by the way). In such cases you just need to attach an id attribute to the HTML elements you wish to hide when RESMARK content is presented to the user and provide a CSV list of those elements id values.

Example: old-td-element,footer-span,left-nav-ul
data-cart-uri URI

The URI (not URL) of the shopping cart page. This is usually used to indicate where RESMARK should direct the user when the cart is requested. In most instances this is just set to the special value: currentPage which indicates that RESMARK is allowed to hide certain sections of the "Current Page" and present the users shopping cart. The sections of the page that RESMARK hides are marked with the CSS class rsmk-hideContent.

Another common alternative to hosting the shopping cart page on your site, is to forward the user directly to the resmark server for the completion of the purchase. This is done by specifying the special value: resmarkServer which tells the system to take the user to the resmark server immediately after adding an item to their cart.

If you want the user to go to a different page to view their cart, you must put that page on your site. Note that this URI should be either a full path to a file (like /reservations/cart.php) or a URI to a directory with a trailing slash ( / ) (like /content/view-cart/). The trailing slash ( / ) is important for some browsers to work correctly.

If you do point this page to something hosted on your site, make sure that the data-context attribute is et to page on that page, since it will be assumed that the target page holds only the RESMARK reservation engine.

Example: currentPage to use the current page or /reservations/cart.php or /reservations/view-cart/
data-agent-id Number The RESMARK Systems identifier for the Agent that should get credit for this sale.
50123
data-agent-view Boolean

If this value is set at all, it is interpreted to mean that an agent is viewing the content. This will display commission information for the current sale. This information is put in a div with the id rsmk-agent. You can put this div anywhere on your page, if you do not create a div with id="rsmk-agent" RESMARK will create one for you and put it at the top of the div with id="rsmk-container".

Example: true
data-confirmation-style String

Alters the format of the Confirmation given to the online user. This attribute is only applicable when data-agent-id and data-agent-view are set.

One of the following values values:

  • DIVISION_TO_CUSTOMER - this is the default value. Most Confirmations are presented to the online user in this format. This would be a Confirmation addressed from your company directly to the guest.
  • DIVISION_TO_TRAVEL_AGENCY - formats the Confirmation from your company to the Travel Agency getting commission for this sale. This is usually used in situations where a Travel Agent is the online user booking reservations on behalf of your guests and you want the Agent to see their commission and payment options on the Confirmation.
  • TRAVEL_AGENCY_TO_PRIMARY_GUEST - formats the Confirmtion from the 3rd party Travel Agency directly to the Guest in a way that omits total cost and payment amounts. This is usually useful for instances where you want to allow the Travel Agency to dictate their own price to the Guest, or if the 3rd party Travel Agent is bundling many services together and they don't want to disclose the individual service prices to the Guest.
data-payment-options String

Restricts the payment amounts an online Guest can submit to the system. This is usually only useful when you want to force the online Guest to only pay a Deposit or forcing Direct Billing as the only options for payment. Any value specified is only respected if the current online purchase would accept such a payment in the first place. i.e.: you can't force a Deposit as a payment option if the balance due date is already passed.

Any CVS combination of the following values is allowed:

  • FULL - allows the Guest to pay the full amount for the online purchase.
  • DEPOSIT - allows the Guest to pay the deposit amount (if a deposit is applicable for the current purchase).
  • DEPOSIT_SCHEDULE - allows the Guest to pay the deposit amount and also schedule the balance payment to be processed on the Balance Due Date (if a deposit and balance due are applicable for the current purchase).
  • DIRECT_BILL - only applicable when a Travel Agent is logged in that has Direct Billing enabled. Allows the user to charge the purchase to the Travel Agency getting commission for this sale.
Example: DEPOSIT,DEPOSIT_SCHEDULE this would make it so the Guest could not pay the FULL amount

Book Now Button Custom Attributes

Book Now buttons must be either an a tag or a button tag.

<a href="javascript:void(0);" class="bookNowButton someOtherStyleYouWant">Book Now</a>

or

<button class="bookNowButton someOtherStyleYouWant">Book Now</button>

In some cases you may want to create a Book Now button linked to a specific Launch rather than all Launches of an Activity. This is made possible by the data-launch-id attribute.

Attribute Name Format
data-activity-name-id Number The RESMARK Systems identifier for the Activity Name (or Package Name) you want to sell with this button.
Example: 26
data-launch-id Number The RESMARK Systems identifier for the specific Activity (Launch) you want to sell with this button. In order to use this attribute the data-activity-name-id must be set.
Example: 50495