Documentazione Auto Switch Home

Passi di installazione e un riferimento completo per ogni impostazione, con esempi concreti — lo stesso livello di dettaglio che usa la nostra assistenza.

Installazione

Requisiti

Magento 2.4.x — testato su 2.4.9, compatibile con le versioni 2.4.* precedenti. PHP 8.1–8.5. Il cron di Magento deve essere in esecuzione (il cambio avviene ogni giorno). Compatibile sia con il tema Luma predefinito sia con il tema Hyva. Dipende dal modulo gratuito codingrow/module-core, installato automaticamente.

Passi di installazione

  1. Aggiungi le credenziali che riceverai via email al file auth.json nella radice del progetto Magento:
    { "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. Incolla la chiave di licenza in Admin → Stores → Configuration → Codingrow Extensions → Auto Switch Home → License → License Key, salva, poi bin/magento cache:flush.

Configurazione

Apri Admin → Stores → Configuration → Codingrow Extensions → Auto Switch Home. Inserisci la License Key, imposta Enable automatic home switching su Sì e costruisci il Switch calendar.

ImpostazioneCosa faDefaultNote
License KeyLa chiave di licenza rilasciata per questo dominio.—Accetta una chiave del singolo modulo o una chiave abbonamento Codingrow. Svuota la cache dopo averla incollata.
Enable automatic home switchingAttiva il cambio automatico giornaliero.NoAlla prima attivazione la home page attuale viene memorizzata; alla disattivazione viene ripristinata.
Switch calendarL'elenco delle regole. Ogni riga è un giorno + mese ricorrenti e la pagina CMS da mostrare da quella data in poi.—Aggiungi tutte le righe che vuoi. Il menu elenca le tue pagine CMS di Magento.

Disinstallazione

Imposta Enable automatic home switching su No e salva — la tua home page originale viene ripristinata automaticamente. Per rimuovere del tutto il modulo: bin/magento module:disable Codingrow_AutoSwitchHome poi composer remove codingrow/module-auto-switch-home.

Guida all'uso

Il calendario di cambio

Ogni regola è un giorno + mese ricorrenti (senza anno) associati a una delle tue pagine CMS. Definisci il calendario una volta e si ripete ogni anno. Aggiungi una riga per ogni transizione — nessun limite.

Esempio (stagionale): 21 marzo → Primavera, 21 giugno → Estate, 21 settembre → Autunno, 5 dicembre → Natale, 26 dicembre → Inverno.

Quale pagina è attiva oggi

La regola attiva è quella il cui giorno/mese è l'ultimo già trascorso. Con 5 dicembre → Natale e 26 dicembre → Inverno, dal 5 al 25 dicembre la home è Natale, dal 26 dicembre è Inverno. La fine dell'anno viene gestita correttamente: a inizio gennaio l'ultima regola di dicembre resta attiva finché non si raggiunge la prima regola del nuovo anno. Le righe con date impossibili (es. 31 febbraio) vengono ignorate.

Operazione giornaliera e applicazione immediata

Un job cron giornaliero (codingrow_autoswitchhome_apply, default 00:10, in un gruppo cron dedicato) imposta la home page sulla regola attiva. Il cambio viene applicato anche subito al salvataggio della configurazione, così non devi aspettare il cron.

Richiede il cron di Magento. Se il cron del negozio non gira, il cambio giornaliero non avviene (il cambio al salvataggio si applica comunque subito).

Ripristino e cache

Non distruttivo: il modulo memorizza la tua home page originale alla prima attivazione e la ripristina automaticamente alla disattivazione. Cache: aggiorna la cache config e full-page solo nei giorni in cui la home page cambia davvero — poche volte l'anno. Nessun reindex è mai necessario: cambiare quale pagina CMS è la home è una modifica di configurazione, non di indice del catalogo.

Supporto Hyva e Luma

Il modulo è indipendente dal tema. Cambia solo quale pagina CMS è la home, quindi funziona in modo identico sul tema Hyva e sul tema Luma predefinito, senza modifiche ai template.

Licenza

La licenza è rilasciata per un dominio e può essere una chiave del singolo modulo (Auto Switch Home) o una chiave abbonamento Codingrow (tutti i moduli). Senza una licenza valida il modulo non fa nulla. La licenza copre la versione attuale più 1 anno di update e supporto; puoi continuare a usare per sempre le versioni coperte e rinnovare il supporto (−35%) per aggiornare a versioni successive.