PHPackages                             webgriffe/sylius-back-in-stock-notification-plugin - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. webgriffe/sylius-back-in-stock-notification-plugin

ActiveSylius-plugin[Utility &amp; Helpers](/categories/utility)

webgriffe/sylius-back-in-stock-notification-plugin
==================================================

Timely inform customers and guest visitors when a product return in stock

v5.0.2(4mo ago)635.5k↑42.4%13[2 issues](https://github.com/webgriffe/SyliusBackInStockNotificationPlugin/issues)MITPHPPHP ^8.2

Since Jul 5Pushed 3mo ago4 watchersCompare

[ Source](https://github.com/webgriffe/SyliusBackInStockNotificationPlugin)[ Packagist](https://packagist.org/packages/webgriffe/sylius-back-in-stock-notification-plugin)[ RSS](/packages/webgriffe-sylius-back-in-stock-notification-plugin/feed)WikiDiscussions master Synced 4d ago

READMEChangelog (10)Dependencies (114)Versions (17)Used By (0)

 [ ![](https://camo.githubusercontent.com/1567208cc7c8ec53cf6e2af4f54449a9bb3ab0dee7916998de4e3ce9b7f79015/68747470733a2f2f64656d6f2e73796c6975732e636f6d2f6173736574732f73686f702f696d672f6c6f676f2e706e67) ](https://sylius.com)

Back in Stock Notification Plugin
=================================

[](#back-in-stock-notification-plugin)

Plugin that add the possibility to receive an email notification when a product return in stock

[![Build Status](https://github.com/webgriffe/SyliusBackInStockNotificationPlugin/workflows/Build/badge.svg)](https://github.com/webgriffe/SyliusBackInStockNotificationPlugin/actions)

Features
--------

[](#features)

### Subscribe to get a Notification when a product return in stock

[](#subscribe-to-get-a-notification-when-a-product-return-in-stock)

[![Subscription for simple product](docs/product.png)](docs/product.png)

### View your subscriptions in the apposite section of your account

[](#view-your-subscriptions-in-the-apposite-section-of-your-account)

[![See the apposite section in the my account](docs/my_account_section.png)](docs/my_account_section.png)

### View your client subscriptions in the apposite admin section

[](#view-your-client-subscriptions-in-the-apposite-admin-section)

[![See the apposite section in the admin account](docs/admin_account_section.png)](docs/admin_account_section.png)

Requirements
------------

[](#requirements)

- PHP `^8.2`
- Sylius `^2.0`

Installation
------------

[](#installation)

1. Run `composer require webgriffe/sylius-back-in-stock-notification-plugin --no-scripts`.
2. Add the plugin to the `config/bundles.php` file:

```
Webgriffe\SyliusBackInStockNotificationPlugin\WebgriffeSyliusBackInStockNotificationPlugin::class => ['all' => true],
```

3. Import the plugin routes by creating a file in `config/routes/webgriffe_sylius_back_in_stock_notification_plugin.yaml` with the follwing content:

```
webgriffe_sylius_back_in_stock_notification_plugin:
  resource: "@WebgriffeSyliusBackInStockNotificationPlugin/config/routing.yaml"
```

4. Import required packages config in your `config/packages/webgriffe_sylius_back_in_stock_notification_plugin.yaml` file:

```
imports:
   - { resource: "@WebgriffeSyliusBackInStockNotificationPlugin/config/packages.yaml" }
```

5. Update the database schema and install assets:

```
bin/console doctrine:migrations:migrate
bin/console assets:install
bin/console sylius:theme:assets:install
```

6. Clear cache:

```
bin/console cache:clear
```

Configuration
-------------

[](#configuration)

This module sends mail using a Symfony Command. Unfortunately, the command line context does not know about your VirtualHost or domain name. To fix this, the Command loads the hostname from the Subscription's channel, if nothing set it defaults to `localhost`. In console commands, URLs use http by default. You can change this globally with these configuration parameters:

1. Edit the `config/services.yml` file by adding the following content:

```
parameters:
    router.request_context.scheme: https
```

2. As said early this module provides a command that check the stock of the product. You have to set the command `bin/console webgriffe:back-in-stock-notification:alert` in the crontab, once a day is enough:

```
0 12 * * *  /bin/console webgriffe:back-in-stock-notification:alert
```

Optional Configuration
----------------------

[](#optional-configuration)

If you want to use our Behat defined steps you have to include our Behat class in your autoloader-dev. To achieve this adds the following line to your `composer.json`:

```
"autoload-dev": {
    "psr-4": {
      "Tests\\Webgriffe\\SyliusBackInStockNotificationPlugin\\": "vendor/webgriffe/sylius-back-in-stock-notification-plugin/tests/"
    }
},
```

Contributing
------------

[](#contributing)

To contribute to this plugin clone this repository, create a branch for your feature or bugfix, do your changes and then make sure al tests are passing.

```
composer install
(cd vendor/sylius/test-application && yarn install)
(cd vendor/sylius/test-application && yarn build)
vendor/bin/console assets:install

docker-compose up -d # only if you haven't mysql and mailhog installed locally

vendor/bin/console doctrine:database:create
vendor/bin/console doctrine:migrations:migrate -n
# Optionally load data fixtures
vendor/bin/console sylius:fixtures:load -n

symfony server:ca:install
symfony server:start -d
```

### Running plugin tests

[](#running-plugin-tests)

#### PHPUnit

[](#phpunit)

```
vendor/bin/phpunit
```

#### Behat (non-JS scenarios)

[](#behat-non-js-scenarios)

```
vendor/bin/behat --strict --tags="~@javascript"
```

#### Behat (JS scenarios)

[](#behat-js-scenarios)

1. [Install Symfony CLI command](https://symfony.com/download).
2. Start Headless Chrome:

```
google-chrome-stable --enable-automation --disable-background-networking --no-default-browser-check --no-first-run --disable-popup-blocking --disable-default-apps --allow-insecure-localhost --disable-translate --disable-extensions --no-sandbox --enable-features=Metal --headless --remote-debugging-port=9222 --window-size=2880,1800 --proxy-server='direct://' --proxy-bypass-list='*' http://127.0.0.1
```

3. Install SSL certificates (only once needed) and run test application's webserver on `127.0.0.1:8080`:

```
symfony server:ca:install
APP_ENV=test symfony server:start --port=8080 --dir=tests/Application/public --daemon
```

4. Run Behat:

```
vendor/bin/behat --strict --tags="@javascript"
```

#### Static Analysis

[](#static-analysis)

##### Psalm

[](#psalm)

```
vendor/bin/psalm
```

##### PHPStan

[](#phpstan)

```
vendor/bin/phpstan analyse -c phpstan.neon
```

##### Coding Standard

[](#coding-standard)

```
vendor/bin/ecs check
```

### Opening Sylius with your plugin

[](#opening-sylius-with-your-plugin)

- Using `test` environment:

```
(cd tests/Application && APP_ENV=test bin/console sylius:fixtures:load)
APP_ENV=test symfony server:start --port=8080 --dir=tests/Application/public --daemon
```

- Using `dev` environment:

```
(cd tests/Application && APP_ENV=dev bin/console sylius:fixtures:load)
APP_ENV=dev symfony server:start --dir=tests/Application/public --daemon
```

License
-------

[](#license)

This plugin is under the MIT license. See the complete license in the LICENSE file.

Credits
-------

[](#credits)

Developed by [Webgriffe®](http://www.webgriffe.com/).

###  Health Score

54

—

FairBetter than 96% of packages

Maintenance71

Regular maintenance activity

Popularity37

Limited adoption so far

Community21

Small or concentrated contributor base

Maturity73

Established project with proven stability

 Bus Factor1

Top contributor holds 66.5% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~131 days

Recently: every ~161 days

Total

14

Last Release

117d ago

Major Versions

1.0.0 → 2.0.02022-05-25

2.0.1 → 3.0.02022-11-16

3.0.3 → 4.0.02023-12-06

4.1.0 → v5.0.02025-11-17

PHP version history (4 changes)1.0.0PHP ^7.3

2.0.0PHP ^8.0

4.1.0PHP ^8.1

v5.0.0PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/eca104631fd7f6aff6d399ca16458c4d9814770756af0ecca22ffe2b1c5704d3?d=identicon)[mmenozzi](/maintainers/mmenozzi)

![](https://www.gravatar.com/avatar/29820819a890cfde7227bc1255b0428f4eb5c2f7dd49fb1bb3e5543057ded0a9?d=identicon)[LamasFoker](/maintainers/LamasFoker)

---

Top Contributors

[![lamasfoker](https://avatars.githubusercontent.com/u/12940668?v=4)](https://github.com/lamasfoker "lamasfoker (107 commits)")[![lruozzi9](https://avatars.githubusercontent.com/u/26346480?v=4)](https://github.com/lruozzi9 "lruozzi9 (33 commits)")[![Wojdylak](https://avatars.githubusercontent.com/u/33687392?v=4)](https://github.com/Wojdylak "Wojdylak (8 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (7 commits)")[![antiseptikk](https://avatars.githubusercontent.com/u/1520152?v=4)](https://github.com/antiseptikk "antiseptikk (3 commits)")[![Rafikooo](https://avatars.githubusercontent.com/u/40125720?v=4)](https://github.com/Rafikooo "Rafikooo (2 commits)")[![oallain](https://avatars.githubusercontent.com/u/6593252?v=4)](https://github.com/oallain "oallain (1 commits)")

---

Tags

phpsyliussymfonysyliussylius-plugin

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Psalm, Rector

Type Coverage Yes

### Embed Badge

![Health badge](/badges/webgriffe-sylius-back-in-stock-notification-plugin/health.svg)

```
[![Health](https://phpackages.com/badges/webgriffe-sylius-back-in-stock-notification-plugin/health.svg)](https://phpackages.com/packages/webgriffe-sylius-back-in-stock-notification-plugin)
```

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.5k5.9M738](/packages/sylius-sylius)[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k17.9M388](/packages/easycorp-easyadmin-bundle)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.6M577](/packages/shopware-core)[open-dxp/opendxp

Content &amp; Product Management Framework (CMS/PIM)

9421.6k61](/packages/open-dxp-opendxp)[oro/platform

Business Application Platform (BAP)

645143.5k115](/packages/oro-platform)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.4M204](/packages/sulu-sulu)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
