Handler

Summary

Controls which shop account handler that will be used.

Usage

 Handler=ezuser|ezdefault|ezsimple

Description

This directive controls how the webshop system will get and store the information about the user when he/she initiates the checkout process. More generally, this directive sets which shop account handler that will be used. A shop account handler is a PHP class providing a mechanism that handles and stores customer information for webshop orders. The system behavior during the checkout process will depend on which shop account handler that is used. The default value of this setting is "ezuser", which means that users do not need to be logged in when making their orders.

There are three built-in shop account handlers called "ezuser", "ezdefault" and "ezsimple". These are located in the "kernel/classes/shopaccounthandlers" directory. The following table describes the built-in shop account handlers and how the checkout process behaves when the different handlers are selected.

Handler	Description	Details of the checkout process
ezuser	Users do not need to be logged in when making orders (the checkout form will be used).	When the "Checkout" button is clicked, the system will bring up the checkout form asking the user to provide necessary information for the order (name, email, country and address of the customer, plus optional company name and comment). After that, the "Confirm order" interface will be displayed. Note that if the user is logged in, then some of the fields in the checkout form (e.g. "First Name") will be automatically pre-filled according to the user's account data (fetched from the content object representing the user). In order to use this shop account handler, you need to make sure that anonymous users are granted access to the "buy" function of the "shop" module.
ezdefault	Users need to be logged in when making orders.	When the "Checkout" button is clicked, the system will check whether the user is logged in or not. If yes, the system will bring up the "Confirm order" interface. Otherwise, the user will be suggested to log in first and then (if successful) the "Confirm order" interface will be displayed.
ezsimple	Users need to fill in the shop account registration form when making orders.	When the "Checkout" button is clicked, the system will bring up the "Register account information" form asking the user to provide necessary information for creating a new shop account (name, email and post address of the customer). After that, the "Confirm order" interface will be displayed. Note that logged in users can make orders for other people by providing someone else's contact details in the shop account registration form. The system will not compare the information provided in the registration form with the currently logged in user's actual account data. In order to use this shop account handler, you need to make sure that anonymous users are granted access to the "buy" function of the "shop" module. It is not recommended to use the "ezsimple" handler if you charge different VAT percentage depending on the country the customer lives in. The main reason is that users are not supposed to specify their country while filling the "Register account information" form; and thus the system will not be able to calculate the amount of VAT for users that are not logged in (they will get an error message).

Handler

Description

Details of the checkout process

ezuser

Users do not need to be logged in when making orders (the checkout form will be used).

When the "Checkout" button is clicked, the system will bring up the checkout form asking the user to provide necessary information for the order (name, email, country and address of the customer, plus optional company name and comment). After that, the "Confirm order" interface will be displayed.

Note that if the user is logged in, then some of the fields in the checkout form (e.g. "First Name") will be automatically pre-filled according to the user's account data (fetched from the content object representing the user).

In order to use this shop account handler, you need to make sure that anonymous users are granted access to the "buy" function of the "shop" module.

ezdefault

Users need to be logged in when making orders.

When the "Checkout" button is clicked, the system will check whether the user is logged in or not. If yes, the system will bring up the "Confirm order" interface. Otherwise, the user will be suggested to log in first and then (if successful) the "Confirm order" interface will be displayed.

ezsimple

Users need to fill in the shop account registration form when making orders.

When the "Checkout" button is clicked, the system will bring up the "Register account information" form asking the user to provide necessary information for creating a new shop account (name, email and post address of the customer). After that, the "Confirm order" interface will be displayed.

Note that logged in users can make orders for other people by providing someone else's contact details in the shop account registration form. The system will not compare the information provided in the registration form with the currently logged in user's actual account data.

In order to use this shop account handler, you need to make sure that anonymous users are granted access to the "buy" function of the "shop" module.

It is not recommended to use the "ezsimple" handler if you charge different VAT percentage depending on the country the customer lives in. The main reason is that users are not supposed to specify their country while filling the "Register account information" form; and thus the system will not be able to calculate the amount of VAT for users that are not logged in (they will get an error message).

Path

Table of contents

Handler

Summary

Usage

Description

Comments