Installation
Voraussetzungen
Magento 2.4.x — getestet auf 2.4.9, kompatibel mit früheren 2.4.*-Versionen. PHP 8.1–8.5. Der Magento-Cron muss laufen (der Wechsel erfolgt täglich). Kompatibel sowohl mit dem Standard-Theme Luma als auch mit dem Hyva-Theme. Benötigt das kostenlose Modul codingrow/module-core, das automatisch installiert wird.
Einrichtungsschritte
- Fügen Sie die per E-Mail erhaltenen Zugangsdaten in die Datei
auth.jsonim Stammverzeichnis Ihres Magento-Projekts ein:{ "http-basic": { "repo.codingrow.com": { "username": "...", "password": "..." } } } composer config repositories.codingrow composer https://repo.codingrow.comcomposer require codingrow/module-auto-switch-homebin/magento module:enable Codingrow_AutoSwitchHomebin/magento setup:upgrade && bin/magento setup:di:compile- Fügen Sie Ihren Lizenzschlüssel unter Admin → Stores → Configuration → Codingrow Extensions → Auto Switch Home → License → License Key ein, speichern Sie, dann
bin/magento cache:flush.
Konfiguration
Öffnen Sie Admin → Stores → Configuration → Codingrow Extensions → Auto Switch Home. Geben Sie Ihren License Key ein, setzen Sie Enable automatic home switching auf Ja und erstellen Sie den Switch calendar.
| Einstellung | Funktion | Standard | Hinweise |
|---|---|---|---|
| License Key | Der für diese Domain ausgestellte Lizenzschlüssel. | — | Akzeptiert einen Einzelmodul-Schlüssel oder einen Codingrow-Abo-Schlüssel. Nach dem Einfügen den Cache leeren. |
| Enable automatic home switching | Aktiviert den täglichen automatischen Wechsel. | Nein | Bei der ersten Aktivierung wird die aktuelle Startseite gespeichert; beim Deaktivieren wird sie wiederhergestellt. |
| Switch calendar | Die Liste der Regeln. Jede Zeile ist ein wiederkehrender Tag + Monat und die ab diesem Datum anzuzeigende CMS-Seite. | — | Fügen Sie beliebig viele Zeilen hinzu. Das Menü listet Ihre Magento-CMS-Seiten auf. |
Deinstallation
Setzen Sie Enable automatic home switching auf Nein und speichern Sie — Ihre ursprüngliche Startseite wird automatisch wiederhergestellt. Um das Modul vollständig zu entfernen: bin/magento module:disable Codingrow_AutoSwitchHome, dann composer remove codingrow/module-auto-switch-home.
Benutzerhandbuch
Der Wechselkalender
Jede Regel ist ein wiederkehrender Tag + Monat (ohne Jahr), der einer Ihrer CMS-Seiten zugeordnet ist. Sie definieren den Kalender einmal, und er wiederholt sich jedes Jahr. Fügen Sie pro Übergang eine Zeile hinzu — ohne Begrenzung.
Welche Seite ist heute aktiv
Die aktive Regel ist diejenige, deren Tag/Monat zuletzt bereits vergangen ist. Mit 5. Dezember → Weihnachten und 26. Dezember → Winter ist die Startseite vom 5. bis 25. Dezember Weihnachten und ab dem 26. Dezember Winter. Der Jahreswechsel wird korrekt behandelt: Anfang Januar bleibt die letzte Dezember-Regel aktiv, bis die erste Regel des neuen Jahres erreicht ist. Zeilen mit unmöglichen Daten (z. B. 31. Februar) werden ignoriert.
Tägliche Aufgabe und sofortige Anwendung
Eine tägliche Cron-Aufgabe (codingrow_autoswitchhome_apply, Standard 00:10, in einer eigenen Cron-Gruppe) setzt die Startseite auf die aktive Regel. Der Wechsel wird auch sofort beim Speichern der Konfiguration angewendet, sodass Sie nicht auf den Cron warten müssen.
Wiederherstellung und Cache
Nicht destruktiv: Das Modul speichert Ihre ursprüngliche Startseite bei der ersten Aktivierung und stellt sie beim Deaktivieren automatisch wieder her. Cache: Es aktualisiert den Config- und Full-Page-Cache nur an den Tagen, an denen sich die Startseite tatsächlich ändert — ein paar Mal im Jahr. Ein Reindex ist nie erforderlich: Zu ändern, welche CMS-Seite die Startseite ist, ist eine Konfigurationsänderung, keine Katalogindex-Änderung.
Hyva- und Luma-Unterstützung
Das Modul ist Theme-unabhängig. Es ändert nur, welche CMS-Seite die Startseite ist, und funktioniert daher auf dem Hyva-Theme und dem Standard-Theme Luma identisch, ohne Template-Änderungen.
Lizenz
Die Lizenz wird für eine Domain ausgestellt und kann ein Einzelmodul-Schlüssel (Auto Switch Home) oder ein Codingrow-Abo-Schlüssel (alle Module) sein. Ohne gültige Lizenz tut das Modul nichts. Ihre Lizenz umfasst die aktuelle Version plus 1 Jahr Updates und Support; die abgedeckten Versionen können Sie für immer weiter nutzen und den Support (−35%) verlängern, um auf neuere Versionen zu aktualisieren.