Codingrow Auto Switch Home

Installation

Prérequis

Magento 2.4.x — testé sur 2.4.9, compatible avec les versions 2.4.* précédentes. PHP 8.1–8.5. Le cron de Magento doit être en cours d'exécution (le changement a lieu chaque jour). Compatible avec le thème Luma par défaut et le thème Hyva. Dépend du module gratuit codingrow/module-core, installé automatiquement.

Étapes d'installation

Ajoutez les identifiants que vous recevrez par e-mail au fichier auth.json à la racine de votre projet Magento :
```
{ "http-basic": { "repo.codingrow.com": { "username": "...", "password": "..." } } }
```
composer config repositories.codingrow composer https://repo.codingrow.com
composer require codingrow/module-auto-switch-home
bin/magento module:enable Codingrow_AutoSwitchHome
bin/magento setup:upgrade && bin/magento setup:di:compile
Collez votre clé de licence dans Admin → Stores → Configuration → Codingrow Extensions → Auto Switch Home → License → License Key, enregistrez, puis bin/magento cache:flush.

Configuration

Ouvrez Admin → Stores → Configuration → Codingrow Extensions → Auto Switch Home. Saisissez votre License Key, mettez Enable automatic home switching sur Oui et construisez le Switch calendar.

Réglage	Ce qu'il fait	Par défaut	Notes
License Key	La clé de licence délivrée pour ce domaine.	—	Accepte une clé de module unique ou une clé d'abonnement Codingrow. Videz le cache après l'avoir collée.
Enable automatic home switching	Active le changement automatique quotidien.	Non	À la première activation, la page d'accueil actuelle est mémorisée ; à la désactivation, elle est restaurée.
Switch calendar	La liste des règles. Chaque ligne est un jour + mois récurrents et la page CMS à afficher à partir de cette date.	—	Ajoutez autant de lignes que vous voulez. Le menu liste vos pages CMS Magento.

Désinstallation

Mettez Enable automatic home switching sur Non et enregistrez — votre page d'accueil d'origine est restaurée automatiquement. Pour supprimer complètement le module : bin/magento module:disable Codingrow_AutoSwitchHome puis composer remove codingrow/module-auto-switch-home.

Guide d'utilisation

Le calendrier de changement

Chaque règle est un jour + mois récurrents (sans année) associés à une de vos pages CMS. Vous définissez le calendrier une fois et il se répète chaque année. Ajoutez une ligne par transition — sans limite.

Exemple (saisonnier) : 21 mars → Printemps, 21 juin → Été, 21 septembre → Automne, 5 décembre → Noël, 26 décembre → Hiver.

Quelle page est active aujourd'hui

La règle active est celle dont le jour/mois est le plus récent déjà passé. Avec 5 décembre → Noël et 26 décembre → Hiver, du 5 au 25 décembre l'accueil est Noël, et à partir du 26 décembre c'est Hiver. La fin d'année est gérée correctement : début janvier, la dernière règle de décembre reste active jusqu'à ce que la première règle de la nouvelle année soit atteinte. Les lignes avec des dates impossibles (p. ex. 31 février) sont ignorées.

Tâche quotidienne et application immédiate

Une tâche cron quotidienne (codingrow_autoswitchhome_apply, par défaut 00:10, dans son propre groupe de cron) définit la page d'accueil sur la règle active. Le changement est aussi appliqué immédiatement à l'enregistrement de la configuration, vous n'avez donc pas à attendre le cron.

Nécessite le cron de Magento. Si le cron de la boutique ne tourne pas, le changement quotidien n'a pas lieu (le changement à l'enregistrement s'applique quand même immédiatement).

Restauration et cache

Non destructif : le module enregistre votre page d'accueil d'origine la première fois que vous l'activez et la restaure automatiquement lorsque vous le désactivez. Cache : il rafraîchit le cache de configuration et de page complète uniquement les jours où l'accueil change réellement — quelques fois par an. Aucune réindexation n'est jamais nécessaire : changer quelle page CMS est l'accueil est un changement de configuration, pas d'index du catalogue.

Prise en charge Hyva et Luma

Le module est indépendant du thème. Il change seulement quelle page CMS est l'accueil, il fonctionne donc de façon identique sur le thème Hyva et le thème Luma par défaut, sans modification des templates.

Licence

La licence est délivrée pour un domaine et peut être une clé de module unique (Auto Switch Home) ou une clé d'abonnement Codingrow (tous les modules). Sans licence valide, le module ne fait rien. Votre licence couvre la version actuelle plus 1 an de mises à jour et support ; vous gardez l'usage des versions couvertes pour toujours et pouvez renouveler le support (−35%) pour passer aux versions plus récentes.

Documentation Auto Switch Home