Auto Switch Home Dokumentation

Installationsschritte und eine vollständige Referenz für jede Einstellung, mit konkreten Beispielen — dieselbe Detailtiefe, die unser Support nutzt.

Als Markdown anzeigen

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

  1. Fügen Sie die per E-Mail erhaltenen Zugangsdaten in die Datei auth.json im Stammverzeichnis Ihres Magento-Projekts ein:
    { "http-basic": { "repo.codingrow.com": { "username": "...", "password": "..." } } }
  2. composer config repositories.codingrow composer https://repo.codingrow.com
  3. composer require codingrow/module-auto-switch-home
  4. bin/magento module:enable Codingrow_AutoSwitchHome
  5. bin/magento setup:upgrade && bin/magento setup:di:compile
  6. 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.

EinstellungFunktionStandardHinweise
License KeyDer 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 switchingAktiviert den täglichen automatischen Wechsel.NeinBei der ersten Aktivierung wird die aktuelle Startseite gespeichert; beim Deaktivieren wird sie wiederhergestellt.
Switch calendarDie 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.

Beispiel (saisonal): 21. März → Frühling, 21. Juni → Sommer, 21. September → Herbst, 5. Dezember → Weihnachten, 26. Dezember → Winter.

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.

Erfordert den Magento-Cron. Läuft der Cron des Shops nicht, findet der tägliche Wechsel nicht statt (der Wechsel beim Speichern wird dennoch sofort angewendet).

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.