Erweiterungen verwalten

Letzte Aktualisierung: 31. Januar 2025

Erstellt für:

  • Admin
  • Entwickler

Sie können die Funktionen Ihrer Adobe Commerce-Anwendung erweitern, indem Sie eine Erweiterung von der Commerce Marketplace hinzufügen. Sie können beispielsweise ein Design hinzufügen, um das Erscheinungsbild Ihrer Storefront zu ändern, oder Sie können ein Sprachpaket hinzufügen, um Ihre Storefront und Ihren Admin zu lokalisieren.

NOTE
Um Installationsprobleme zu vermeiden, müssen alle Käufe auf dem Marketplace mit demselben Konto (MAGEID) abgeschlossen werden, dem das Cloud-Projekt gehört.

Composer-Name einer Erweiterung

Obwohl in diesem Abschnitt erläutert wird, wie Sie den Namen und die Version einer Erweiterung von Commerce Marketplace abrufen können, finden Sie den Namen und die Version any-Moduls in der Composer-Datei des Moduls. Öffnen Sie die composer.json in einem Texteditor und notieren Sie sich die "name" und "version" Werte.

Den Composer-Namen eines Moduls von der Commerce Marketplace abrufen:

  1. Melden Sie sich bei Commerce Marketplace mit dem Benutzernamen und Kennwort an, mit dem Sie die Komponente erworben haben.

  2. Klicken Sie in der oberen rechten Ecke auf Ihren Benutzernamen und wählen Sie Mein Profil.

    Zugriff auf Ihr Marketplace-Konto

  3. Klicken Sie auf der Mein Konto-Seite auf Meine Käufe.

    Marketplace-Kaufverlauf

  4. Wählen Sie auf der Meine" ein von Ihnen erworbenes Modul aus und klicken Sie auf Technische Details.

  5. Klicken Sie Kopieren, um die Component name in die Zwischenablage zu kopieren.

  6. Öffnen Sie einen Texteditor und fügen Sie den Komponentennamen ein und fügen Sie einen Doppelpunkt (:) an.

  7. Klicken Sie Technische Details auf Kopieren, um die Component version in die Zwischenablage zu kopieren.

  8. Hängen Sie im Texteditor die Versionsnummer an den Komponentennamen nach dem Doppelpunkt an. Beispiel:

    extension-name/magento2:1.0.1

Installieren einer Erweiterung

Adobe empfiehlt, in einer Entwicklungsverzweigung zu arbeiten, wenn Sie Ihrer Implementierung eine Erweiterung hinzufügen. Bei der Installation einer Erweiterung wird der Name der Erweiterung (<VendorName>_<ComponentName>) automatisch in die app/etc/config.php-Datei eingefügt. Es ist nicht erforderlich, die Datei direkt zu bearbeiten.

So installieren Sie eine:

  1. Wechseln Sie auf Ihrer lokalen Workstation in Ihr Projektverzeichnis.

  2. Erstellen oder Auschecken einer Entwicklungsverzweigung. Siehe Verzweigung.

  3. Fügen Sie unter Verwendung des Namens und der Version des Composers die Erweiterung zum Abschnitt require der composer.json hinzu.

    composer require <extension-name>:<version> --no-update

  4. Aktualisieren Sie die Projektabhängigkeiten.

    composer update

  5. Code-Änderungen hinzufügen, übertragen und per Push übertragen.

    git add -A

    git commit -m "Install <extension-name>"

    git push origin <branch-name>
    WARNING
    Wenn Sie eine Erweiterung installieren, müssen Sie die composer.lock-Datei einbeziehen, wenn Sie Code-Änderungen in die Remote-Umgebung pushen. Der Befehl composer install liest die composer.lock, um die definierten Abhängigkeiten in der Remote-Umgebung zu aktivieren.

  6. Nachdem der Build und die Bereitstellung abgeschlossen sind, verwenden Sie ein SSH, um sich bei der Remote-Umgebung anzumelden und die installierte Erweiterung zu überprüfen.

    bin/magento module:status <extension-name>

    Ein Erweiterungsname verwendet das Format <VendorName>_<ComponentName>.

    Beispielantwort:

    Module is enabled

    Wenn Bereitstellungsfehler auftreten, finden Sie weitere Informationen unter Fehler bei der Erweiterungsbereitstellung.

Erweiterungen verwalten

Wenn Sie eine Erweiterung mithilfe von Composer hinzufügen, wird die Erweiterung automatisch vom Bereitstellungsprozess aktiviert. Wenn Sie die Erweiterung bereits installiert haben, können Sie sie über die CLI aktivieren oder deaktivieren. Verwenden Sie beim Verwalten von Erweiterungen das Format <VendorName>_<ComponentName>

Aktivieren oder deaktivieren Sie niemals eine Erweiterung, während Sie bei den Remote-Umgebungen angemeldet sind.

Aktivieren oder Deaktivieren einer Erweiterung:

  1. Wechseln Sie auf Ihrer lokalen Workstation in Ihr Projektverzeichnis.

  2. Aktivieren oder Deaktivieren eines Moduls. Der Befehl module aktualisiert die config.php mit dem angeforderten Status des Moduls.

    Aktivieren eines Moduls.

    bin/magento module:enable <module-name>

    Deaktivieren Sie ein Modul.

    bin/magento module:disable <module-name>

  3. Wenn Sie ein Modul aktiviert haben, verwenden Sie ece-tools , um die Konfiguration zu aktualisieren.

    ./vendor/bin/ece-tools module:refresh

  4. Überprüfen Sie den Status eines Moduls.

    bin/magento module:status <module-name>

  5. Code-Änderungen hinzufügen, übertragen und per Push übertragen.

    git add -A

    git commit -m "Disable <extension-name>"

    git push origin <branch-names>