README

Sylius Upsell Plugin

Post-purchase upsell and cross-sell plugin for Sylius 2.x stores — Frequently Bought Together, checkout upsell modals, and one-click add-all-to-cart.

Screenshots

Admin — Upsell Offers Grid

Admin — Upsell Offer Form

Shop — Checkout Upsell Modal

Admin — Upsell Analytics Dashboard

Features

• Frequently Bought Together section on every product page with manual or algorithmic product suggestions
• One-click add-all-to-cart for the entire FBT bundle
• Algorithmic co-purchase detection from order history with configurable thresholds
• Checkout upsell modal — intercepts "Place order" with a special offer before completing the order
• Trigger product targeting — tie offers to specific products in the cart, or use catch-all
• Discount percentage — upsell product added to cart at discounted price
• Customizable copy — headline, body, CTA label, and decline label per offer
• Date scheduling — start and end dates for time-limited offers
• Priority system — control which offer wins when multiple match
• Admin CRUD for upsell offers under Marketing, and global FBT settings under Configuration
• Drag-and-drop reordering of manual FBT relations with optional discount badges
• Analytics dashboard — impressions, acceptance rate, extra revenue, daily chart (Chart.js)
• Impression tracking — automatic for both FBT and checkout upsell (shown / accepted / declined)

Requirements

• Sylius 2.1+
• Symfony 7.0+
• PHP 8.2+

Installation

1. Require the plugin:

composer require abderrahimghazali/sylius-upsell-plugin

1. Register the bundle in config/bundles.php (if not auto-discovered):

return [
    // ...
    Abderrahim\SyliusUpsellPlugin\SyliusUpsellPlugin::class => ['all' => true],
];

1. Import routes — create config/routes/sylius_upsell.yaml:

sylius_upsell:
    resource: '@SyliusUpsellPlugin/config/routes.yaml'

1. Generate and run the migration:

bin/console doctrine:migrations:diff
bin/console doctrine:migrations:migrate

1. Register the Stimulus controllers in assets/shop/controllers.json:

{
    "controllers": {
        "@abderrahimghazali/sylius-upsell-plugin": {
            "fbt": {
                "enabled": true,
                "fetch": "eager"
            },
            "post-purchase": {
                "enabled": true,
                "fetch": "eager"
            }
        }
    }
}

1. Symlink the plugin assets and rebuild:

Add to your project's package.json dependencies:

"@abderrahimghazali/sylius-upsell-plugin": "file:vendor/abderrahimghazali/sylius-upsell-plugin/assets"

Then install and rebuild:

npm install
npm run build

Entity: UpsellRelation

Entity: UpsellOffer

Entity: UpsellConfiguration

Architecture

src/
├── Controller/
│   ├── Admin/
│   │   ├── UpsellConfigurationController.php    # Global FBT settings
│   │   └── UpsellOfferController.php            # CRUD for upsell offers
│   └── Shop/
│       ├── ImpressionController.php             # Impression tracking API
│       └── PostPurchaseController.php           # Accept/decline offer API
├── DependencyInjection/
│   ├── Configuration.php
│   └── SyliusUpsellExtension.php                # Prepends resources, grids, hooks
├── Entity/
│   ├── UpsellConfiguration.php
│   ├── UpsellImpression.php
│   ├── UpsellOffer.php
│   ├── UpsellOfferInterface.php
│   ├── UpsellRelation.php
│   └── UpsellRelationInterface.php
├── EventListener/
│   ├── AdminMenuListener.php                    # Marketing menu items
│   └── ProductFormListener.php                  # FBT tab on product form
├── Form/Type/
│   ├── ProductUpsellType.php                    # Product FBT relations form
│   ├── UpsellConfigurationType.php              # Global settings form
│   ├── UpsellOfferType.php                      # Upsell offer form
│   └── UpsellRelationType.php                   # Single relation row form
├── Repository/
│   ├── UpsellImpressionRepository.php           # Analytics queries
│   ├── UpsellOfferRepository.php                # Active offers query
│   └── UpsellRelationRepository.php             # Relations by product
├── Service/
│   ├── FrequentlyBoughtTogetherResolver.php     # FBT logic (manual + algorithmic)
│   ├── PostPurchaseOfferResolver.php            # Best matching offer for an order
│   ├── UpsellAnalyticsService.php               # Impression recording + analytics
│   └── UpsellConfigurationProvider.php          # Cached config access
├── Twig/UpsellExtension.php                     # Twig function bridge
└── SyliusUpsellPlugin.php                       # Bundle class

assets/
├── controllers/
│   ├── fbt-controller.js                        # Add-all-to-cart Stimulus controller
│   └── post-purchase-controller.js              # Upsell modal Stimulus controller
└── package.json

templates/
├── Admin/
│   ├── analytics.html.twig                      # Analytics dashboard with Chart.js
│   ├── configuration.html.twig                  # Global settings page
│   └── upsell_offer/
│       ├── create.html.twig
│       ├── update.html.twig
│       └── grid/field/product.html.twig
└── Shop/
    ├── frequently_bought_together.html.twig     # FBT section on product page
    └── post_purchase_offer.html.twig            # Upsell modal after checkout

Testing

vendor/bin/phpunit

License

MIT. See LICENSE.