Search by

odiseoteam / sylius-vendor-plugin

odiseo

Vendor plugin for Sylius. Add Vendor (Brand) to your products

Package info

github.com/odiseoteam/SyliusVendorPlugin

Type:sylius-plugin

pkg:composer/odiseoteam/sylius-vendor-plugin

Statistics

Installs: 69 511

Dependents: 1

Suggesters: 0

Stars: 63

Open Issues: 2


README

Odiseo Sylius Vendor Plugin

Version Downloads Build status Sylius versions PHP version License

Introduction

This plugin adds vendors (brands) to your Sylius store. A vendor is an entity that owns products and is fully manageable from the admin panel.

What makes this plugin different?

  • ✅ Vendors per channel - Enable each vendor on the channels you want
  • ✅ Translatable content - The vendor description is translatable per locale
  • ✅ Multiple emails - Each vendor has a primary email plus an unlimited list of extra emails
  • ✅ Logo management - Logos are stored through a Gaufrette filesystem and rendered with Liip Imagine
  • ✅ Full REST API - Admin CRUD and shop read endpoints, plus a multipart logo upload endpoint, wired automatically
  • ✅ Optional sitemap integration - Vendor URLs in your sitemap via stefandoorn/sitemap-plugin
  • ✅ 13 languages - The admin and shop UI ship translated out of the box
  • ✅ Easy to extend - Follows Sylius best practices (resources, twig hooks, services), so every part can be overridden
Screenshots
Vendors in the admin
Admin: Vendors with their logo, email and position
Editing a vendor
Editing: General data, profile and media, per channel
Vendors in the shop
Shop: A page listing every vendor
A vendor page in the shop
Vendor page: The vendor and the products it owns

Getting Started

Install it in 6 steps ⚡

  1. ✅ Require the plugin
  2. ✅ Enable the plugin
  3. ✅ Import the plugin configuration
  4. ✅ Import the routes
  5. ✅ Make your Product vendor-aware
  6. ✅ Update the database

👉 Follow the installation guide

Quick Example

Require the plugin:

composer require odiseoteam/sylius-vendor-plugin

Once the remaining steps are done, the REST API is registered automatically and a Vendors entry is added to the admin menu.

Try the demo

You can see this plugin in action in our Sylius demo application:

Premium features

Do you want advanced features? Take a look at our Multi Vendor Marketplace Plugin, which turns your Sylius store into a marketplace like Amazon, Etsy or eBay.

Documentation

  • 📦 Installation - Six steps, from Composer to the database
  • 📖 Usage - Administration, shop routes and fetching a vendor in Twig
  • 🔗 API - The shop and admin endpoints
  • 🌱 Fixtures - The vendor fixture and its options
  • 🗺️ Sitemap - Vendor URLs in your sitemap
  • 🧩 Customization - Overriding models, resources and templates
  • 🧪 Tests - Running the suites with Docker or directly
  • ⬆️ Upgrading - What changes between versions
  • 📝 Changelog - The project history
  • 🤝 Contributing - How to send a contribution

Compatibility

Package Version
PHP ^8.2
Sylius 2.0 · 2.1 · 2.2

Professional Support

This plugin is maintained by Odiseo. Need help with it, or with any Sylius project?

License

MIT.