Installation

Requirements

Magento 2.4.8-p4 / Mage-OS 2.2.1 / Adobe Commerce
PHP 8.1 – 8.5
A working cron setup and a message-queue runner (database or RabbitMQ/AMQP)

1. Install via Composer

Bash

composer require qoliber/module-product-notifications

Optional companion modules:

Bash

# Headless / PWA storefronts
composer require qoliber/module-product-notifications-graphql
# Hyvä theme
composer require qoliber/module-product-notifications-hyva
# Multi-Source Inventory
composer require qoliber/module-product-notifications-msi

2. Enable & upgrade

Bash

bin/magento module:enable Qoliber_ProductNotifications
bin/magento setup:upgrade
bin/magento setup:di:compile        # production mode only
bin/magento setup:static-content:deploy   # production mode only
bin/magento cache:flush

3. Verify cron

The extension ships several cron jobs in the qoliber_product_notifications group (fan-out, publisher, retry sweeper, expiry, price-drop scanner). Confirm Magento cron is running:

Bash

bin/magento cron:install        # if not already scheduled
crontab -l | grep magento

Cron is required

Notifications are matched and queued by cron. Without a running cron, no emails are sent.

4. Start the queue consumer

Email dispatch runs through the message queue. Run the consumer (via your process manager / supervisor):

Bash

bin/magento queue:consumers:start qoliber.product_notifications.dispatch --max-messages=1000

Keep it alive

Use supervisord, systemd, or cron:run-managed consumers so the dispatch consumer restarts automatically. The producer (cron) and consumer (queue) are decoupled by design.

5. Confirm it's live

Set a product to Out of Stock.
Open it on the storefront — the Notify me form should appear.
Subscribe with a test email, then check Stores → Product Notifications → Subscriptions in the admin.

📸 Screenshot needed

Terminal showing setup:upgrade completing for Qoliber_ProductNotifications. Save as public/images/extensions/product-notifications/install-upgrade.png.

setup:upgrade output

Configuration — tune opt-in, cooldowns, dispatch and security.
Usage — day-to-day operation.