PHPackages                             bitbag/vuestorefront-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. [Testing &amp; Quality](/categories/testing)
4. /
5. bitbag/vuestorefront-plugin

ActiveSylius-plugin[Testing &amp; Quality](/categories/testing)

bitbag/vuestorefront-plugin
===========================

BitBag VueStorefront bridge for Sylius.

v2.1.1(5y ago)448.3k22MITPHPPHP ^7.3

Since Feb 20Pushed 2y ago17 watchersCompare

[ Source](https://github.com/BitBagCommerce/SyliusVueStorefrontPlugin)[ Packagist](https://packagist.org/packages/bitbag/vuestorefront-plugin)[ RSS](/packages/bitbag-vuestorefront-plugin/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (4)Dependencies (26)Versions (9)Used By (0)

> ⚠️ **BEWARE!**The current solution is deprecated as it was created for Vue Storefront v1. For Vue Storefront 2 integration check out our GraphQL-based integration, which could be found here:
>
>
>
>
>
> If you want to know more about the new integration, read our blog -&gt;

[![](https://camo.githubusercontent.com/cf22de85ca1ebb98e6d94952dd0b07aeb222d73c61ca63dfb332e212b05c4b96/68747470733a2f2f6269746261672e696f2f77702d636f6e74656e742f75706c6f6164732f323032302f31302f7673662e706e67)](https://bitbag.io/contact-us/?utm_source=github&utm_medium=referral&utm_campaign=plugins_vsf)
=================================================================================================================================================================================================================================================================================================================

[](#)

BitBag SyliusVueStorefrontPlugin
================================

[](#bitbag-syliusvuestorefrontplugin)

[![](https://camo.githubusercontent.com/148dbe589552028939d8937a4cf47a1ea87ec27596bbc824b47ee2ca963ab7bd/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6269746261672f76756573746f726566726f6e742d706c7567696e2e737667) ](https://packagist.org/packages/bitbag/vuestorefront-plugin "License") [ ![](https://camo.githubusercontent.com/5805f01e2a7e0e2ac860493121f2908789b625a1542fd63cf8e8f3b7c390496e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6269746261672f76756573746f726566726f6e742d706c7567696e2e737667) ](https://packagist.org/packages/bitbag/vuestorefront-plugin "Version") [ ![](https://camo.githubusercontent.com/646f3aa5e0362214051728b04d5230426ed1af4bfc908c6cee39478b20506201/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f426974426167436f6d6d657263652f53796c69757356756553746f726566726f6e74506c7567696e2e737667) ](https://scrutinizer-ci.com/g/BitBagCommerce/SyliusVueStorefrontPlugin/ "Scrutinizer") [![](https://camo.githubusercontent.com/9f1f4c65d42a28af0c5620d6d3af5981e0629226a3d84ccbf53db6d3c43e603c/68747470733a2f2f706f7365722e707567782e6f72672f6269746261672f76756573746f726566726f6e742d706c7567696e2f646f776e6c6f616473)](https://packagist.org/packages/bitbag/vuestorefront-plugin "Total Downloads") [![Slack](https://camo.githubusercontent.com/7c3c0528951f31d3e19ae8c1b92e612431e7864cdd59e9861aef25807340f91e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f636f6d6d756e697479253230636861742d736c61636b2d4646313439332e737667)](http://sylius-devs.slack.com) [![Support](https://camo.githubusercontent.com/e2e1becf96ac10cfcfae03397fd7c605cca341564088ccd453d91e1d2024a14b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f737570706f72742d636f6e74616374253230617574686f722d626c7565253544)](https://bitbag.io/contact-us/?utm_source=github&utm_medium=referral&utm_campaign=plugins_vsf)

At BitBag we do believe in open source. However, we are able to do it just because of our awesome clients, who are kind enough to share some parts of our work with the community. Therefore, if you feel like there is a possibility for us working together, feel free to reach us out. You will find out more about our professional services, technologies and contact details at [https://bitbag.io/](https://bitbag.io/?utm_source=github&utm_medium=referral&utm_campaign=plugins_vsf).

Table of Content
----------------

[](#table-of-content)

- [Overview](#overview)
- [Support](#we-are-here-to-help)
- [Installation](#installation)
    - [Supported versions](#supported-versions)
    - [Requirements](#requirements)
    - [Architecture](#architecture)
- [Using the plugin within Sylius Standard app, with VSF](#using-the-plugin-within-sylius-standard-app-with-VSF)
- [Known issues](#known-issues)
- [Extending the plugin](#extending-the-plugin)
- [About us](#about-us)
    - [Community](#community)
- [Demo Sylius shop](#demo-sylius-shop)
- [Additional Sylius resources for developers](#additional-resources-for-developers)
- [License](#license)
- [Contact](#contact)

Overview
========

[](#overview)

This document assumes that you are already familiar with Vue Storefront and its technology stack.
If that's not the case please check [VSF Documentation](https://docs.vuestorefront.io/guide/) and [GitHub repository](https://github.com/DivanteLtd/vue-storefront).

Please also check [Sylius Documentation](https://docs.sylius.com/en/latest/) and [Sylius-Standard](https://github.com/Sylius/Sylius-Standard) if you are new to Sylius.

Depending on your preferences, the plugin can also fully replace [VSF API](https://github.com/DivanteLtd/vue-storefront-api/) - you will only need VSF front app if you choose so.
Sylius ShopBundle is also no longer needed as Vue Storefront will be your new ... Storefront. :)

We are here to help
-------------------

[](#we-are-here-to-help)

This **open-source plugin was developed to help the Sylius community**. If you have any additional questions, would like help with installing or configuring the plugin or need any assistance with your Sylius project - let us know!

[![](https://camo.githubusercontent.com/bc809b81359538ae823cb36f284286a258f910db2498c8ba92faad4c30344b57/68747470733a2f2f6269746261672e696f2f77702d636f6e74656e742f75706c6f6164732f323032302f31302f627574746f6e2d636f6e746163742e706e67)](https://bitbag.io/contact-us/?utm_source=github&utm_medium=referral&utm_campaign=plugins_vsf)

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

[](#installation)

### Supported versions

[](#supported-versions)

Plugin versionSylius versionSupported VSF versionv2.1.11.81.12.2v1.0.0-beta.11.61.11.4### Requirements

[](#requirements)

We work on stable, supported and up-to-date versions of packages. We recommend you to do the same.
Please also check [Vue Storefront requirements](https://docs.vuestorefront.io/guide/installation/linux-mac.html#requirements).

PackageVersionPHP7.4 (&gt;= 7.3)MySQL8.0.x (&gt;= 5.7)Elasticsearch6.8.xVue Storefront1.12**Important note**
Please inspect files stored in `tests/Application` directory (especially `config` subdirectory)
to make sure that you fully understand installation steps written below.

We recommend you to disable Sylius ShopBundle as you will no longer need it.
Please refer to [Sylius Documentation - How to disable Sylius shop?](https://docs.sylius.com/en/1.6/cookbook/configuration/disabling-shop-admin-api.html#how-to-disable-sylius-shop) for details.

---

First, add this plugin as dependency to your Sylius project.

```
$ composer require bitbag/vuestorefront-plugin:v2.1.1

```

Add the plugin to `config/bundles.php` (if it's not there already):

```
return [
    ...
    FOS\ElasticaBundle\FOSElasticaBundle::class => ['all' => true],
    BitBag\SyliusVueStorefrontPlugin\SyliusVueStorefrontPlugin::class => ['all' => true],
    Lexik\Bundle\JWTAuthenticationBundle\LexikJWTAuthenticationBundle::class => ['all' => true],
    Gesdinet\JWTRefreshTokenBundle\GesdinetJWTRefreshTokenBundle::class => ['all' => true],

    // Optional, for handling CORS (Cross-Origin Resource Sharing) requests
    Nelmio\CorsBundle\NelmioCorsBundle::class => ['all' => true],
];

```

---

Add few variables to your .env file:

```
APP_CHANNEL_CODE=""

JWT_SECRET_KEY=%kernel.project_dir%/config/jwt/private.pem
JWT_PUBLIC_KEY=%kernel.project_dir%/config/jwt/public.pem
JWT_PASSPHRASE=bitbag

ELASTICSEARCH_HOST=localhost
ELASTICSEARCH_PORT=9200
ELASTICSEARCH_INDEX=vue_storefront_catalog

// Set transport value to "https" and ssl to "true" when using an ssl connection
ELASTICSEARCH_TRANSPORT=http
ELASTICSEARCH_SSL=false
// Leave blank if authentication is not required
ELASTICSEARCH_USERNAME=
ELASTICSEARCH_PASSWORD=

// Optionally, when using Nelmio CORS Bundle
CORS_ALLOW_ORIGIN=^https?://(localhost|127\.0\.0\.1)(:[0-9]+)?$

```

To generate JWT public and secret keys please run commands below in Sylius' project directory:

```
$ mkdir -p config/jwt
$ openssl genpkey -out config/jwt/private.pem -aes256 -algorithm rsa -pkeyopt rsa_keygen_bits:4096
$ openssl pkey -in config/jwt/private.pem -out config/jwt/public.pem -pubout

```

Then set value of `JWT_PASSPHRASE` environment variable with passphrase that you've entered during running commands above.

---

Next step is to add a following line to the end of the `imports` section in your `config/packages/_sylius.yaml`:

```
- { resource: "@SyliusVueStorefrontPlugin/Resources/config/config.yaml" }

```

It's needed to load some plugin configuration.

---

Now it is needed to edit `config/packages/security.yaml` file.

Add a line below to `parameters` key at the top of the file:

```
bitbag.vue_storefront.security.regex: "^/vsbridge"

```

Add a code below to the top of `security -> firewalls` key (an order is really important there):

```
        vs_bridge_user_login:
            pattern: "%bitbag.vue_storefront.security.regex%/user/login"
            stateless: true
            anonymous: true
            provider: sylius_shop_user_provider
            json_login:
                provider: sylius_shop_user_provider
                check_path: /vsbridge/user/login
                password_path: password
                success_handler: bitbag_sylius_vue_storefront_plugin.lexik_jwt_authentication.handler.authentication_success
                failure_handler: bitbag_sylius_vue_storefront_plugin.lexik_jwt_authentication.handler.authentication_failure
                require_previous_session: false

        vs_bridge:
            pattern: "%bitbag.vue_storefront.security.regex%"
            stateless: true
            anonymous: true
            provider: sylius_shop_user_provider
            guard:
                provider: sylius_shop_user_provider
                authenticators:
                    - lexik_jwt_authentication.jwt_token_authenticator

```

So it should look like this:

```
    firewalls:
        vs_bridge_user_login:
            pattern: "%bitbag.vue_storefront.security.regex%/user/login"
            stateless: true
            anonymous: true
            provider: sylius_shop_user_provider
            json_login:
                provider: sylius_shop_user_provider
                check_path: /vsbridge/user/login
                password_path: password
                success_handler: bitbag_sylius_vue_storefront_plugin.lexik_jwt_authentication.handler.authentication_success
                failure_handler: bitbag_sylius_vue_storefront_plugin.lexik_jwt_authentication.handler.authentication_failure
                require_previous_session: false

        vs_bridge:
            pattern: "%bitbag.vue_storefront.security.regex%"
            stateless: true
            anonymous: true
            provider: sylius_shop_user_provider
            guard:
                provider: sylius_shop_user_provider
                authenticators:
                    - lexik_jwt_authentication.jwt_token_authenticator

```

Afterwards add a line below to `security -> access_control` part:

```
- { path: "%bitbag.vue_storefront.security.regex%/user/login", role: IS_AUTHENTICATED_ANONYMOUSLY }

```

---

Now go to `config/routes.yaml` file in your Sylius app and paste there:

```
sylius_vue_storefront_plugin:
    resource: "@SyliusVueStorefrontPlugin/Resources/config/routing.yaml"

```

to load configuration of all routes for API endpoints.

---

Create new file `gesdinet_jwt_refresh_token.yaml` (or name it however you like) inside `config/packages` directory and paste inside it:

```
gesdinet_jwt_refresh_token:
    firewall: vs_bridge
    token_parameter_name: refreshToken
    user_provider: sylius_shop_user_provider

```

---

Replace content of your `config/packages/lexik_jwt_authentication.yaml` file with the following configuration:

```
lexik_jwt_authentication:
    secret_key: '%env(resolve:JWT_SECRET_KEY)%'
    public_key: '%env(resolve:JWT_PUBLIC_KEY)%'
    pass_phrase: '%env(JWT_PASSPHRASE)%'

    token_extractors:
        query_parameter:
            enabled: true
            name: token

```

---

Afterwards add:

```
translator: { fallbacks: ["%locale%"] }

```

under your `framework` key in `config/packages/framework.yaml` so it should look like this afterwards:

```
framework:
    translator: { fallbacks: ["%locale%"] }
    secret: '%env(APP_SECRET)%'
    form: true
    csrf_protection: true
    templating: { engines: ["twig"] }
    session:
        handler_id: ~

```

---

Set content of your `config/fos_elastica.yaml` to the following:

```
imports:
    - { resource: "@SyliusVueStorefrontPlugin/Resources/config/indexes/attribute.yaml" }
    - { resource: "@SyliusVueStorefrontPlugin/Resources/config/indexes/category.yaml" }
    - { resource: "@SyliusVueStorefrontPlugin/Resources/config/indexes/product.yaml" }

fos_elastica:
    clients:
        default: { host: '%env(ELASTICSEARCH_HOST)%', port: '%env(ELASTICSEARCH_PORT)%' }

```

---

Add a following rule to `fos_rest.format_listener.rules` in your `config/packages/fos_rest.yaml`

```
- { path: '^/vsbridge/.*', priorities: ['json', 'xml'], fallback_format: json, prefer_extension: true }

```

For example the file should look like this afterwards:

```
fos_rest:
    exception: true
    view:
        formats:
            json: true
            xml:  true
        empty_content: 204
    format_listener:
        rules:
            - { path: '^/api/.*', priorities: ['json', 'xml'], fallback_format: json, prefer_extension: true }
            - { path: '^/vsbridge/.*', priorities: ['json', 'xml'], fallback_format: json, prefer_extension: true }
            - { path: '^/', stop: true }

```

---

Go to your `src/Entity/Order/OrderItem.php` file and make it to extend the `OrderItem` entity from our plugin.

Change:

```
use Sylius\Component\Core\Model\OrderItem as BaseOrderItem;

```

to:

```
use BitBag\SyliusVueStorefrontPlugin\Sylius\Entity\Order\OrderItem as BaseOrderItem;

```

---

Copy `etc/vsf-config/local.json` file from this repository to `config/local.json` of Vue Storefront project directory.
In that file you only need to replace every occurence of `` with URL of your store.
You don't have to change anything else as sensible defaults are provided by us, that are proven to work in Vue Storefront v1.12.
If your configuration settings differ from defaults provided with the plugin and you run into problems don't hesitate to create issue on GitHub or contact us directly at .

Architecture
------------

[](#architecture)

VueStorefront fetches data in two ways - **statically** and **dynamically**.
Less frequently updated data is stored in **Elasticsearch**:

1. Products
2. Categories (Sylius taxons)
3. Attributes (Sylius product options)

Everything else is fetched dynamically using provided API, including:

- customers' accounts (Sylius Customer, ShopUser)
- carts, orders (Sylius Order)
- shipping methods
- payment methods
- and more ...

### Elasticsearch

[](#elasticsearch)

Everything related to Elasticsearch is contained within `Elastisearch`with the exception of FOS Elastica Bundle configuration which can be found in `src/Resources/config/indexes` directory.
To have the data from Sylius mapped in ES, we have created `Transformer`s providing object translations to ES indexes.
Schema of indexes is described in files stored in `Document` directory.

It's important to note once again that **only Elasticsearch 6 is fully supported currently**.
Support for ES 7 is on the way - once [ruflin/elastica](https://github.com/ruflin/Elastica) and [FOSElasticaBundle](https://github.com/FriendsOfSymfony/FOSElasticaBundle) start supporting it, we will as well.

Using the plugin within Sylius Standard app, with VSF
-----------------------------------------------------

[](#using-the-plugin-within-sylius-standard-app-with-vsf)

It is no surprise that you must have products, taxons etc. within your Sylius instance to benefit from VSF.
Therefore we assume that you have a shop already running.
If it's not the case you might want to run commands below on freshly cloned [Sylius Standard](https://github.com/Sylius/Sylius-Standard) repository:

```
$ composer install
$ yarn install
$ yarn build
$ php bin/console doctrine:database:create
$ php bin/console doctrine:schema:update --force
$ php bin/console sylius:fixtures:load

```

.. to add all needed entities from fixtures to database.

Only then you can run

```
$ php bin/console fos:elastica:populate

```

to populate Elasticsearch indexes and let refresher contained within the plugin to automatically update the data in ES in real time.

### Known issues

[](#known-issues)

#### Translatable trait error during loading fixtures

[](#translatable-trait-error-during-loading-fixtures)

[![](doc/fixtures_error.png)](doc/fixtures_error.png)

In case of this error - to be able to load the fixtures, go to the `vendor/bitbag/vuestorefront-plugin/src/Resources/config/indexes/product.yaml` file and comment last line in there (the `defer:true` one).

Then clear the cache, load fixtures and uncomment this line afterwards.

#### Getting 500 error related to taxa (`taxons`)

[](#getting-500-error-related-to-taxa-taxons)

If you see something like this for example in your admin panel:

```
{
    "result": "Variable \"taxons\" does not exist.",
    "code": 500
}

```

it means you are using invalid version of `doctrine/inflector` package.

To fix it add a following block into your `composer.json` file:

```
"conflict": {
    "doctrine/inflector": "^1.4"
},

```

Make sure that

```
"bitbag/vuestorefront-plugin": "v2.1.1"

```

is present in `require` section in your `composer.json` file and then run:

```
$ composer update

```

Extending the plugin
--------------------

[](#extending-the-plugin)

### Extending requests, commands/queries

[](#extending-requests-commandsqueries)

The easiest way to extend the existing request classes and add new properties is to inherit from them.
Because of the way we denormalize incoming requests, you don't need constructor in that class. You must only:

- add public properties to the class
- override `getCommand()` or `getQuery()` method

Optionally you may want to add constraint to your properties that would validate incoming data.
We use separate .xml files for that as you can see in `src/Resources/config/validation` directory.

For example let's add locale to the coupon:

```
use BitBag\SyliusVueStorefrontPlugin\Request\Cart\ApplyCouponRequest;

final class ApplyLocalizedCouponRequest extends ApplyCouponRequest
{
    /** @var string */
    pubic $locale;

    public function getCommand(): CommandInterface
    {
        return new ApplyCoupon($this->token, $this->cartId, $this->coupon, $this->locale);
    }
}

```

In the same manner the command would need to be created extending the ApplyCoupon class.
Then you only need to change one parameter in the configuration file:

```
bitbag_sylius_vue_storefront_plugin:
    request_classes:
        apply_coupon: \AddLocalizedCouponRequest

```

### Extending handlers

[](#extending-handlers)

The main way to extend a handler is to decorate it. This makes adding functionality before and after the handler easy.
Please check example of extending view below and/or follow [Symfony Documentation - How to Decorate Services](https://symfony.com/doc/4.4/service_container/service_decoration.html) guide.

However, if you want to change the logic in the handler, you need to overwrite it.
This can be done by registering the new handler with the same service id.
Do not just add it with a new service id otherwise, it will execute both handlers.

### Extending views

[](#extending-views)

When extending the views, two places need to be modified - view class and view factory.

ViewFactories should be decorated just like Handlers mentioned above. You can also completely override them if you prefer to do so.

```
use BitBag\SyliusVueStorefrontPlugin\Factory\Cart\Totals\TotalsViewFactoryInterface;

class NiceTotalViewFactory implements TotalViewFactoryInterface
{
    private $innerTotalViewFactory;

    public function __construct(TotalsViewFactoryInterface $innerTotalViewFactory)
    {
        $this->innerTotalViewFactory = $innerTotalViewFactory;
    }

    public function create(OrderInterface $order): NiceTotalView
    {
        /** @var NiceTotalView $totalView */
        $totalView = $this->innerTotalViewFactory->createNew();

        $totalView->nicePersonDiscount = $orderInterface->getNiceDiscount();

        return $totalView;
    }
}

```

You need to define this service in xml (or yaml) file:

```

```

and change the view class in configuration file:

```
bitbag_sylius_vue_storefront_plugin:
    view_classes:
        totals: \NiceTotalView

```

About us
========

[](#about-us)

BitBag is an agency that provides high-quality **eCommerce and Digital Experience software**. Our main area of expertise includes eCommerce consulting and development for B2C, B2B, and Multi-vendor Marketplaces. The scope of our services related to Sylius includes:

- **Consulting** in the field of strategy development
- Personalized **headless software development**
- **System maintenance and long-term support**
- **Outsourcing**
- **Plugin development**
- **Data migration**

Some numbers regarding Sylius:

- **20+ experts** including consultants, UI/UX designers, Sylius trained front-end and back-end developers,
- **100+ projects** delivered on top of Sylius,
- Clients from **20+ countries**
- **3+ years** in the Sylius ecosystem.

---

If you need some help with Sylius development, don't be hesitate to contact us directly. You can fill the form on [this site](https://bitbag.io/contact-us/?utm_source=github&utm_medium=referral&utm_campaign=plugins_vsf) or send us an e-mail to !

---

[![](https://camo.githubusercontent.com/c74a1586e9e31f97741dcc138d46fada78f3a8aa59484a475f8df6da53d3c395/68747470733a2f2f6269746261672e696f2f77702d636f6e74656e742f75706c6f6164732f323032302f31302f6261646765732d73796c6975732e706e67)](https://bitbag.io/contact-us/?utm_source=github&utm_medium=referral&utm_campaign=plugins_vsf)

Community
---------

[](#community)

For online communication, we invite you to chat with us &amp; other users on [Sylius Slack](https://sylius-devs.slack.com/).

Vue Storefront + Sylius Demo
============================

[](#vue-storefront--sylius-demo)

We've created a demo app that showcases usage of this plugin. Visit [vsf.bitbag.shop](https://vsf.bitbag.shop) to check it out!
The Sylius admin panel is accessible at [syliusvsf.bitbag.shop/admin](https://syliusvsf.bitbag.shop/admin). Admin credentials: `sylius : sylius`. **If you need an overview of this plugin, schedule a consultation with our expert.**

[![](https://camo.githubusercontent.com/4c6ea591dec86437168f65512783b6a71f9db2f7a029df90625601562f9afefe/68747470733a2f2f6269746261672e696f2f77702d636f6e74656e742f75706c6f6164732f323032302f31302f627574746f6e5f667265655f636f6e73756c61746174696f6e2d312e706e67)](https://bitbag.io/contact-us/?utm_source=github&utm_medium=referral&utm_campaign=plugins_vsf)

Additional resources for developers
-----------------------------------

[](#additional-resources-for-developers)

To be able to contribute to the plugin make sure that you familiarize yourself with:

- [Vue Storefront Integration SDK](https://github.com/DivanteLtd/vue-storefront-integration-sdk/)
- Vue Storefront
- Vue Storefront API
- [Sylius Shop API Plugin](https://github.com/Sylius/ShopApiPlugin/)
- [Sylius Contribution Guide](https://docs.sylius.com/en/latest/contributing/)

Additionally you might want to get to know VSF better:

- [Vue Storefront Documentation](https://docs.vuestorefront.io/guide/) - to learn how to customize VSF frontend part
- [Vue Storefront Journal](https://medium.com/the-vue-storefront-journal) - blog where new ideas are shared and what lies ahead is announced

License
-------

[](#license)

This plugin's source code is completely free and released under the terms of the MIT license.

Contact
-------

[](#contact)

If you want to contact us, the best way is to fill the form on [our website](https://bitbag.io/contact-us/?utm_source=github&utm_medium=referral&utm_campaign=plugins_vsf) or send us an e-mail to  with your question(s). We guarantee that we answer as soon as we can!

[![](https://camo.githubusercontent.com/139aa8577c6b91c54c3bc509e5ae3f9aac71464e8c92d2cb1c46ee11bbce1fe0/68747470733a2f2f6269746261672e696f2f77702d636f6e74656e742f75706c6f6164732f323032302f31302f666f6f7465722e706e67)](https://bitbag.io/contact-us/?utm_source=github&utm_medium=referral&utm_campaign=plugins_vsf)

###  Health Score

36

—

LowBetter than 82% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity33

Limited adoption so far

Community26

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~114 days

Total

4

Last Release

1934d ago

Major Versions

v1.0.0-beta.1 → v2.0.02020-10-21

PHP version history (2 changes)v1.0.0-beta.1PHP ^7.2

v2.0.0PHP ^7.3

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/15603601?v=4)[bitbag](/maintainers/bitbag)[@bitbag](https://github.com/bitbag)

---

Top Contributors

[![Codeweld](https://avatars.githubusercontent.com/u/50198366?v=4)](https://github.com/Codeweld "Codeweld (81 commits)")[![SzymonKaminski](https://avatars.githubusercontent.com/u/8536735?v=4)](https://github.com/SzymonKaminski "SzymonKaminski (80 commits)")[![Pablossoo](https://avatars.githubusercontent.com/u/12602313?v=4)](https://github.com/Pablossoo "Pablossoo (64 commits)")[![bitbager](https://avatars.githubusercontent.com/u/28542010?v=4)](https://github.com/bitbager "bitbager (15 commits)")[![senghe](https://avatars.githubusercontent.com/u/2512726?v=4)](https://github.com/senghe "senghe (12 commits)")[![RadnoK](https://avatars.githubusercontent.com/u/1699311?v=4)](https://github.com/RadnoK "RadnoK (8 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (6 commits)")[![czechmarcin](https://avatars.githubusercontent.com/u/22669715?v=4)](https://github.com/czechmarcin "czechmarcin (5 commits)")[![medteck](https://avatars.githubusercontent.com/u/12381774?v=4)](https://github.com/medteck "medteck (4 commits)")[![MacBalc](https://avatars.githubusercontent.com/u/124139291?v=4)](https://github.com/MacBalc "MacBalc (4 commits)")[![KrisFlorq](https://avatars.githubusercontent.com/u/48692047?v=4)](https://github.com/KrisFlorq "KrisFlorq (2 commits)")[![EvgKonkin](https://avatars.githubusercontent.com/u/15088670?v=4)](https://github.com/EvgKonkin "EvgKonkin (1 commits)")[![patrick477](https://avatars.githubusercontent.com/u/21317699?v=4)](https://github.com/patrick477 "patrick477 (1 commits)")[![dawkaa](https://avatars.githubusercontent.com/u/22916913?v=4)](https://github.com/dawkaa "dawkaa (1 commits)")[![JoppeDC](https://avatars.githubusercontent.com/u/9723620?v=4)](https://github.com/JoppeDC "JoppeDC (1 commits)")

---

Tags

action-domain-responderphpspecphpunitsylius-pluginsymfonyvue-storefrontsyliussylius-pluginsylius vuestorefront

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/bitbag-vuestorefront-plugin/health.svg)

```
[![Health](https://phpackages.com/badges/bitbag-vuestorefront-plugin/health.svg)](https://phpackages.com/packages/bitbag-vuestorefront-plugin)
```

###  Alternatives

[sylius/sylius

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

8.4k5.6M651](/packages/sylius-sylius)[sylius/invoicing-plugin

Invoicing plugin for Sylius.

901.0M2](/packages/sylius-invoicing-plugin)[sylius/refund-plugin

Plugin provides basic refunds functionality for Sylius application.

691.7M14](/packages/sylius-refund-plugin)[synolia/sylius-akeneo-plugin

Akeneo connector for Sylius.

2696.0k](/packages/synolia-sylius-akeneo-plugin)[kadirov/api-starter-kit

443.9k](/packages/kadirov-api-starter-kit)[monsieurbiz/sylius-search-plugin

A search plugin using Elasticsearch for Sylius.

49121.5k](/packages/monsieurbiz-sylius-search-plugin)

PHPackages © 2026

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