Checkout Store Blocks

 

The checkout process includes three steps as outlined above. Each of these steps implies the use of checkout store blocks. The following is a detailed description of the individual checkout store blocks that can be used on the checkout pages.

It must be noted that all checkout store blocks can be called through tags only in templates devoted to checkout steps (stored in avactis-templates/checkout/checkout-sequence/default/). In other words, the use of checkout store blocks is not expected on any other site pages or in any other templates.

CheckoutOrder

The CheckoutOrder block allows to display the order contents: items, prices, shipping cost, taxes, and the subtotal and total sums. This store block can be displayed by using the tag <?php CheckoutOrder(); ?>.

All templates of the CheckoutOrder block are stored in the folder avactis-templates/checkout/order/default/.

The CheckoutOrder block consists of the following templates:

The container template (order-container.tpl.html) is required to define the design of the overall CheckoutOrder block. For example, you can define border width and border color of the block, background color, block font, etc.
The individual item template (order-item.tpl.html) is used to display the information about an individual item contained in the order. It can include the image for the product (Product Image), the product name (Product Name), the quantity of this item added to the cart (Qty), the price (Price), and the total price for this item considering its quantity (Total Price).
The individual tax template (order-tax-item.tpl.html) is used to display taxes. For each tax, it displays the tax name and the tax amount.

The figure below shows the outline of templates of the CheckoutOrder block provided with Avactis Shopping Cart by default.

CheckoutCustomerInfoInput

The CheckoutCustomerInfoInput block represents the form for filling in basic customer information: name, email and phone number. This store block can be displayed by using the tag <?php CheckoutCustomerInfoInput (); ?>.

All templates of the CheckoutCustomerInfoInput block are stored in the folder avactis-templates/checkout/customer-info/default/.

The CheckoutCustomerInfoInput block can be customized in the same way as the CheckoutBillingInfoInput block.

CheckoutCustomerInfoOutput

The CheckoutCustomerInfoOutput block is used to let the customer double check the accuracy of data entered in the Customer Info form before the order is finally generated. It is implied that, upon discovering a misprint or an error, the customer will return to the previous checkout step and make corrections. This store block can be displayed by using the tag <?php CheckoutCustomerInfoOutput (); ?>.

A single template is used to display the CheckoutCustomerInfoOutput block:

output-customer-info-item.tpl.html - is used for each pair “Field Label: Field Value”. For example, "First Name: John".

The CheckoutCustomerInfoOutput block can be customized in the same way as the CheckoutBillingInfoOutput block.

Template of the CheckoutBillingInfoOutput block is stored in the folder avactis-templates/checkout/billing-info/default/.

CheckoutShippingInfoInput

The CheckoutShippingInfoInput block is the form for entering shipping information for the order: the recipient’s name, address, etc. This store block can be displayed by using the tag <?php CheckoutShippingInfoInput (); ?>.

All templates of the CheckoutShippingInfoInput block are stored in the folder avactis-templates/checkout/shipping-info/default/. The CheckoutShippingInfoOutput block can be customized in the same way as the CheckoutBillingInfoInput block.

CheckoutShippingInfoOutput

The purpose of the CheckoutShippingInfoOutput block is to let the customer review the information he or she entered in the Shipping Info form before proceeding to the final ordering stage. If the customer finds an error or misprint, he or she can return and make the necessary corrections. This store block can be displayed by using the tag <?php CheckoutShippingInfoOutput (); ?>.

The CheckoutShippingInfoOutput block can be customized in the same way as the CheckoutBillingInfoOutput block.

Template of the CheckoutShippingInfoOutput block is stored in the folder avactis-templates/checkout/shipping-info/default/.

CheckoutBillingInfoInput

The CheckoutBillingInfoInput block is a form for entering billing information. This store block can be displayed by using the tag <?php CheckoutBillingInfoInput (); ?>.

All templates of the CheckoutBillingInfoInput block are stored in the folder avactis-templates/checkout/billing-info/default/.

It’s worth noting that the tag <?php CheckoutBillingInfoInput(); ?> generates a Billing Info form based on individual fields. A Billing Info form can have two kinds of fields: textboxes and drop-down lists.

Fields such as First Name, Last Name, E-Mail, etc are textbox fields. Drop-down can include fields such as Country or State. A typical drop-down list is a list of state names.

You can define the appearance of textboxes and drop-down lists by editing the block templates. Any form field (textbox as well as drop-down list) can be either optional or required. To complete the checkout, the customer must enter all required fields.

The information the customer enters here may be valid or invalid. For instance, "my.email.com" is not a valid email. If this is the case, the customer will be notified of the error.

Thus, four templates are defined for each form field:

optional input field
required input field
optional input field containing an error
required input field containing an error

All four of these templates can be modified:

input-billing-info-text.tpl.html - optional textbox.
input-billing-info-text-required.tpl.html - required textbox.
input-billing-info-text-error.tpl.html - is displayed if the customer has entered invalid data in an optional textbox.
input-billing-info-text-required-error.tpl.html - is displayed if the customer has entered invalid data in a required textbox

Similar templates are used for drop-down lists:

input-billing-info-select.tpl.html
input-billing-info-select-required.tpl.html
input-billing-info-select-error.tpl.html
input-billing-info-select-required-error.tpl.html

The figure below shows the outline of templates of the CheckoutBillingInfoInput block provided with Avactis Shopping Cart by default.

CheckoutBillingInfoOutput

The purpose of the CheckoutBillingInfoOutput block is to let the customer review the information he or she entered in the Billing Info form before proceeding to the final ordering stage. If the customer finds an error or misprint, he or she can go back to a previous step and make the necessary corrections. This store block can be displayed by using the tag <?php CheckoutBillingInfoOutput (); ?>.

A single template is used to display the CheckoutBillingInfoOutput block:

output-billing-info-item.tpl.html - is used for each pair “Field Label: Field Value”. For example, "First Name: John".

Template of the CheckoutBillingInfoOutput block is stored in the folder avactis-templates/checkout/billing-info/default/.

CheckoutShippingMethodsSelect

The tag <?php CheckoutShippingMethodsSelect(); ?> displays the form that lets the customer select the shipping method. The contents of the form are generated automatically based on the shipping methods activated from within the Admin Area.

The templates used when populating the Shipping Method form are stored in the folder avactis-templates/checkout/shipping-methods/. Each shipping method has a specific template stored in this folder. For instance, templates for the shipping method Flat Shipping Rates are stored in avactis-templates/checkout/shipping-methods/flat-shipping-rates/.

CheckoutShippingMethodsOutput

The purpose of the CheckoutShippingMethodsOutput block is to let the customer review the payment method information he or she has entered, before proceeding to the final ordering stage. If the customer finds an error or misprint, he or she can go back to a previous step and make the necessary corrections.

The tag <?php CheckoutShippingMethodsOutput(); ?> displays the name of the selected shipping method. This is done with the template stored in avactis-templates/checkout/shipping-methods/. Each shipping method has a specific template in that folder. For instance, templates for the shipping method Flat Shipping Rates are stored in avactis-templates/checkout/shipping-methods/flat-shipping-rates/.

CheckoutPaymentMethodsSelect

The tag <?php CheckoutPaymentMethodsSelect(); ?> displays a form for entering the payment method for an order. This form is generated automatically based on the payment methods activated from within the Admin Area.

The templates used when populating the Payment Method form are stored in the folder avactis-templates/checkout/payment-methods/. Each payment method has a specific template in this folder.

For instance, the templates for the payment method PayPal are stored in avactis-templates/checkout/payment-methods/paypal/.

CheckoutPaymentMethodsOutput

The purpose of the CheckoutPaymentMethodsOutput block is to let the customer review the payment method he or she has chosen before proceeding to the final order placement stage. If an error is found, the customer can go back to a previous step and make the necessary corrections.

The tag <?php CheckoutPaymentMethodsOutput(); ?> displays the name of the selected payment method. This is done with the template stored in avactis-templates/checkout/payment-methods/. Each payment method has a specific template stored in this folder. For instance, the templates for the payment method PayPal are stored in avactis-templates/checkout/payment-methods/paypal/.

 


  © 2004-2008 Pentasoft Corp. All Rights Reserved.