Shopware Integration – Unidy Documentation

The Unidy Shopware Plugin by Fuexchen enables seamless integration of Shopware 6 with the Unidy account and SSO solution. This ensures a smooth and unified login experience for your customers while giving you full control over the available ordering options.

Key Features

Seamless Shopware 6 Integration – Connect your Shopware store with Unidy effortlessly.

Simple Login with Unidy SSO – Enable easy access for your customers via Unidy's Single Sign-On.

Flexible Checkout Options – Decide whether customers can order as guests, via a Shopware 6 account, or with Unidy.

Centralized Address Management – Synchronize customer address data with Unidy for consistent user profiles.

Fully Integrated Ecosystem – Make Shopware 6 a seamless part of your Unidy environment.

With the Unidy Shopware Plugin, you enhance the shopping experience, simplify user management, and ensure data consistency across platforms. 🚀

1.1. Integration

After installing the Unidy Shopware Plugin, please contact your Customer Success Management for the required oAuth credentials.

Afterward, simply enter the domain of your Unidy instance and the provided oAuth credentials in the plugin settings.

With just a few checkboxes, you can configure the user experience in your shop, defining how customers interact with login and checkout options. Once set up, you're ready to go!

1.2. Additional Articles for Shopware Integration

Synchronizing User Groups from Unidy to Shopware

With the following implementation, user groups from Unidy can be synchronized with Shopware and assigned specific rights such as discounts, pre-sale access, or other privileges.

To achieve this, simply create a new subscriber that listens to two events:

Fuexchen\FuexcUnidyLogin\Event\UnidyOauthScopes

This event allows you to extend the requested scopes from Unidy.

Fuexchen\FuexcUnidyLogin\Event\UnidyCustomerObjectBuild

This event enables you to extend the generated customer mapping with additional fields.

ℹ️

These events are available starting from version 1.2.3 of the plugin. To apply this approach to existing users, ensure that the plugin settings are configured to update user data on login.

Example Code:

<?php declare(strict_types=1);

namespace example\Subscriber;

use Fuexchen\FuexcUnidyLogin\Event\UnidyCustomerObjectBuild;
use Fuexchen\FuexcUnidyLogin\Event\UnidyOauthScopes;
use Symfony\Component\EventDispatcher\EventSubscriberInterface;

class UnidyDataMappingSubscriber implements EventSubscriberInterface
{
  public static function getSubscribedEvents(): array
  {
    return [
      UnidyOauthScopes::EVENT_NAME => 'onUnidyOauthScopes',
      UnidyCustomerObjectBuild::EVENT_NAME => 'onUnidyCustomerObjectBuild',
    ];
  }

  public function onUnidyOauthScopes(UnidyOauthScopes $event): void
  {
    $event->addScope('active_membership');
  }

  public function onUnidyCustomerObjectBuild(UnidyCustomerObjectBuild $event): void
  {
    $unidyData = $event->getUnidyData();
    $customerData = $event->getBuildData();
    if (!isset($customerData['customFields'])) {
      $customerData['customFields'] = [];
    }
    $customerData['customFields']['custom_example_is_member'] = $unidyData->active_membership->{"1234567890"} ?? false;
    $event->setBuildData($customerData);
  }
}