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.
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:
-
Melden Sie sich bei Commerce Marketplace mit dem Benutzernamen und dem Kennwort an, mit dem Sie die Komponente gekauft haben.
-
Klicken Sie oben rechts auf Ihren Benutzernamen und wählen Sie Mein Profil aus.
-
Klicken Sie auf der Seite Mein Konto auf Meine Käufe.
-
Wählen Sie auf der Seite Meine Einkäufe ein von Ihnen erworbenes Modul aus und klicken Sie auf Technische Details.
-
Klicken Sie auf Kopieren , um die Component name in die Zwischenablage zu kopieren.
-
Öffnen Sie einen Texteditor, fügen Sie den Komponentennamen ein und fügen Sie ein Doppelpunkt-Zeichen (
:
) hinzu. -
Klicken Sie in Technische Details auf Kopieren , um den 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. 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:
-
Wechseln Sie auf Ihrer lokalen Workstation zum Projektverzeichnis.
-
Erstellen oder checken Sie einen Entwicklungszweig aus. Siehe Verzweigung.
-
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
-
Aktualisieren Sie die Projektabhängigkeiten.
code language-bash composer update
-
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 Befehlcomposer install
liest die Dateicomposer.lock
, um die definierten Abhängigkeiten in der Remote-Umgebung zu aktivieren. -
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:
-
Wechseln Sie auf Ihrer lokalen Workstation zum Projektverzeichnis.
-
Aktivieren oder deaktivieren Sie ein Modul. Der Befehl
module
aktualisiert die Dateiconfig.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>
-
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>
-
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:
-
Wechseln Sie auf Ihrer lokalen Workstation zum Projektverzeichnis.
-
Erstellen oder checken Sie einen Entwicklungszweig aus. Siehe Verzweigung.
-
Öffnen Sie die Datei "
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
-
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.