Erweiterungen verwalten
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.
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:
-
Melden Sie sich bei Commerce Marketplace mit dem Benutzernamen und Kennwort an, mit dem Sie die Komponente erworben haben.
-
Klicken Sie in der oberen rechten Ecke auf Ihren Benutzernamen und wählen Sie Mein Profil.
-
Klicken Sie auf der Mein Konto-Seite auf Meine Käufe.
-
Wählen Sie auf der Meine" ein von Ihnen erworbenes Modul aus und klicken Sie auf Technische Details.
-
Klicken Sie Kopieren, um die Component name in die Zwischenablage zu kopieren.
-
Öffnen Sie einen Texteditor und fügen Sie den Komponentennamen ein und fügen Sie einen Doppelpunkt (
:
) an. -
Klicken Sie Technische Details auf Kopieren, um die Component version in die Zwischenablage zu kopieren.
-
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:
-
Wechseln Sie auf Ihrer lokalen Workstation in Ihr Projektverzeichnis.
-
Erstellen oder Auschecken einer Entwicklungsverzweigung. Siehe Verzweigung.
-
Fügen Sie unter Verwendung des Namens und der Version des Composers die Erweiterung zum Abschnitt
require
dercomposer.json
hinzu.code language-bash composer require <extension-name>:<version> --no-update
-
Aktualisieren Sie die Projektabhängigkeiten.
code language-bash composer update
-
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 Befehlcomposer install
liest diecomposer.lock
, um die definierten Abhängigkeiten in der Remote-Umgebung zu aktivieren. -
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:
-
Wechseln Sie auf Ihrer lokalen Workstation in Ihr Projektverzeichnis.
-
Aktivieren oder Deaktivieren eines Moduls. Der Befehl
module
aktualisiert dieconfig.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>
-
Wenn Sie ein Modul aktiviert haben, verwenden Sie
ece-tools
, um die Konfiguration zu aktualisieren.code language-bash ./vendor/bin/ece-tools module:refresh
-
Überprüfen Sie den Status eines Moduls.
code language-bash bin/magento module:status <module-name>
-
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:
-
Wechseln Sie auf Ihrer lokalen Workstation in Ihr Projektverzeichnis.
-
Erstellen oder Auschecken einer Entwicklungsverzweigung. Siehe Verzweigung.
-
Öffnen Sie die
composer.json
in einem Texteditor. -
Suchen Sie Ihre Erweiterung und aktualisieren Sie die Version.
-
Speichern Sie Ihre Änderungen und beenden Sie den Texteditor.
-
Aktualisieren Sie die Projektabhängigkeiten.
code language-bash composer update
-
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.