Instalação
Requisitos
Magento 2.4.x — testado em 2.4.9, compatível com versões 2.4.* anteriores. PHP 8.1–8.5. O cron do Magento deve estar em execução (a troca acontece diariamente). Compatível tanto com o tema Luma padrão como com o tema Hyva. Depende do módulo gratuito codingrow/module-core, instalado automaticamente.
Passos de instalação
- Adicione as credenciais que receberá por e-mail ao ficheiro
auth.jsonna raiz do seu projeto Magento:{ "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- Cole a sua chave de licença em Admin → Stores → Configuration → Codingrow Extensions → Auto Switch Home → License → License Key, guarde e depois
bin/magento cache:flush.
Configuração
Abra Admin → Stores → Configuration → Codingrow Extensions → Auto Switch Home. Introduza a sua License Key, coloque Enable automatic home switching em Sim e construa o Switch calendar.
| Configuração | O que faz | Padrão | Notas |
|---|---|---|---|
| License Key | A chave de licença emitida para este domínio. | — | Aceita uma chave de módulo individual ou uma chave de assinatura Codingrow. Limpe a cache depois de colar. |
| Enable automatic home switching | Ativa a troca automática diária. | Não | Na primeira ativação a página inicial atual é memorizada; ao desativar é restaurada. |
| Switch calendar | A lista de regras. Cada linha é um dia + mês recorrentes e a página CMS a exibir a partir dessa data. | — | Adicione quantas linhas quiser. O menu lista as suas páginas CMS do Magento. |
Desinstalação
Coloque Enable automatic home switching em Não e guarde — a sua página inicial original é restaurada automaticamente. Para remover totalmente o módulo: bin/magento module:disable Codingrow_AutoSwitchHome e depois composer remove codingrow/module-auto-switch-home.
Guia de utilização
O calendário de troca
Cada regra é um dia + mês recorrentes (sem ano) associados a uma das suas páginas CMS. Define o calendário uma vez e ele repete-se todos os anos. Adicione uma linha por transição — sem limite.
Qual página está ativa hoje
A regra ativa é aquela cujo dia/mês é o mais recente já ocorrido. Com 5 dezembro → Natal e 26 dezembro → Inverno, de 5 a 25 de dezembro a página inicial é Natal, e a partir de 26 de dezembro é Inverno. A virada do ano é tratada corretamente: no início de janeiro a última regra de dezembro permanece ativa até se atingir a primeira regra do novo ano. Linhas com datas impossíveis (p. ex. 31 de fevereiro) são ignoradas.
Tarefa diária e aplicação imediata
Uma tarefa cron diária (codingrow_autoswitchhome_apply, por defeito 00:10, num grupo de cron próprio) define a página inicial como a regra ativa. A troca também é aplicada imediatamente ao guardar a configuração, por isso não precisa de esperar pelo cron.
Restauração e cache
Não destrutivo: o módulo guarda a sua página inicial original na primeira ativação e restaura-a automaticamente quando o desativa. Cache: atualiza a cache de configuração e de página completa apenas nos dias em que a página inicial realmente muda — algumas vezes por ano. Nunca é necessária uma reindexação: mudar qual página CMS é a inicial é uma alteração de configuração, não de índice do catálogo.
Suporte Hyva e Luma
O módulo é independente do tema. Muda apenas qual página CMS é a inicial, por isso funciona de forma idêntica no tema Hyva e no tema Luma padrão, sem alterações aos templates.
Licença
A licença é emitida para um domínio e pode ser uma chave de módulo individual (Auto Switch Home) ou uma chave de assinatura Codingrow (todos os módulos). Sem uma licença válida o módulo não faz nada. A tua licença cobre a versão atual mais 1 ano de atualizações e suporte; podes continuar a usar para sempre as versões cobertas e renovar o suporte (−35%) para atualizar para versões mais recentes.