Configuring fields in the guest record
The guest fields associated with the purchaser in an E-Commerce sale can be configured separately from the guest fields associated with guests attached to items. This is done using the following settings in the site config file:
• Site Admin Panel > Guest Related Settings > PurchaserDispRows > value = guest_no, first_name, last_name, address, city, state, zipcode, country, phone, email, username, password
• Site Admin Panel > Guest Related Settings > PurchaserEditRows > value = first_name, last_name, address, city, state, zipcode, country, phone, email, cardonfile, username, password
• Site Admin Panel > Guest Related Settings > ExistingPurchaserHideRows > value = “”
• Site Admin Panel > Guest Related Settings > PurchaserForceEditFields > value = first_name, last_name, address, city, state, zipcode, phone, email, username, password
These settings function in the same manner as the keys “GuestDispRows”, “GuestEditRows”, “ExistingGuestHideRows” and “ForceEditFields”, except that they only affect the guest who is set as the purchaser in the sale. These “Purchaser” keys can take the same values as the corresponding “Guest” keys.
Additional configuration can be done in the DynamicControls.xml file. Each field/section in that file now has <Required_purch>…</Required_purch> tags which can be set to “1” (TRUE) or “0” (FALSE).
Example:
<guestEdit>
<Name>UCfirst_name</Name>
<RowID>first_name</RowID>
<dbField>g.first_name</dbField>
<Columns>20</Columns>
<MaxLength> 15</MaxLength>
<Required>1</Required>
<Required_purch>1</Required_purch>
<RequiredText>Required!</RequiredText>
<guestEdit>
Setting this to “1” makes it so that the field is required if the purchaser edits their guest record or they create a new guest record. A new button appears on either Checkout.aspx or Checkout2.aspx (if using checkout steps) when you set a purchaser. The button has the default wording of Edit this Purchaser which can be changed with a JavaScript include. This button allows easy access for the purchaser to edit their guest record during the checkout process. Also, if the purchaser guest record is missing any of the fields set in the PurchaserForceEditFields key, the message configured with the control asp:labelid= “lblFieldsRequired” displays. The default wording for this control, which can be changed with a JavaScript include, is “Please click on Edit Purchaser to edit all the required fields.”