A common source of confusion is how to customize the rental finalize pages so that they display plan and instrument specific topics. This article will attempt to explain how different topics are rendered on the three different pages involved.


NOTE: When editing the Rental page topics, DO NOT USE the Inline Editor on the storefront, as it may save unintended data from AIMsi into the topic rather than the reference token such as (!C2B_ACCESSORYTABLE!)


1. Rental Plan ("AeRntPlan")


This page is optional, and is used to allow users to enter in a plan code before they go to the next page in the rental process (#2, School Select). This code is sent to this page via a query parameter ("?plan="). 

This page can be populated with HTML from the topic "aeC2BPlan". 


Notes:

 - If you wish to allow users to be able to specify a blank plan code here, then you must set the Setting "aeAllowInvalidPlanCode" to "true".

 - If you wish to restrict the school display by the plan code entered here, then you must set the Setting "aeRestrictSchoolsByPlan" to "true".


2. School Select ("AeRntSchoolSelect")


If you enter a valid topic name in AIMsi in the "Plan and Rate" table that corresponds to a cart topic, then that topic will be displayed at the top of this page, depending on the plan selected.


Inside of this topic, you can specify the following tokens to display, which are based on the selected plan:


(!C2B_NRPLANCODE!)

(!C2B_NRPLANNAME!)

(!C2B_NRPLANMONTHS!)

(!C2B_NRPLANTERMSURL!)


You can use this last to create a clickable link, like so:

<div><a href="(!C2B_NRPLANTERMSURL!)">Terms and Conditions</a></div>


Notes

 - If the Setting "aeOneRentalSelectionPage" = "true", then instruments will be listed underneath the instrument selection drop-down; otherwise the Submit button will appear after you select a teacher and will clear the page after you click it to display instruments then.

 - If you only have one teacher set up in AIMsi, the teacher selection dropdown will not appear and the single teacher option will be auto-selected.


3. Rental Finalize ("aeRntFinalize")


This is the final page of rental checkout. It is entirely derived from the content of one of two topics:


- "aeC2BRentalFinalize" - displays when the user is logged in

- "aeC2BRentalFinalizeAnon" - displays when a user is NOT yet logged in, and allowing anon rentals is setup.


Then, in these topics, you specify the form that is displayed, using tokens to display information about the selected plan/school/teacher/instrument. There are many tokens that can be used here; please see the AIMsi manual for a full listing. 


There are two custom topics that will be dynamically embedded in these pages, if you specify the token for them in one of the two topics, above. 


 - the Instrument topic is specified in AIMsi on the Inventory Setup screen. To display this topic, specify the token (!INSTRUMENT_TOPIC!).

 - the Plan Finalize topic is also specified in AIMsi on the Plan and Rate screen . To display this topic, specify the token (!PLAN_FINAL_TOPIC!).


Here are some other common tokens you can also embed in the two rental finalize topics:


(!C2B_NRINSTIMAGEPATH!) - has the path to the image specified in AIMsi on the Inventory Setup screen. You can use this in conjunction with an IMG tag to display the instrument image, like so:

<img src="(!C2B_NRINSTIMAGEPATH!)" width="500" />


(!C2B_PAYMENTINFO!) - displays the payment collection (credit card) form

(!C2B_ACCESSORYTABLE!) - displays accessory options as defined in AIMsi

(!C2B_DELIVERYTABLE!) - displays delivery options as defined in AIMsi

(!C2B_MAINTENANCETABLE!) - displays maintenance options as defined in AIMsi

(!C2B_NRPLANTERMSURL!) - displays the path to the terms and conditions URL


You can use this last to create a clickable link, like so:

<div><a href="(!C2B_NRPLANTERMSURL!)">Terms and Conditions</a></div>


Notes:

 - If the Setting "aeAllowAnonRentals" is set to TRUE, then customers are not required to to be registered to setup a Rental.


- It is highly recommended to set it FALSE and require registration. You must also set "aeRequireAccountForRentals" TRUE for the rental pages to force sign in / create account.


- You will want to create text on a lead-in topic page, or the rental entry pages, or signin page, informing the customers that an account is required.


 - Merchants allowing anonymous rentals often set some redirect links in the "aeC2BRentalFinalizeAnon" topic, so that if an anonymous user got to this page without logging in or registering, then they can decide to continue anonymously or be redirected back to the signin or create account page. For example:


You are choosing to rent anonymously. This is not recommended as you will not have access to additional services after the rental is made, such as making payments or viewing account history. <strong>It is highly recommended that you have an account prior to continuing with the Online Rental Process.</strong><br />

To do so, you must either <a href="(!SignInOutLink!)"><span style="font-size: 12pt;"><strong>Login</strong></span></a> or <a href="javascript: window.open('/createaccount.aspx?returnurl=' + encodeURIComponent('(!INVOCATION!)'), '_self');"><span style="font-size: 12pt;"><strong>Create an Account</strong></span></a> to continue.

 


Rental Process Pages - Avoiding Invalid Plan Codes

Plan Codes are used to group rates and options together on the rental pages, "AeRntPlan", "AeRntSchoolSelect", and "AeRntFinalize".


NOTE: Although Plan Codes can be whatever you choose, there are some restricted characters that should not be part of Plan Codes. The following characters are not allowed in Rental Plan Codes:

  • >  ( greater than)
  • <   ( less than )
  • &   ( and )
  • '     ( apostrophe )
  • "    ( quotes )