Zum Inhalt

Modul installieren

Installiere das Modul zuerst in einer Testkopie des Shops. Sichere Datenbank, Dateien und Composer-Lockdatei. Führe die Befehle als Magento-Dateisystembenutzer mit der zur Installation passenden PHP-Version aus. Berücksichtige die bestehenden Abläufe deines Hostings für Wartung, Cron und Worker.

Die folgenden Befehle werden im Magento-Hauptverzeichnis ausgeführt. Passe die Sprachcodes an die tatsächlich verwendeten Shop-Sprachen an. Aktiviere bei einer produktiven Änderung vor dem Eingriff den Wartungsmodus und deaktiviere ihn erst nach erfolgreichen Prüfungen.

Installation mit Composer

  1. Melde dich im mame-Konto des Lizenzinhabers an und öffne Downloads > TWINT for Magento 2 > Installation und Updates.
  2. Wähle die Standard-/Luma-Installation. Erstelle mit einer eigenen gültigen Modul-Lizenz einen Composer-Zugang. Speichere das einmal angezeigte Passwort in deinem Passwortmanager. Es ist von den Magento-Zahlungs-API-Zugangsdaten getrennt.
  3. Konfiguriere das Repository und installiere das Hauptpaket:
composer config repositories.mame composer https://mamedev.ch/api/composer/magento
composer require mamedev/module-twint

Composer fragt bei Bedarf nach den HTTP-Basic-Zugangsdaten. Verwende Benutzername und Passwort aus Downloads. Speichere sie in einer nicht versionierten auth.json oder im Secret Store deiner Bereitstellung. Übernimm kein Passwort in gemeinsam verwendete Befehle, Screenshots oder Git. Widerruf, Ablauf oder Lizenzübertragung können den künftigen Metadaten- und Downloadzugriff entziehen. Bereits lokal vorhandene Dateien und Composer-Caches werden nicht aus der Ferne gelöscht.

  1. Aktiviere das Modul und führe die Magento-Bereitstellung aus:
php bin/magento module:enable Mame_Twint
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f de_CH en_US
php bin/magento cache:flush
php bin/magento module:status Mame_Twint

Composer wählt eine kompatible registrierte Version und hält sie in composer.lock fest. Übernimm die Lockdatei in den üblichen Bereitstellungsablauf des Shops. Richte anschliessend die Website-Verbindung ein.

Installation per ZIP

  1. Lade das Hauptmodul als ZIP unter Downloads im Konto des Lizenzinhabers herunter. Verwende nur ein berechtigt bezogenes, geprüftes Paket.
  2. Entpacke das Archiv ausserhalb des öffentlich erreichbaren Webverzeichnisses. Kopiere den Inhalt von module-twint/ nach app/code/Mame/Twint/. Danach muss app/code/Mame/Twint/registration.php vorhanden sein; vermeide ein zusätzlich verschachteltes Verzeichnis module-twint.
  3. Führe die oben genannten Befehle zur Aktivierung und Bereitstellung aus.

Verwende pro Modul entweder Composer oder eine Kopie unter app/code. Installiere dasselbe Modul nicht an beiden Orten. Ein Wechsel der Installationsmethode gehört in einen geprüften Bereitstellungsablauf; Konfiguration und Datenbankeinträge des Moduls bleiben dabei erhalten.

Hyvä Theme

Installiere und konfiguriere zuerst das separat lizenzierte Hyvä Theme einschliesslich seiner erforderlichen GraphQL-Module. Beachte dafür die offizielle Hyvä-Installationsanleitung.

Installiere das TWINT-Kompatibilitätspaket für das Theme:

composer require mamedev/module-twint mamedev/module-twint-hyva
php bin/magento module:enable Mame_Twint Mame_TwintHyva
php bin/magento setup:upgrade
php bin/magento hyva:config:generate

Erstelle das Tailwind-CSS deines tatsächlich aktiven Child-Themes mit dessen unterstützter Node-Version und Build-Skripten neu. Für ein Theme mit build-prod:

HYVA_TAILWIND_DIR=/absoluter/pfad/zu/deinem/child-theme/web/tailwind
npm --prefix "$HYVA_TAILWIND_DIR" ci
npm --prefix "$HYVA_TAILWIND_DIR" run build-prod

Führe danach die Magento-DI-Kompilierung, die Bereitstellung der statischen Dateien und die Cache-Aktualisierung aus. Das Verzeichnis muss zum Theme der betreffenden Website gehören. Der Build eines anderen Parent-Themes aktualisiert das Child-Theme nicht.

Hyvä Checkout

Installiere und lizenziere Hyvä Checkout separat gemäss der offiziellen Checkout-Anleitung. Die geprüfte TWINT-Integration verwendet Checkout 3.0.2 und dessen Magewire-3-Abhängigkeiten.

composer require mamedev/module-twint mamedev/module-twint-hyva mamedev/module-twint-hyva-checkout
php bin/magento module:enable Mame_Twint Mame_TwintHyva Mame_TwintHyvaCheckout
php bin/magento setup:upgrade
php bin/magento hyva:config:generate

Erstelle das Tailwind-CSS des aktiven Themes neu und führe danach DI-Kompilierung, Bereitstellung der statischen Dateien und Cache-Aktualisierung aus. Das Checkout-Kompatibilitätspaket benötigt auch das Theme-Kompatibilitätspaket. Aktiviere Hyvä Checkout für die vorgesehene Website beziehungsweise den Store View über dessen normale Konfiguration.

Bei einer ZIP-Installation gehört der Inhalt des Theme-Archivs nach app/code/Mame/TwintHyva/ und der Inhalt des Checkout-Archivs nach app/code/Mame/TwintHyvaCheckout/. Stelle die lizenzierten Hyvä-Abhängigkeiten separat bereit. Aktiviere ein Kompatibilitätsmodul erst, wenn die erforderlichen Hyvä-Komponenten vorhanden sind.

Prüfe die Kompatibilitätstabelle und teste vor dem Produktiveinsatz den normalen Checkout sowie alle aktivierten Express-Positionen.