Installation

This installation instruction assumes that you're using Symfony Flex. If you don't, take a look at the manual installation, but we strongly recommend using Flex for speed and simplicity.

1. Prepare Your Environment

Before installing the plugin, ensure that your project:

• Uses Symfony Flex

• Runs a supported Sylius 2.x version

• Has yarn and Symfony Encore correctly configured

2. Allow Symfony Contrib Recipes

To allow Symfony to install community recipes:

composer config extra.symfony.allow-contrib true

If prompted during plugin installation, accept the community recipe when asked.

3. Install the Plugin via Composer

composer require sylius/wishlist-plugin

This will install the plugin and apply the Flex recipe, registering the necessary services and configuration automatically.

4. Install and build assets

bin/console assets:install public

yarn install
yarn encore dev # or yarn encore prod

5. Run Doctrine Migrations

The plugin comes with database changes. Run:

bin/console doctrine:migrations:migrate # add `-e prod` for production

6. Clear the Symfony Cache

Finally, clear the Symfony cache to ensure changes are applied:

bin/console cache:clear

Using Asynchronous Messenger?

If your application uses asynchronous Messenger transport by default, make sure that Wishlist commands are executed synchronously.

Follow the guide here: Configuring Messenger