Auto Switch Home-documentatie

Installatiestappen en een volledige referentie voor elke instelling, met concrete voorbeelden — hetzelfde detailniveau dat onze support gebruikt.

Weergeven als Markdown

Installatie

Vereisten

Magento 2.4.x — getest op 2.4.9, compatibel met eerdere 2.4.*-versies. PHP 8.1–8.5. De Magento-cron moet draaien (de wissel gebeurt dagelijks). Compatibel met zowel het standaard Luma-thema als het Hyva-thema. Vereist de gratis module codingrow/module-core, die automatisch wordt geïnstalleerd.

Installatiestappen

  1. Voeg de inloggegevens die je per e-mail ontvangt toe aan auth.json in de hoofdmap van je Magento-project:
    { "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. Plak je licentiesleutel in Admin → Stores → Configuration → Codingrow Extensions → Auto Switch Home → License → License Key, sla op en dan bin/magento cache:flush.

Configuratie

Open Admin → Stores → Configuration → Codingrow Extensions → Auto Switch Home. Voer je License Key in, zet Enable automatic home switching op Ja en bouw de Switch calendar.

InstellingWat het doetStandaardOpmerkingen
License KeyDe voor dit domein uitgegeven licentiesleutel.—Accepteert een losse-module-sleutel of een Codingrow-abonnementssleutel. Leeg de cache na het plakken.
Enable automatic home switchingSchakelt het dagelijkse automatisch wisselen in.NeeBij de eerste activering wordt de huidige homepage onthouden; bij uitschakelen wordt die hersteld.
Switch calendarDe lijst met regels. Elke rij is een terugkerende dag + maand en de CMS-pagina die vanaf die datum wordt getoond.—Voeg zoveel rijen toe als je wilt. Het menu toont je Magento-CMS-pagina's.

Verwijderen

Zet Enable automatic home switching op Nee en sla op — je oorspronkelijke homepage wordt automatisch hersteld. Om de module volledig te verwijderen: bin/magento module:disable Codingrow_AutoSwitchHome daarna composer remove codingrow/module-auto-switch-home.

Gebruikershandleiding

De wisselkalender

Elke regel is een terugkerende dag + maand (zonder jaar) gekoppeld aan een van je CMS-pagina's. Je definieert de kalender één keer en die herhaalt zich elk jaar. Voeg één rij per overgang toe — zonder limiet.

Voorbeeld (seizoensgebonden): 21 maart → Lente, 21 juni → Zomer, 21 september → Herfst, 5 december → Kerst, 26 december → Winter.

Welke pagina is vandaag actief

De actieve regel is die waarvan de dag/maand het meest recent al is verstreken. Met 5 december → Kerst en 26 december → Winter is de home van 5 t/m 25 december Kerst, en vanaf 26 december Winter. De jaarwisseling wordt correct verwerkt: begin januari blijft de laatste decemberregel actief tot de eerste regel van het nieuwe jaar is bereikt. Rijen met onmogelijke datums (bijv. 31 februari) worden genegeerd.

Dagelijkse taak en directe toepassing

Een dagelijkse cron-taak (codingrow_autoswitchhome_apply, standaard 00:10, in een eigen cron-groep) stelt de homepage in op de actieve regel. De wissel wordt ook direct bij het opslaan van de configuratie toegepast, zodat je niet op de cron hoeft te wachten.

Vereist de Magento-cron. Als de cron van de winkel niet draait, vindt de dagelijkse wissel niet plaats (de wissel bij opslaan wordt toch direct toegepast).

Herstel en cache

Niet-destructief: de module bewaart je oorspronkelijke homepage bij de eerste activering en herstelt die automatisch wanneer je de module uitschakelt. Cache: hij vernieuwt de config- en full-page-cache alleen op de dagen waarop de homepage daadwerkelijk verandert — een paar keer per jaar. Een reindex is nooit nodig: veranderen welke CMS-pagina de home is, is een configuratiewijziging, geen catalogusindexwijziging.

Hyva- en Luma-ondersteuning

De module is thema-onafhankelijk. Hij verandert alleen welke CMS-pagina de homepage is, dus hij werkt identiek op het Hyva-thema en het standaard Luma-thema, zonder wijzigingen aan templates.

Licentie

De licentie wordt uitgegeven voor één domein en kan een losse-module-sleutel (Auto Switch Home) of een Codingrow-abonnementssleutel (alle modules) zijn. Zonder geldige licentie doet de module niets. Je licentie dekt de huidige versie plus 1 jaar updates en support; je kunt de gedekte versies voor altijd blijven gebruiken en de support (−35%) verlengen om naar nieuwere versies te upgraden.