plugin-HomeHeaderBanners

Plugin de configuração de banners da página inicial para uso na plataforma Mapas Culturais

Efeitos do uso do plugin

• O plugin permite que administradores da rede (saasAdmin ou superSaasAdmin) configurem até 3 banners exibidos no cabeçalho da página inicial (home-header) através de uma interface administrativa no painel de controle. Cada banner pode ter sua própria imagem, link de destino, descrição alternativa (alt) e opção para abrir em nova aba.

Requisitos Mínimos

• Mapas Culturais v7.6.0^

Configuração básica

Configurações necessárias para uso no ambiente de desenvolvimento ou produção

• No arquivo config/plugins.php (ou docker/common/config.d/plugins.php), adicione a linha 'HomeHeaderBanners' para ativar o plugin:

  <?php
  
  return [
      'plugins' => [
          'MultipleLocalAuth',
          'HomeHeaderBanners',
      ]
  ];

Como funciona

• O plugin HomeHeaderBanners adiciona um item de menu no painel de controle (sidebar esquerdo) visível apenas para usuários com permissões de saasAdmin ou superSaasAdmin. Ao acessar a página de configuração através do menu "Banners da Home", o administrador pode configurar até 3 banners diferentes.

• Para cada banner, são disponibilizados 4 campos de configuração:

  1. Link da imagem: URL completa da imagem do banner (suporta URLs absolutas, relativas ou caminhos de assets)
  2. Link de destino: URL para onde o usuário será redirecionado ao clicar no banner
  3. Descrição (alt): Texto alternativo para acessibilidade e SEO
  4. Abrir em outra aba: Checkbox para definir se o link deve abrir em uma nova aba do navegador

• As configurações são salvas automaticamente, garantindo persistência entre reinicializações da aplicação.

• O plugin aplica automaticamente as configurações salvas ao sistema, sobrescrevendo as configurações padrão do home-header quando disponíveis. Se nenhuma configuração for salva, o sistema utiliza as configurações padrão definidas no conf-base.php ou config.php do tema.

Personalização

• As configurações dos banners são gerenciadas exclusivamente através da interface administrativa do plugin. Não é necessário editar arquivos de configuração manualmente.

• O plugin suporta diferentes formatos de URL para as imagens:

  • URLs absolutas (https://exemplo.com/imagem.jpg)
  • URLs relativas (/assets/imagem.jpg)
  • Caminhos de assets do tema (serão processados automaticamente pelo sistema de assets)

Permissões

• O plugin requer permissões de saasAdmin ou superSaasAdmin para acessar a página de configuração e salvar alterações.

• Usuários sem essas permissões não verão o item de menu no painel de controle.

Observações

• As configurações são aplicadas imediatamente após o salvamento, sem necessidade de reiniciar a aplicação.

• O plugin mantém compatibilidade com as configurações existentes do home-header definidas no conf-base.php ou config.php do tema. Se uma configuração for salva através do plugin, ela terá prioridade sobre as configurações padrão.

• O arquivo de configuração é criado automaticamente no primeiro salvamento.