Mystery Box - Prestashop module

Everything you needBuilt for serious merchants

A complete toolkit for running mystery box campaigns, from random selection logic all the way to customer reveal animations.

Rarity Tiers

Define Common, Rare and Legendary pools with custom drop rates — like a real loot crate. Default 80 / 18 / 2.

Value Targeting

Set a fixed target value or a price multiplier — items are picked until the bundle matches the target within your tolerance.

Stock-Aware

Stock is automatically deducted on order placement and restored on cancellation. Out-of-stock items are excluded from every pool.

Category & Pool Filters

Mix entire categories, hand-picked products with weights, brand and supplier filters, and per-product exclusions.

Customer Reveal

Choose when contents are revealed — instantly, on shipping, on delivery. With a beautiful animated reveal button.

Audit Log

Every generation, restoration and regeneration is logged with timestamps and employee IDs. Export to CSV in one click.

Security Hardened

CSRF tokens, escaped templates, path-traversal protection, date validation, prepared queries — audited for OWASP top 10.

Admin Test & Preview

Test box generation right from the admin panel without placing a real order. See exactly what your customers will get.

Concurrency-Safe

MySQL row-level locks prevent race conditions. Live stock re-check before every deduction.

WorkflowHow it works

From admin setup to customer reveal in four simple steps.

Create a Box

Define the box name, price, stock and which products should be eligible — by category, brand or hand-picked.

Set the Rules

Choose target value, min/max items, rarity tiers and any guaranteed items. Use Test to preview the contents.

Customer Buys

On order placement, the engine instantly picks the products, deducts stock and logs the result.

Reveal & Ship

Contents appear in invoices, packing slips, emails and the customer's order history with a satisfying reveal animation.

For your customersA reveal experience they won't forget.

A modern, animated widget shows up right on the product page — purple gradient header, randomized thumbnail previews, and a count of "X+ possible products" instead of dumping every name.

Random thumbnail grid refreshes on every page load

"Randomly selected from 1,247+ products" counter

Lazy-loaded images for fast page rendering

Reveal button with CSRF-protected AJAX in order detail

For administratorsPlain-English settings — no IDs to memorize.

The admin form was rebuilt for clarity. Brand and supplier filters use name-based multi-selects. Rarity tiers come with visual explainers. Every field has a plain-language description with examples.

Filter by brand/supplier with named multi-selects (no more "Allowed Manufacturer IDs")

Inline explainers for Target Value vs Price Multiplier

Visual section dividers for Common/Rare/Legendary tiers

One-click Test button — preview contents without placing an order

Diagnostics export and audit log download