Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,090 of 9,090 pages
About the help in other languages
All help pages

shopaccount.ini walkthrough

The settings that decide which customer data form the checkout shows and which handler sends the order mail - HandlerSettings, AccountSettings with the ezuser, ezsimple, ezdefault and bcusauser handlers, Alias, and…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/e-commerce/settings/shopaccount-ini-walkthrough.md

On this page

shopaccount.ini walkthrough

This page is for developers and administrators who decide how an Exponential store collects customer data at checkout. settings/shopaccount.ini chooses two handlers: the shop account handler (which form the customer fills in and how name, e-mail and address are read back from an order) and the confirm order handler (which sends the order mail).

Contents

  1. HandlerSettings
  2. AccountSettings
  3. The shipped account handlers
  4. ConfirmOrderSettings
  5. Choosing a handler

HandlerSettings

SettingShippedMeaning
Repositories[]kernel/classesWhere handlers are searched; account handlers in shopaccounthandlers/, confirm order handlers in confirmorderhandlers/
ExtensionRepositories[]emptyExtensions with their own shopaccounthandlers/ or confirmorderhandlers/ directory

AccountSettings

SettingShippedMeaning
HandlerezuserThe shop account handler. The class is <name>ShopAccountHandler in <name>shopaccounthandler.php
Alias[]emptyReplaces one handler name by another, for example Alias[ezdefault]=eztest

The shipped account handlers

All four are in kernel/classes/shopaccounthandlers/.

HandlerThe customerFormWhere the data is kept
ezuser (shipped choice)Enters first and last name, e-mail, two street lines, zip, place, state, country and a comment at every checkout, with or without an accountshop/userregisterIn the order (data_text_1, as XML)
ezsimpleEnters first and last name, e-mail and one address fieldshop/registerIn the order
ezdefaultMust be signed in; is sent to user/login and back to the basket; nothing extra is askednoneThe user account's name and e-mail
bcusauserAs ezuser, for the US address model: city instead of place, plus a phone numbershop/userregisterIn the order

The templates that show the data are in design/standard/templates/shop/accounthandlers/ (html/ for screens, ascii/ for plain text). Guest checkout is possible with ezuser and ezsimple, as long as anonymous users have the shop/buy policy. The business view of this choice is Customer accounts and guest checkout.

Note

The ezauthorize extension ships its own account handler (ezcustom) and an example shopaccount.ini.append.php with every line commented out. Read it before switching it on: its settings in ezauthorize.ini map the account fields it expects.

ConfirmOrderSettings

SettingShippedMeaning
HandlerezdefaulteZDefaultConfirmOrderHandler: sends the order mail to the customer and to [MailSettings] AdminEmail when site.ini [ShopSettings] SendOrderEmail=enabled
Alias[]emptyReplaces one handler by another

Choosing a handler

You needHandler
Guests and customers enter an address each timeezuser
A shorter formezsimple
Only registered customers buy; their account holds everythingezdefault
US addresses with a phone numberbcusauser
Extra fields (company, VAT number, delivery address)A handler of your own (Shop account handlers)

For VAT rules by country, the handler must give the customer a country; check that your form asks for one (Product categories and VAT rules).

Become an Exponential Partner

Partners share their information, provide funding, contribute back and develop the products with us, and that is how Exponential grows. A partner website and dashboard are planned for mid-2027: please become a partner today to speed up our growth rate and land new features faster.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x