| Resumo | O Versatile Banner adiciona um banner personalizável ao seu site. | |
| Pré-visualização | Pré-visualização no Discourse Theme Creator | |
| Link do Repositório | https://github.com/discourse/discourse-versatile-banner | |
| Novo nos Temas do Discourse? | Guia para iniciantes sobre como usar Temas do Discourse |
Instale este componente de tema
Recursos
Este componente de tema é uma evolução dos esforços anteriores de banner. O objetivo é fornecer mais facilidade e flexibilidade por meio do uso de configurações de tema.
Abaixo está um destaque dos recursos:
- Limitar a exibição para usuários logados ou usuários anônimos
- Limitar a exibição para ser exclusivamente mobile ou desktop
- Limitar a exibição para páginas específicas
- Opções de fechamento, expansão e sempre visível
- Opção de largura total do navegador
- Gerenciamento de cores
- Personalização de título e colunas usando HTML (veja abaixo para mais detalhes)
- Opção de estado persistente (veja abaixo para mais detalhes)
Personalizando o conteúdo do seu banner
O conteúdo do banner é dividido em título principal e colunas. Você pode ter até 5 colunas no seu banner; no entanto, o número recomendado é de 3 ou menos devido às limitações de largura. Modelos HTML são fornecidos e podem ser personalizados para atender às suas necessidades individuais. Você também pode controlar a largura de cada coluna e adicionar qualquer imagem ou ícone do Font Awesome que desejar no topo de cada coluna.
Usando a opção de estado persistente
A opção de estado persistente dependerá de até dois cookies. Esses cookies conterão um nome para o banner e um valor verdadeiro/falso relacionado ao estado do banner. Se você tiver alguma preocupação sobre o uso de cookies no seu site, é melhor evitar usar essa configuração. Escolher uma opção de tempo relativo para a configuração cookie_lifespan garantirá que o banner permaneça fechado/expandido/recolhido por esse período de tempo após o usuário pressionar o botão apropriado. Sem essa configuração, o banner é redefinido a cada carregamento completo da página. Se você fizer uma alteração no banner e quiser garantir que todos os usuários vejam essas alterações, mesmo aqueles que haviam fechado o banner anteriormente, certifique-se de alterar o “nome do cookie”. Isso essencialmente redefinirá qualquer estado persistente, permitindo que o usuário feche o banner novamente.
Configurações
| Nome | Descrição |
|---|---|
| show for members | Exibir o banner para usuários logados no fórum |
| show for anon | Exibir o banner para usuários anônimos |
| display on mobile | Exibir o banner em dispositivos móveis |
| display on desktop | Exibir o banner em computadores desktop |
| display on homepage | Exibir o banner na página inicial |
| url must contain | Insira os caminhos que devem exibir o banner. Adicione * ao final do caminho como um curinga |
| dismissible | Permitir que o banner seja fechado pelos usuários |
| collapsible | Permitir que o banner seja expandido e recolhido pelos usuários |
| default collapsed state | Estado recolhido padrão quando a configuração collapsible está habilitada |
| cookie lifespan | A duração do cookie usado para lembrar se o banner foi fechado, expandido ou recolhido. Se definido como “none”, NENHUM cookie será usado com este componente, e quaisquer cookies criados anteriormente relacionados ao banner serão excluídos na próxima vez que um usuário realizar um carregamento completo da página. Os valores são medidos como uma única unidade, portanto, definir “year” será um ano, “week” será uma semana, etc. |
| cookie name | Quando alterações importantes são feitas no banner, você deve alterar o nome do cookie para garantir que todos os seus usuários vejam as alterações. |
| full width banner | Exibir o banner na largura total do navegador |
| swap default positioning | Se houver outro componente relacionado a banner ativo, use isso para trocar sua posição com o Versatile Banner |
| plugin outlet | below-site-header o coloca acima da barra lateral, above-main-container o coloca acima do conteúdo ao lado da barra lateral |
| banner background image | A URL de origem da sua imagem de fundo. Dica: Você pode carregar uma imagem no seu tema principal e usar a URL dela, mas certifique-se de não usar a seção “Uploads” deste componente. Quaisquer uploads adicionados a este componente serão excluídos sempre que ele for atualizado. |
| banner background image dark | A URL de origem da sua imagem de fundo quando o modo escuro do sistema for detectado. |
| background color | Usado no lugar de uma imagem de fundo |
| background color dark | Usado no lugar de uma imagem de fundo quando o modo escuro do sistema for detectado. |
| primary text color | A cor principal do texto do banner |
| primary text color dark | A cor principal do texto do banner quando o modo escuro do sistema for detectado |
| secondary text color | A cor do texto do ícone e dos títulos de texto, e a cor de fundo do botão. |
| secondary text color dark | A cor do texto do ícone e dos títulos de texto, e a cor de fundo do botão quando o modo escuro do sistema for detectado. |
| link text color | A cor do texto dos links dentro do banner |
| link text color dark | A cor do texto dos links dentro do banner quando o modo escuro do sistema for detectado. |
| Tradução | Padrão |
|---|---|
| close.title | Fechar o banner |
| close.label | Fechar |
| toggle.title | Expandir/Recolher o banner |
| toggle.collapse_label | Recolher |
| toggle.expand_label | Expandir |
Hospedado por nós? Os componentes de tema estão disponíveis para uso em nossos planos Pro, Business e Enterprise.

