Mit Git und CI ausliefern
Halt deinen UnleashWP-Lizenzschlüssel aus Git heraus: als Umgebungsvariable setzen, in der wp-config.php lesen, jede Website aktiviert sich selbst.
Lieferst du WordPress aus einem Git-Repository aus, von Hand, über eine CI-Pipeline oder mit Composer, musst du nicht jede Website öffnen und einen Lizenzschlüssel einfügen. Leg den Schlüssel als Umgebungsvariable auf den Server, lies ihn in der wp-config.php, und jede Website aktiviert sich selbst.
So funktioniert es
Der Schlüssel liegt auf dem Server
Du setzt eine Umgebungsvariable wie EASY_SVG_PRO_LICENSE_KEY im Hosting-Panel, in deiner .env oder in deinem Deployment-Tool. Im Repository steht sie nie.
Die wp-config.php liest sie
Eine Zeile in der wp-config.php macht aus der Variable die Konstante, nach der das Plugin sucht. Diese Zeile darfst du committen, sie enthält keinen Schlüssel.
Die Website aktiviert sich selbst
Sobald ein Administrator das nächste Mal wp-admin öffnet, schickt das Plugin den Schlüssel einmal los und aktiviert die Website. Danach behält die Website ein eigenes Token, der Schlüssel wird nicht in der Datenbank gespeichert.
Die Zeile für die wp-config.php
define( 'EASY_SVG_PRO_LICENSE_KEY', getenv( 'EASY_SVG_PRO_LICENSE_KEY' ) );
Die Konstante ist der Slug des Produkts in Großbuchstaben, Bindestriche werden zu Unterstrichen, dahinter _LICENSE_KEY. Für Easy SVG Pro (easy-svg-pro) ist das EASY_SVG_PRO_LICENSE_KEY. Der Composer-Dialog in deinem Konto unter Downloads zeigt dir die genaue Zeile für jedes Produkt.
Die Variable setzen
Die meisten Managed-Hoster haben in den Website-Einstellungen einen Platz für Umgebungsvariablen. Leg EASY_SVG_PRO_LICENSE_KEY mit deinem Schlüssel als Wert an und behalt die getenv()-Zeile in der wp-config.php.
Bedrock liest die .env, die Git schon ignoriert. Trag den Schlüssel dort ein:
EASY_SVG_PRO_LICENSE_KEY='DEIN_LIZENZSCHLUESSEL'
und definier die Konstante in config/application.php:
Config::define( 'EASY_SVG_PRO_LICENSE_KEY', env( 'EASY_SVG_PRO_LICENSE_KEY' ) );
Leg den Schlüssel als Secret in deinem CI-System ab und schreib ihn beim Deployment in die Umgebung oder die .env des Servers. Gib ihn nie im Build-Log aus.
wp-config.php. Jeder, der das Repository lesen kann, könnte sonst deine Lizenz nutzen.Gut zu wissen
- Wer aktiviert. Nur ein angemeldeter Administrator löst die Aktivierung aus, in einem Multisite-Netzwerk ein Super-Admin. Besucher nie, der erste Seitenaufruf nach einem Deployment wird also nicht langsamer.
- Scheitert die Aktivierung, versucht die Website es später von selbst wieder. Den Grund siehst du auf dem Lizenz-Bildschirm des Produkts, bei Easy SVG Pro unter Icons → Lizenz.
- Ein Schlüssel für ein anderes Produkt wird gar nicht erneut versucht. Setz den richtigen Schlüssel in die Variable, dann versucht es die Website wieder.
- Multisite belegt für das ganze Netzwerk einen Platz. Aktivier das Produkt netzwerkweit.
- Staging und Kopien. Testseiten und Kopien werden in deinem Konto unter Websites gekennzeichnet, siehe Lizenzen und Websites.
- Schlüssel später wechseln. Eine schon aktivierte Website behält ihr Token, ein neuer Wert in der Variable ändert also allein nichts. Trenn die Website unter Websites in deinem Konto oder auf dem Lizenz-Bildschirm und öffne dann wp-admin erneut.
Mit Composer
Composer kann das Plugin selbst von composer.unleash-wp.com installieren, mit demselben Lizenzschlüssel. Die ganze Einrichtung, auch COMPOSER_AUTH für CI, steht unter Mit Composer installieren.