Shop
A catalogue with a category tree and specifications, a cart and orders. Product variants, stock, delivery, promo codes, discount rules, digital products and printable invoices. Price and name are stored in the order as they were at the time of purchase.
Features
- Catalogue: category tree, SKU, old price with a discount label, stock, gallery. Product variants (size, colour, volume) with their own price and stock.
- Specifications: text, number or list. Any of them can be made a filter in the catalogue.
- Storefront: search by name and SKU, price filter, sorting, comparison of up to four products, related products from the same category.
- Orders can be placed without an account. Stock is deducted at checkout and returned if the order is cancelled.
- Delivery with a free-delivery threshold. Promo codes as a fixed amount or a percentage. Discount rules without a code: by order total, by quantity of one product, per category, per customer role.
- Custom fields in the order form: line, text, list, checkbox.
- Digital products: a file, a link, a key from a pool or a file from «Downloads». Delivered once the order is marked as paid, with a delivery log.
- Price, name, delivery and discount are stored in the order as they were at the time of purchase. Later catalogue edits do not change the order.
- Order status and payment are tracked separately. There is a printable invoice and emails to the customer and the seller.
- Reviews with a rating and a «Verified purchase» badge — if the «Comments» module is enabled.
Configuration
The Shop section of the panel: Products, Categories, Specifications, Stock, Orders, Delivery, Promo codes, Discounts, Order fields. Variants and digital delivery are set on the product page. In the panel: Shop → Settings (a sub-item of the section):- Currency — only the symbol next to the price; no exchange rates are applied.
- Where to send orders — empty means the site's general address.
- Intro on the shop's front page, Shop promises, Invoice details.
- Products per page, Low stock threshold.
- Show on the home page, Products in the showcase, New arrivals in the sidebar block.
Permissions
- View products — open the section in the panel.
- Edit products and categories — catalogue, delivery, promo codes, discounts, order fields.
- Work with orders — orders, payment, invoices, digital delivery.
On the site
- /shop — catalogue, /shop/<category> — category, /shop/tovar/<name> — product.
- /shop/korzina, /shop/zakaz, /shop/sravnenie — cart, checkout, comparison.
- /shop/moi-zakazy — «My orders» for signed-in users, available in the menu and the user account.
- Blocks: «Shop window» on the home page, «New arrivals» in the sidebar, a cart icon in the header.
- For external applications: GET /api/v1/shop/orders with an API key, and an «Order paid» webhook.
Installation and removal
Creates 16 tables prefixed shop_ (products, categories, orders, delivery, discounts, keys and others), grants permissions to roles, and adds marked sample items to an empty catalogue. Removing the module with data erases all tables, orders included, along with its permissions and settings.Left out on purpose
- Payment processing: payment providers differ from country to country and are connected through a separate module. Without one, payments are marked manually.
- Shared stock across product translations: each language version has its own, and the panel warns about this.
How to install
You already have it. Panel → Modules → enable.
Version history
1.15.0
- Category tree and product specifications (text, number, list) with a storefront filter
- Comparison of up to four products by price and specifications
- «Stock» page and a «Low stock threshold» setting, with a warning on the panel overview
- Stock is reserved at checkout, so the last item cannot be sold twice; cancelling returns the stock to the right variant
- A promo code is used only within its limit, totals never go negative, and the old price is never below the current one
- Pressing «Checkout» again opens the order already created instead of creating a second one
- Four product address formats, including one with the section; old addresses redirect
- Product list in the panel: search, filters, sorting, bulk actions
1.13.0
- Section home page in the panel: products and orders summary, latest orders
- Order search by number, name, email and phone
- «Verified purchase» badge on customer reviews
- «My orders» card in the user account and an item in the site menu
- Several images per product, price filter and a results counter
- «Shop window» block on the home page; the storefront can replace the home page
- Cart icon in the header, discount and new-arrival labels on the product image
- A key in the order page address; out-of-stock products can no longer be ordered; digital products can be delivered as a file from «Downloads»
1.12.0
- On install, sample content is added to an empty catalogue: categories, products with variants and a digital product, a delivery method, a disabled promo code
1.11.0
- Placeholder with the first letter of the name for products without an image
1.10.2
- Digital delivery log: to whom, when, what was delivered and how many times it was downloaded
1.10.1
- Orders with no activity for more than a week are flagged in the list and shown as a warning on the panel overview
1.10.0
- Product reviews with a rating from 1 to 5 and the average rating on the product card
1.9.0
- Product variants with their own price, stock and SKU; the chosen variant is stored in the order
1.8.0
- Printable invoice from the order card
- «Invoice details» setting
1.7.0
- Search by name, short description and SKU right in the catalogue
- «Shop promises» setting — short lines above the catalogue
1.6.0
- Discount rules without a code: by total, by quantity, per category, per role
- Of the matching discounts, the most favourable one applies; priority decides a tie
1.5.0
- Digital products: a file, a link or a key from a pool, delivered once the order is marked as paid
- Download limit; delivery on the order page and by email
1.4.0
- Custom fields in the order form: line, long text, list, checkbox; answers are stored in the order
1.3.0
- Promo codes as a fixed amount or a percentage, with an expiry date, a usage limit and a minimum order total
1.2.0
- Delivery methods with a price and a free-delivery threshold
- Products and categories in several languages
- The cart does not allow more than is in stock; the order page shows the order status
- Checkout rate limit
1.1.0
- Payment status tracked separately from order status
- Catalogue sorting: newest, cheapest, most expensive, by name
- Other products from the same category are shown below a product
- Quantity selector on the product card and the discount percentage next to the old price
- The cart bar is visible on every page of the site
1.0.0
- Catalogue with categories, cart and checkout, orders in the panel
- Price and name are stored in the order as they were at the time of purchase
- Money is counted in minor units, with no float rounding
- Emails to the customer and the seller about a new order
Questions and findings go to the forum: the Modules section