Erweiterungen verwalten

Sie können Ihre Adobe Commerce-Anwendungsfunktionen erweitern, indem Sie eine Erweiterung vom 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 Administrator zu lokalisieren.

NOTE
Um Installationsprobleme zu vermeiden, müssen alle Marketplace-Käufe mit demselben Konto (MAGEID) abgeschlossen werden, das Eigentümer des Cloud-Projekts ist.

Name des Komponisten einer Erweiterung

Obwohl dieser Abschnitt beschreibt, wie der Composer-Name und die Version einer Erweiterung von Commerce Marketplace abgerufen werden können, können Sie den Namen und die Version des Moduls any in der Composer-Datei des Moduls finden. Öffnen Sie die Datei composer.json in einem Texteditor und notieren Sie sich die Werte "name" und "version" .

Abrufen des Komponentennamens eines Moduls von der Commerce Marketplace:

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

  2. Klicken Sie oben rechts auf Ihren Benutzernamen und wählen Sie Mein Profil aus.

    Zugriff auf Ihr Marketplace-Konto

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

    Einkaufsverlauf für Marketplace

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

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

  6. Öffnen Sie einen Texteditor, fügen Sie den Komponentennamen ein und fügen Sie ein Doppelpunkt-Zeichen (:) hinzu.

  7. Klicken Sie in Technische Details auf Kopieren , um den 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. Beim Installieren einer Erweiterung wird der Erweiterungsname (<VendorName>_<ComponentName>) automatisch in die Datei app/etc/config.php eingefügt. Die Datei muss nicht direkt bearbeitet werden.

So installieren Sie eine Erweiterung:

  1. Wechseln Sie auf Ihrer lokalen Workstation zum Projektverzeichnis.

  2. Erstellen oder checken Sie einen Entwicklungszweig aus. Siehe Verzweigung.

  3. Fügen Sie unter Verwendung des Composer-Namens und der Version die Erweiterung zum Abschnitt "require"der Datei "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. Hinzufügen, Übertragen und Push-Code-Änderungen.

    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
    Bei der Installation einer Erweiterung müssen Sie die Datei composer.lock einbeziehen, wenn Sie Code-Änderungen an die Remote-Umgebung senden. Der Befehl composer install liest die Datei composer.lock, um die definierten Abhängigkeiten in der Remote-Umgebung zu aktivieren.
  6. Nachdem der Build und die Bereitstellung abgeschlossen sind, melden Sie sich mit einer SSH bei der Remote-Umgebung an und überprüfen Sie die installierte Erweiterung.

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

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

    Beispielantwort:

    code language-none
    Module is enabled
    

    Wenn Bereitstellungsfehler auftreten, lesen Sie Fehler bei der Bereitstellung der Erweiterung.

Erweiterungen verwalten

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

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

So aktivieren oder deaktivieren Sie eine Erweiterung:

  1. Wechseln Sie auf Ihrer lokalen Workstation zum Projektverzeichnis.

  2. Aktivieren oder deaktivieren Sie ein Modul. Der Befehl module aktualisiert die Datei config.php mit dem angeforderten Status des Moduls.

    Aktivieren Sie ein Modul.

    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. Hinzufügen, Übertragen und Push-Code-Änderungen.

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

Aktualisierung einer Erweiterung

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

Aktualisieren einer Erweiterung:

  1. Wechseln Sie auf Ihrer lokalen Workstation zum Projektverzeichnis.

  2. Erstellen oder checken Sie einen Entwicklungszweig aus. Siehe Verzweigung.

  3. Öffnen Sie die Datei "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. Fügen Sie Code-Änderungen hinzu, übertragen Sie sie und übertragen Sie sie.

    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 Wiederherstellen aus Komponentenfehler. Weitere Informationen zur Verwendung von Erweiterungen mit Adobe Commerce finden Sie unter Erweiterungen im Administratorhandbuch.

recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26