Alles mit Composer installieren

Das freie Plugin kommt von wordpress.org über wpackagist, Pro von composer.unleash-wp.com mit deinem Lizenzschlüssel als Passwort. Hintergrund und Fehlersuche: Mit Composer installieren.

1. composer.json

{
  "repositories": [
    {
      "type": "composer",
      "url": "https://wpackagist.org",
      "only": ["wpackagist-plugin/*", "wpackagist-theme/*"]
    },
    {
      "type": "composer",
      "url": "https://composer.unleash-wp.com",
      "only": ["unleashwp/*"]
    }
  ],
  "require": {
    "composer/installers": "^2.0",
    "wpackagist-plugin/easy-svg": "^5.3.1",
    "unleashwp/easy-svg-pro": "^1.0"
  },
  "config": {
    "allow-plugins": {
      "composer/installers": true
    }
  }
}

• only beschränkt jedes Repository auf seine eigenen Pakete. So kann keine andere Quelle für unleashwp/* antworten.
• Beide Plugins landen in wp-content/plugins/easy-svg/ und wp-content/plugins/easy-svg-pro/. In Bedrock schicken deine vorhandenen installer-paths sie nach web/app/plugins/.
• Lass das freie Plugin auf ^5.3.1. Pro braucht diese Version; eine ältere installiert sich zwar, aber Pro bleibt untätig.

2. Der Schlüssel für Composer

composer config --global --auth http-basic.composer.unleash-wp.com unleashwp DEIN_LIZENZSCHLUESSEL

export COMPOSER_AUTH='{"http-basic":{"composer.unleash-wp.com":{"username":"unleashwp","password":"'"$UNLEASHWP_LICENSE_KEY"'"}}}'
composer install --no-dev --no-interaction --prefer-dist

UNLEASHWP_LICENSE_KEY ist ein Secret in deinem CI-System. wpackagist braucht keinen Schlüssel.

3. Die Lizenz in der wp-config.php

define( 'EASY_SVG_PRO_LICENSE_KEY', getenv( 'EASY_SVG_PRO_LICENSE_KEY' ) );
define( 'DISALLOW_FILE_MODS', true ); // Plugin-Dateien kommen nur über Composer.

Setz EASY_SVG_PRO_LICENSE_KEY auf dem Server (Hosting-Panel, .env, Deploy-Tool).

4. Installieren, aktivieren, einschalten

composer install
wp plugin activate easy-svg easy-svg-pro

Öffne danach einmal wp-admin als Administrator. Dieser Aufruf aktiviert die Lizenz und belegt einen Platz. Ein Deploy-Skript allein schafft das nicht, denn die Aktivierung läuft nur für einen angemeldeten Administrator.

Schalte die Funktionen für diese Website mit einem Befehl ein:

wp option update easy_svg_settings '{"svg_upload":true,"icons":true,"max_mb":2}' --format=json
wp option update easy_svg_pro_features '{"collections":true,"editor":true,"sources":true,"cli":true}' --format=json

Jeder Schlüssel, den du weglässt, ist aus. Willst du dieselben Schalter auf jeder Website erzwingen, nimm stattdessen Zentrale Einstellungen mit Ausnahmen je Website.

Woran du siehst, dass es geklappt hat

• composer install nennt wpackagist-plugin/easy-svg und unleashwp/easy-svg-pro.
• Icons → Lizenz zeigt "Diese Website ist aktiviert. Die Pro-Funktionen sind an."
• Icons → Funktionen zeigt deine Schalter eingeschaltet.

Stolperfallen