Verwalten von Erweiterungen von Drittanbietern
Code, der das Adobe Commerce-Verhalten erweitert oder anpasst, wird als Erweiterung bezeichnet. Optional können Sie Erweiterungen auf dem Commerce Marketplace oder einem anderen Erweiterungsverteilungssystem verpacken und verteilen.
Zu den Erweiterungen gehören:
- Module (Adobe Commerce-Funktionen erweitern)
- Designs (ändern Sie das Erscheinungsbild Ihrer Storefront und Ihres Administrators)
- Sprachpakete (Storefront und Admin lokalisieren)
In diesem Thema wird erläutert, wie Sie mit der Befehlszeilenschnittstelle Drittanbietererweiterungen verwalten können, die Sie über die Commerce Marketplace für lokale -Projekte erwerben. Informationen zu Cloud-Infrastrukturprojekten finden Sie unter Verwalten von Erweiterungen.
Sie können dasselbe Verfahren verwenden, um die Erweiterung any zu installieren. Sie benötigen lediglich den Namen und die Version des Komponentenprogramms der Erweiterung. Um sie zu finden, öffnen Sie die Datei composer.json
der Erweiterung und notieren Sie die Werte für "name"
und "version"
.
Installieren
Vor der Installation sollten Sie Folgendes tun:
-
Sichern Sie Ihre Datenbank.
-
Wartungsmodus aktivieren:
code language-bash bin/magento maintenance:enable
Um eine Erweiterung zu installieren, müssen Sie:
-
Rufen Sie eine Erweiterung von der Commerce Marketplace oder einem anderen Erweiterungsentwickler ab.
-
Wenn Sie eine Erweiterung aus dem Commerce Marketplace installieren, stellen Sie sicher, dass das
repo.magento.com
-Repository in Ihrercomposer.json
-Datei vorhanden ist:code language-bash "repositories": [ { "type": "composer", "url": "https://repo.magento.com/" } ]
-
Rufen Sie den Namen und die Version des Composers der Erweiterung ab.
-
Aktualisieren Sie die Datei
composer.json
in Ihrem Projekt mit dem Namen und der Version der Erweiterung. -
Überprüfen Sie, ob die Erweiterung ordnungsgemäß installiert ist.
-
Aktivieren und konfigurieren Sie die Erweiterung.
Abrufen von Erweiterungsinformationen
Wenn Sie den Namen und die Version des Komponentenprogramms der Erweiterung bereits kennen, überspringen Sie diesen Schritt und fahren Sie mit Aktualisieren der composer.json
-Datei fort.
So rufen Sie den Composer-Namen und die Version der Erweiterung von der Commerce Marketplace ab:
-
Melden Sie sich bei Commerce Marketplace mit dem Benutzernamen und dem Kennwort an, mit dem Sie die Erweiterung gekauft haben.
-
Klicken Sie oben rechts auf Ihr Name > Mein Profil.
-
Klicken Sie auf Meine Einkäufe.
-
Suchen Sie die Erweiterung, die Sie installieren möchten, und notieren Sie sich den Komponentennamen und die Version.
composer.json
der Erweiterung finden.Aktualisieren von Composer-Abhängigkeiten
Fügen Sie den Namen und die Version der Erweiterung Ihrer composer.json
-Datei hinzu:
-
Navigieren Sie zu Ihrem Projektverzeichnis und aktualisieren Sie Ihre
composer.json
-Datei.code language-bash composer require <component-name>:<version>
Beispiel:
code language-bash composer require j2t/module-payplug:2.0.2
-
Geben Sie Ihre Authentifizierungsschlüssel ein. Ihr öffentlicher Schlüssel ist Ihr Benutzername, Ihr privater Schlüssel ist Ihr Passwort.
-
Warten Sie, bis der Composer die Aktualisierung Ihrer Projektabhängigkeiten abgeschlossen hat, und stellen Sie sicher, dass keine Fehler vorliegen:
code language-none Updating dependencies (including require-dev) Package operations: 1 install, 0 updates, 0 removals - Installing j2t/module-payplug (2.0.2): Downloading (100%) Writing lock file Generating autoload files
Installation überprüfen
Um zu überprüfen, ob die Erweiterung ordnungsgemäß installiert wurde, führen Sie den folgenden Befehl aus:
bin/magento module:status J2t_Payplug
Standardmäßig ist die Erweiterung wahrscheinlich deaktiviert:
Module is disabled
Der Name der Erweiterung hat das Format <VendorName>_<ComponentName>
. Dieses Format unterscheidet sich vom Namen des Composers. Verwenden Sie dieses Format, um die Erweiterung zu aktivieren. Wenn Sie sich nicht sicher sind, welchen Namen die Erweiterung hat, führen Sie Folgendes aus:
bin/magento module:status
Suchen Sie nach der Erweiterung unter "Liste der deaktivierten Module".
Aktivieren
Einige Erweiterungen funktionieren nur dann ordnungsgemäß, wenn Sie zuvor generierte statische Ansichtsdateien löschen. Verwenden Sie die Option "--clear-static-content
", um statische Ansichtsdateien zu löschen, wenn Sie eine Erweiterung aktivieren.
-
Aktivieren Sie die Erweiterung und löschen Sie statische Ansichtsdateien:
code language-bash bin/magento module:enable J2t_Payplug --clear-static-content
Die folgende Ausgabe sollte angezeigt werden:
code language-none The following modules have been enabled: - J2t_Payplug To make sure that the enabled modules are properly registered, run 'setup:upgrade'. Cache cleared successfully. Generated classes cleared successfully. Please run the 'setup:di:compile' command to generate classes. Generated static view files cleared successfully.
-
Registrieren Sie die Erweiterung:
code language-bash bin/magento setup:upgrade
-
Kompilieren Sie Ihr Projekt neu: Im Produktionsmodus erhalten Sie möglicherweise eine Meldung mit der Meldung "Magento-Kompilierungsbefehl erneut ausführen". Die Anwendung fordert Sie nicht auf, den Befehl "Kompilieren"im Entwicklermodus auszuführen.
code language-bash bin/magento setup:di:compile
-
Stellen Sie sicher, dass die Erweiterung aktiviert ist:
code language-bash bin/magento module:status J2t_Payplug
Es sollte eine Ausgabe angezeigt werden, die überprüft, ob die Erweiterung nicht mehr deaktiviert ist:
code language-none Module is enabled
-
Cache leeren:
code language-bash bin/magento cache:clean
-
Konfigurieren Sie die Erweiterung in Admin nach Bedarf.
bin/magento cache:flush
.Upgrade
So aktualisieren oder aktualisieren Sie ein Modul oder eine Erweiterung:
-
Laden Sie die aktualisierte Datei von Marketplace oder einem anderen Erweiterungsentwickler herunter. Notieren Sie sich den Modulnamen und die Version.
-
Exportieren Sie die Inhalte in den Stammordner der Anwendung.
-
Wenn für das Modul ein Composer-Paket vorhanden ist, führen Sie einen der folgenden Schritte aus.
Aktualisierung nach Modulname:
code language-bash composer update vendor/module-name
Aktualisierung pro Version:
code language-bash composer require vendor/module-name ^x.x.x
-
Führen Sie die folgenden Befehle aus, um den Cache zu aktualisieren, bereitzustellen und zu leeren.
code language-bash bin/magento setup:upgrade --keep-generated
code language-bash bin/magento setup:static-content:deploy
code language-bash bin/magento cache:clean
Deinstallieren
Wenden Sie sich an den Erweiterungsanbieter, um Anweisungen zum Entfernen einer Drittanbietererweiterung zu erhalten. Die Anweisungen sollten die folgenden Informationen enthalten:
- Wiederherstellen von Datenbanktabellenänderungen
- Wiederherstellen von Datenbankdatenänderungen
- Welche Dateien sollten entfernt oder zurückgesetzt werden?
Die folgenden Anweisungen enthalten allgemeine Informationen zum Deinstallieren von Drittanbietererweiterungen:
-
Entfernen Sie die Erweiterung aus Ihrem Adobe Commerce-Projekt-Repository.
-
Entfernen Sie bei Composer-basierten Erweiterungen die Erweiterung aus Ihrer Adobe Commerce
composer.json
-Datei.code language-bash composer remove <component-name>
-
Entfernen Sie bei Nicht-Composer-basierten Erweiterungen die physischen Dateien aus Ihrem Adobe Commerce-Projekt-Repository.
code language-bash rm -rf app/code/<vendor-name>/<component-name>
-
-
Wenn die Datei "
config.php
" in Ihrem Adobe Commerce-Projekt-Repository unter Quellcodeverwaltung steht, entfernen Sie die Erweiterung aus der Datei "config.php
". -
Testen Sie Ihre lokale Datenbank, um sicherzustellen, dass die vom Anbieter bereitgestellten Anweisungen erwartungsgemäß funktionieren.
-
Vergewissern Sie sich, dass die Erweiterung ordnungsgemäß deaktiviert ist und dass Ihre Website in Ihrer Staging-Umgebung erwartungsgemäß funktioniert.
-
Stellen Sie die Änderungen in Ihrer Produktionsumgebung bereit.