DokumentationCommerceInstallationsanleitung

Verwalten von Erweiterungen von Drittanbietern

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Experte
  • Admin
  • Entwickler

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)
TIP
In diesem Thema wird erläutert, wie Sie mit der Befehlszeilenschnittstelle Drittanbietererweiterungen verwalten können, die Sie über die Commerce Marketplace erwerben. 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:

  1. Sichern Sie Ihre Datenbank.

  2. Wartungsmodus aktivieren:

    code language-bash 
    bin/magento maintenance:enable

Um eine Erweiterung zu installieren, müssen Sie:

  1. Rufen Sie eine Erweiterung von der Commerce Marketplace oder einem anderen Erweiterungsentwickler ab.

  2. Wenn Sie eine Erweiterung aus dem Commerce Marketplace installieren, stellen Sie sicher, dass das repo.magento.com-Repository in Ihrer composer.json-Datei vorhanden ist:

    code language-bash 
    "repositories": [
    {
        "type": "composer",
        "url": "https://repo.magento.com/"
    }
]

  3. Rufen Sie den Namen und die Version des Composers der Erweiterung ab.

  4. Aktualisieren Sie die Datei composer.json in Ihrem Projekt mit dem Namen und der Version der Erweiterung.

  5. Überprüfen Sie, ob die Erweiterung ordnungsgemäß installiert ist.

  6. 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:

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

  2. Klicken Sie oben rechts auf Ihr Name > Mein Profil.

    Zugriff auf Ihr Marketplace-Konto

  3. Klicken Sie auf Meine Einkäufe.

    Einkaufsverlauf für Marketplace

  4. Suchen Sie die Erweiterung, die Sie installieren möchten, und klicken Sie auf Technische Details.

    Technische Details zeigen den Namen des Komponisten der Erweiterung an

TIP
Alternativ können Sie den Namen des Komponisten und die Version der Erweiterung any (unabhängig davon, ob Sie sie auf der Commerce Marketplace oder an einer anderen Stelle erworben haben) in der Datei 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:

  1. 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

  2. Geben Sie Ihre Authentifizierungsschlüssel ein. Ihr öffentlicher Schlüssel ist Ihr Benutzername, Ihr privater Schlüssel ist Ihr Passwort.

  3. Warten Sie, bis der Composer die Aktualisierung Ihrer Projektabhängigkeiten abgeschlossen hat, und stellen Sie sicher, dass keine Fehler vorliegen:

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

  1. 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-terminal 
    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.

  2. Registrieren Sie die Erweiterung:

    code language-bash 
    bin/magento setup:upgrade

  3. 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

  4. 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-terminal 
    Module is enabled

  5. Cache leeren:

    code language-bash 
    bin/magento cache:clean

  6. Konfigurieren Sie die Erweiterung in Admin nach Bedarf.

TIP
Wenn beim Laden der Storefront in einen Browser Fehler auftreten, verwenden Sie den folgenden Befehl, um den Cache zu löschen: bin/magento cache:flush.

Upgrade

So aktualisieren oder aktualisieren Sie ein Modul oder eine Erweiterung:

  1. Laden Sie die aktualisierte Datei von Marketplace oder einem anderen Erweiterungsentwickler herunter. Notieren Sie sich den Modulnamen und die Version.

  2. Exportieren Sie die Inhalte in den Stammordner der Anwendung.

  3. 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

  4. 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?
CAUTION
Führen Sie die Deinstallationsschritte für eine Nicht-Produktionsumgebung first aus und testen Sie sie gründlich, bevor Sie sie in Ihre Produktionsumgebung übernehmen.

Die folgenden Anweisungen enthalten allgemeine Informationen zum Deinstallieren von Drittanbietererweiterungen:

  1. 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 <package-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>/<module-name>

  2. Wenn die Datei "config.php" in Ihrem Adobe Commerce-Projekt-Repository unter Quellcodeverwaltung steht, entfernen Sie die Erweiterung aus der Datei "config.php".

  3. Testen Sie Ihre lokale Datenbank, um sicherzustellen, dass die vom Anbieter bereitgestellten Anweisungen erwartungsgemäß funktionieren.

  4. Vergewissern Sie sich, dass die Erweiterung ordnungsgemäß deaktiviert ist und dass Ihre Website in Ihrer Staging-Umgebung erwartungsgemäß funktioniert.

  5. Stellen Sie die Änderungen in Ihrer Produktionsumgebung bereit.

recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995