Pakete mit Composer installieren

Bevor Sie beginnen

• Ihr Konto benötigt Repository-Zugang: einen Tarif oder die Mitgliedschaft in einer Organisation, die einen hat. Unter Einstellungen → Konto sehen Sie, ob er aktiv ist.
• Erstellen Sie ein Composer-Token.
• Die composer.json Ihres Projekts benötigt composer/installers, damit Plugins und Themes in den richtigen Ordnern landen.

1. Token für Composer speichern

Speichern Sie das Token einmal pro Rechner in der globalen auth.json von Composer:

composer config --global http-basic.composer.meteorgpl.com token <your-token>

Der Benutzername ist immer token; das Passwort ist das Token selbst. Das Menü Installieren jedes Pakets enthält den Befehl unter Authentifizieren (1).

In der CI übergeben Sie das Token stattdessen über die Umgebungsvariable COMPOSER_AUTH (Composer in der CI).

2. Repository zum Projekt hinzufügen

Einmal pro Projekt:

composer config repositories.meteorgpl composer https://composer.meteorgpl.com

3. Paket einbinden

1. Öffnen Sie auf der Paketseite Installieren (1).
2. Der Tab Composer (2) enthält den Befehl composer require; kopieren Sie ihn und führen Sie ihn in Ihrem Projekt aus.
3. Der Tab Authentifizieren (3) enthält den Token-Befehl aus Schritt 1.
4. ZIP herunterladen (4) lädt stattdessen die neueste Version als ZIP-Datei herunter.

Der Tab composer.json liefert die Zeile, die Sie von Hand unter require eintragen, mit einer Caret-Beschränkung auf die neueste Version.

Eine vollständige composer.json

{
    "repositories": [
        { "type": "composer", "url": "https://composer.meteorgpl.com" }
    ],
    "require": {
        "composer/installers": "^2.0",
        "meteorgpl-plugin/elementor-pro": "^3.21"
    },
    "extra": {
        "installer-paths": {
            "wp-content/plugins/{$name}/": ["type:wordpress-plugin"],
            "wp-content/themes/{$name}/": ["type:wordpress-theme"]
        }
    }
}

Plugins heißen meteorgpl-plugin/<slug>, Themes meteorgpl-theme/<slug>.

In Bedrock lauten die Pfade web/app/plugins/{$name}/ und web/app/themes/{$name}/ (die eigene composer.json von Bedrock enthält sie bereits).

Versionen

Jede veröffentlichte Version bleibt verfügbar, daher sind Installationen aus composer.lock reproduzierbar. Verwenden Sie Caret-Beschränkungen (^3.21), um Minor-Updates mit composer update zu erhalten, oder binden Sie eine exakte Version ein: composer require meteorgpl-plugin/elementor-pro:3.21.2. Der Tab Versionen listet alle auf, mit dem SHA-256 jeder ZIP-Datei (Eine Paketseite lesen).

Ein Child-Theme benötigt auch sein installiertes Parent-Theme: Die Paketseite nennt das Parent-Theme und verlinkt es, wenn es im Repository ist.

ZIP-Downloads

Ohne Composer laden Sie eine Version über die Website herunter: ZIP herunterladen im Menü Installieren für die neueste oder zip neben einer beliebigen Version im Tab Versionen. Laden Sie die ZIP-Datei in WordPress unter Plugins → Add New → Upload Plugin hoch (bzw. Appearance → Themes → Add New → Upload Theme). Downloads zählen wie Composer-Downloads zu Ihrem Download-Verlauf.

Fehlerbehebung

401 Unauthorized: Das Token ist falsch, widerrufen oder abgelaufen. Prüfen Sie es unter Einstellungen → Composer-Tokens und speichern Sie es erneut.

403 Forbidden: Das Token ist gültig, aber Ihr Konto hat keinen Repository-Zugang (kein Tarif), oder das Token ist auf Netzwerke beschränkt, zu denen der Rechner, auf dem Composer läuft, nicht gehört.

Paket nicht gefunden: Prüfen Sie den Composer-Namen auf der Paketseite und ob der Repository-Eintrag in der composer.json des Projekts steht. Ein auf bestimmte Pakete beschränktes Token sieht die anderen ebenfalls nicht.

Zu viele fehlgeschlagene Authentifizierungsversuche (429): Warten Sie einige Minuten und versuchen Sie es dann mit dem richtigen Token erneut.