DokumentationCommerceHandbuch zu Commerce für Cloud

Erweiterungen verwalten

Last update: Fri Jan 31 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

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:

    code language-text 
    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.

    code language-bash 
    composer require <extension-name>:<version> --no-update

  4. Aktualisieren Sie die Projektabhängigkeiten.

    code language-bash 
    composer update

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

    code language-bash 
    git add -A
    code language-bash 
    git commit -m "Install <extension-name>"
    code language-bash 
    git push origin <branch-name>
    note warning
    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.

    code language-bash 
    bin/magento module:status <extension-name>

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

    Beispielantwort:

    code language-none 
    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.

    code language-bash 
    bin/magento module:enable <module-name>

    Deaktivieren Sie ein Modul.

    code language-bash 
    bin/magento module:disable <module-name>

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

    code language-bash 
    ./vendor/bin/ece-tools module:refresh

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

    code language-bash 
    bin/magento module:status <module-name>

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

    code language-bash 
    git add -A
    code language-bash 
    git commit -m "Disable <extension-name>"
    code language-bash 
    git push origin <branch-names>

Aktualisieren einer Erweiterung

Bevor Sie fortfahren, benötigen Sie den Namen des Komponisten und die Version für die Erweiterung. Überprüfen Sie außerdem, ob die Erweiterung mit Ihrem Projekt und der Adobe Commerce-Version kompatibel ist. Überprüfen Sie die erforderliche PHP-Version,Sie beginnen.

Aktualisieren einer Erweiterung:

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

  2. Erstellen oder Auschecken einer Entwicklungsverzweigung. Siehe Verzweigung.

  3. Öffnen Sie die composer.json in einem Texteditor.

  4. Suchen Sie Ihre Erweiterung und aktualisieren Sie die Version.

  5. Speichern Sie Ihre Änderungen und beenden Sie den Texteditor.

  6. Aktualisieren Sie die Projektabhängigkeiten.

    code language-bash 
    composer update

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

    code language-bash 
    git add -A
    code language-bash 
    git commit -m "Update <extension-name>"
    code language-bash 
    git push origin <branch-names>

Wenn Fehler auftreten, lesen Sie Nach Komponentenfehler wiederherstellen. Weitere Informationen zur Verwendung von Erweiterungen mit Adobe Commerce finden Sie unter Erweiterungen im Admin-Handbuch.

recommendation-more-help
7c2b03ac-000c-497d-aba3-2c6dc720a938