Laravel Product Stock Alert User Guide

Laravel Product Stock Alert (PSA) module allows customers to get notified when an out-of-stock product is available again in your Bagisto eCommerce Store. Customers simply subscribe to the product and receive an email as soon as it is back in stock.

The admin can easily enable or disable the module from the Bagisto admin panel configuration, without touching any code.

Customers can subscribe from the product page or directly from product cards on category and listing pages, helping merchants recover sales that out-of-stock products might otherwise lose.

Please Note – Only logged-in customers can subscribe to stock alerts because the system stores each subscription in the customer’s account. The system sends back-in-stock emails through a queued job, so you must run a queue worker if your queue connection is not set to sync.

• The admin can Enable or Disable the extension.
• Customers can subscribe to a “Notify me when available” alert on out-of-stock products.
• The notify button is available on the product detail page as well as on the product cards of category and listing pages.
• The button appears only for out-of-stock products, and only for logged-in customers.
• Already subscribed products show a “Subscribed” state right on the first page load, so the label never changes after rendering.
• The system prevents duplicate subscriptions by allowing only one stock alert per customer for each product.
• The system automatically sends back-in-stock emails to every subscribed customer when the admin restocks a product.
• The system queues email notifications, so restocking a product with many subscribers never blocks the admin from saving the product.
• The system renders each email in the default locale of the customer’s channel instead of the locale of the admin who restocked the product.
• The system supports configurable products by considering the sellable quantity of all variants before sending stock alerts.
• Admin datagrid listing all stock alerts with ID, product name, customer email, status and created date, along with search, sort and filter support.
• Status dropdown filter to quickly separate Pending alerts from Notified ones.
• After receiving a back-in-stock notification, customers can subscribe again for future restocks.The system allows customers to subscribe again after sending a notification, enabling them to receive alerts for the next restock.
• Full page response cache friendly — the subscription state of the logged-in customer stays correct even on cached storefront pages.
• When you disable the module, the system hides the admin menu entry and disables both the admin and storefront routes.
• Translations available for all locales supported by Bagisto.

Unzip the respective extension zip and then merge “packages” and “public” folder into project root directory.

Goto bootstrap/providers.php file and add following line under ‘providers’.

use Webkul\PSA\Providers\PSAServiceProvider;

return [
    PSAServiceProvider::class,
]

Next, goto composer.json file and add following line under ‘psr-4’

"Webkul\\PSA\\": "packages/Webkul/PSA/src"

Run the command below to complete the setup:

composer dump-autoload

php artisan psa:install

The psa:install command runs the module migration and clears the application cache.

Once you successfully execute the commands, you will see the PSA settings by navigating through Configure → PSA → PSA Settings.

Here, the store admin will be able to configure the initial settings –

• Enable PSA:- Enable or disable this module by using the toggle button. When the admin disables the module, the system removes the Notify button, stops sending back-in-stock emails, and hides the Product Stock Alerts menu.

After setting all configuration, click on Save button.

Customers must log in to their accounts before subscribing because the system saves each stock alert to the customer’s account

Now, open any product that is out of stock. Below the Buy Now button, the customer will see the Notify me when available button.

The same button is also available on the product cards of category and listing pages, so the customer can subscribe without opening the product.

After clicking the button, the customer will see the success message “You will be notified when the product is back in stock” and the button will change to Subscribed.

Once the admin restocks the product, all the waiting customers will receive a back-in-stock email containing the product name and a button that takes them directly to the product page.

The system sends the email in the default locale of the customer’s channel, ensuring each customer receives the notification in their store’s language.

The admin can view all the stock alert requests by navigating to the Product Stock Alerts menu in the admin panel.

The listing shows the following details for each request –

• ID:- The unique id of the stock alert request.
• Product Name:- The product for which the customer is waiting.
• Customer Email:- The email address on which the notification will be sent.
• Status:- Pending till the product is back in stock, and Notified once the email has been sent.
• Created At:- The date on which the customer subscribed to the alert.

The admin can search the listing by product name and customer email, sort it by any column, and filter it by status to see only the Pending or only the Notified requests.

As soon as the admin updates and saves a product’s inventory, the system processes all pending stock alerts for that product and marks their status as Notified.

That’s all for the Bagisto Product Stock Alert. Still have any issue? Feel free to add a ticket and let us know your views to make the module better at bagisto.uvdesk.com