Sylius Feed Plugin

A plugin for creating all kinds of feeds to any given service. Do you want to create product feeds for your Google Merchant center? Then this is the right plugin for you.

Installation

Step 1: Download the plugin

Before starting, you should say explicitly to composer to use this fork instead of the original package. To do that, add the following to your composer.json file:

{
    "repositories": [
        {
            "type": "git",
            "url": "https://github.com/webgriffe/SyliusFeedPlugin.git"
        },
        {
            "type": "git",
            "url": "https://github.com/webgriffe/doctrine-orm-batcher"
        },
        {
            "type": "git",
            "url": "https://github.com/webgriffe/DoctrineORMBatcherBundle.git"
        }
    ]
}

Then, open a command console, enter your project directory and execute the following command to download the latest stable version of this plugin:

composer require webgriffe/sylius-feed-plugin ^1.0

Step 2: Enable the plugin

Then, enable the plugin by adding the following to the list of registered plugins/bundles in the config/bundles.php file of your project:

<?php

return [
    // ...
    
    League\FlysystemBundle\FlysystemBundle::class => ['all' => true],
    Setono\SyliusFeedPlugin\SetonoSyliusFeedPlugin::class => ['all' => true],
    Setono\DoctrineORMBatcherBundle\SetonoDoctrineORMBatcherBundle::class => ['all' => true],
    
    // It is important to add plugin before the grid bundle
    Sylius\Bundle\GridBundle\SyliusGridBundle::class => ['all' => true],
        
    // ...
];

NOTE that you must instantiate the plugin before the grid bundle, else you will see an exception like You have requested a non-existent parameter "setono_sylius_feed.model.feed.class".

Step 3: Import routing

# config/routes/setono_sylius_feed.yaml
setono_sylius_feed_admin:
    resource: "@SetonoSyliusFeedPlugin/config/routes/admin.php"
    prefix: '/%sylius_admin.path_name%'

setono_sylius_feed_shop:
    resource: "@SetonoSyliusFeedPlugin/config/routes/shop.php"

If you don't use localized URLs, use this routing file instead: @SetonoSyliusFeedPlugin/Resources/config/routing_non_localized.yaml

Step 4: Configure plugin

# config/packages/setono_sylius_feed.yaml
imports:
    - { resource: "@SetonoSyliusFeedPlugin/config/config.php" }

Step 5: Update database schema

Run Doctrine migrations to update the database.

bin/console doctrine:migrations:migrate

Step 6: Using asynchronous transport (optional, but recommended)

All commands in this plugin will extend the CommandInterface. Therefore, you can route all commands easily by adding this to your Messenger config:

# config/packages/messenger.yaml
framework:
    messenger:
        routing:
            # Route all command messages to the async transport
            # This presumes that you have already set up an 'async' transport
            # See docs on how to set up a transport like that: https://symfony.com/doc/current/messenger.html#transports-async-queued-messages
            'Setono\SyliusFeedPlugin\Message\Command\CommandInterface': main

Usage

After setup, you want to create a feed. Go to /admin/feeds/new and create a new feed. Remember to enable it and select one or more channels.

After that go to your console and run this command:

$ php bin/console setono:sylius-feed:process

If you haven't changed any configuration, there should be a feed with your products inside the /var/storage/setono_sylius_feed/feed directory.