E-commerce: start here
This section is for people who sell online with Exponential: merchants who own a store, store managers who run it every day, developers who build and extend it, and agencies that deliver stores to clients. It is the e-commerce hub of the help: it sends you to the right existing page for each question and adds the pages nobody else covers, such as how the checkout runs internally, how to read every shop setting, how to extend the shop with your own handlers, and how to test, report on and operate a store over a year.
Note
Every statement in this section was checked against the Exponential repository: the shop module
(kernel/shop/module.php), the shop classes in kernel/classes/ and kernel/shop/classes/, the shipped settings
(settings/shop.ini, settings/site.ini, settings/shopaccount.ini, settings/workflow.ini,
settings/paymentgateways.ini) and the payment extensions ezpaypal and ezauthorize. Where something is not in
the code, the page says so instead of promising it.
Contents
- The two sections this hub builds on
- Pick your path
- What this section adds
- The shop in one diagram
- Every part of this section
- Quick answers
- Where else to look
The two sections this hub builds on
Two sections of the help already cover the store from a business point of view. Read them first; this section links into them and does not repeat them.
| Section | For | What it covers |
|---|---|---|
| Online stores and small shops | Owners and decision makers before and at launch | What the built-in shop does, planning, products, prices, VAT, shipping, checkout, payments, the launch checklist |
| Running your store | Owners and staff after launch | Daily, weekly and monthly routines, orders, returns, VAT checks, GDPR requests, store reports |
The technical setup pages for website creators are Running a shop: overview, Products, prices and VAT, Basket, checkout and orders and Payment gateways.
Pick your path
| You are | Your path | Typical first question |
|---|---|---|
| A merchant who owns the store | Merchant path | "What will it cost me to run, and what must I decide?" |
| A store manager who runs orders | Store manager path | "Which screens do I use every day, and who may change which status?" |
| A developer who builds or extends the shop | Developer path | "Where do I hook in shipping, VAT or a payment provider?" |
| An agency or partner delivering stores | Agency path | "How do I scope, build, test and hand over a store?" |
All four paths are explained side by side in Paths by role. The whole section in reading order is the E-commerce reading path.
What this section adds
The store sections answer "what" and "how often". This section answers "how exactly" and "what if":
- Catalog modeling in depth: choosing between
ezpriceandezmultiprice, options, product categories for VAT, and the folder structure of a catalog (Catalog modeling). - Shop settings walkthroughs: every shop-related setting, file by file, with the shipped value and when to change it (Shop settings walkthroughs).
- The checkout from the inside: the four shop operations, the temporary order, the workflow triggers, and the payment gateway, simple shipping and multiplexer events (Checkout and workflows).
- Order operations: the lifecycle of an order in the database, status transitions limited by
FromStatusandToStatus, archive versus remove, and the order mail handler (Order operations). - Extending the shop: shipping, VAT, basket info, shop account, confirm order and exchange rate handlers, payment gateways of your own and custom price datatypes (Extending the shop).
- Operating a store: testing, accessibility, multisite, landing pages with Layouts, analytics, reporting and export, product imports, headless commerce, the commerce audit trail, a yearly calendar, decision checklists and troubleshooting (Operating a store).
The shop in one diagram
Product page --(shop/add, trigger shop_addtobasket)--> Basket (shop/basket, trigger shop_updatebasket)
--> Customer data (shop/userregister or shop/register, chosen by shopaccount.ini)
--> Confirmation (shop/confirmorder, trigger before_shop_confirmorder: shipping)
--> Checkout (shop/checkout, trigger shop_checkout: payment gateway)
--> Order activated: order number, status history, order mail, receipt link
--> Store tab: dashboard, order list, statuses, archive, statisticsEach step is explained in Checkout operations step by step.
Every part of this section
| Part | Pages |
|---|---|
| Paths by role | merchant, store manager, developer, agency |
| Catalog modeling | modeling in depth, price fields compared, options and variants, product categories and VAT rules |
| Shop settings walkthroughs | shop.ini, site.ini [ShopSettings], shopaccount.ini, workflow.ini, paymentgateways.ini |
| Checkout and workflows | the operations, temporary orders, triggers, payment gateway, simple shipping, multiplexer |
| Order operations | lifecycle, status permissions, archive and cleanup, order mail and receipts |
| Extending the shop | shipping, VAT, payment gateways, shop accounts, basket info and confirm order, exchange rates, price datatypes |
| Operating a store | testing, accessibility, multisite, Layouts, analytics, reporting, imports, headless, audit, calendar, checklists, troubleshooting |
| Reference | FAQ, Glossary, Reading path |
Quick answers
- Is the shop an add-on? No. It is part of the kernel: the shop module and its views are in
kernel/shop/module.php(What the built-in shop does). - Which payment providers? The repository has two payment extensions,
ezpaypal(PayPal) andezauthorize(Authorize.Net). Others are written as gateways (Payment gateway development). - Does it charge VAT by country? Yes, with VAT rules, once a VAT handler is switched on (Product categories and VAT rules).
- What is not included? Stock management, coupon codes, accounting invoices, shipping labels and automatic file delivery are not in the kernel (E-commerce FAQ).
Where else to look
| Topic | Page |
|---|---|
| Workflows in general | Workflows |
| Roles and policies | Roles and policies |
| The Store dashboard and the seventeen order statuses | Store dashboard and order statuses |
| Permanent receipts | Permanent order receipts |
| Selling in several languages and sites | Multilingual businesses, Multi-site brands |
| Building extensions | App creators: start here |
Related pages
- Online stores and small shops
- Running your store
- Businesses: start here
- Customers: start here
- E-commerce reading path
- Free documentation: this page is free to copy, translate and improve under the GNU FDL 1.3.
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.