Skip to content

Add Plugin Dependencies

You are viewing an outdated version of the documentation.
Click here to switch to the stable version (v6.6), or use the version switcher on the left to navigate between versions.

Add Plugin Dependencies

New in Shopware 6 is the possibility to properly require on other plugins to be in the system. This is done using the require feature from composer. Further information about this can be found in the official composer documentation.

Setup

Each plugin for Shopware 6 has to own a composer.json file for it to be a valid plugin. Creating a plugin is not explained here, make sure to read our Plugin base guide first.

Since every plugin has to own a composer.json file, you can simply refer to this plugin by its technical name and its version mentioned in the respective plugin's composer.json.

So, those are example lines of the SwagBasicExample plugin's composer.json:

json
{
    "name": "swag/swag-basic-example",
    "description": "Plugin quick start plugin",
    "version": "v1.0.0",
    ...
}

Important to note is the name as well as the version mentioned here, the rest of the file is not important for this case here. You're going to need those two information to require them in your own plugin.

In order to require the SwagBasicExample plugin now, you simply have to add these two information to your own composer.json as a key value pair:

js
// <plugin root>/composer.json
{
    "name": "swag/plugin-dependency",
    "description": "Plugin requiring other plugins",
    "version": "v1.0.0",
    "type": "shopware-platform-plugin",
    "license": "MIT",
    "authors": [
        {
            "name": "shopware AG",
            "role": "Manufacturer"
        }
    ],
    "require": {
        "shopware/core": "6.1.*",
        "swag/SwagBasicExample": "v1.0.0"
    },
    "extra": {
        "shopware-plugin-class": "Swag\\PluginDependency\\PluginDependency",
        "label": {
            "de-DE": "Plugin mit Plugin-Abhängigkeiten",
            "en-GB": "Plugin with plugin dependencies"
        },
        "description": {
            "de-DE": "Plugin mit Plugin-Abhängigkeiten",
            "en-GB": "Plugin with plugin dependencies"
        }
    },
    "autoload": {
        "psr-4": {
            "Swag\\PluginDependency\\": "src/"
        }
    }
}

Have a detailed look at the require keyword, which now requires both the Shopware 6 version, which always has to be mentioned in your composer.json, as well as the previously mentioned plugin and its version. Just as in composer itself, you can also use version wildcards, such as v1.0.* to only require the other plugin's minor version to be 1.1, not taking the patch version into account when it comes to find the matching plugin version.

Now your plugin isn't installable anymore, until that requirement is fulfilled.

More interesting topics