| Resumo | Versatile Banner adiciona um banner personalizável ao seu site. | |
| Pré-visualização | Pré-visualizar no Discourse Theme Creator | |
| Link do Repositório | https://github.com/discourse/discourse-versatile-banner | |
| Novo em Temas do Discourse? | Guia para iniciantes sobre o uso de Temas do Discourse |
Instalar este componente de tema
Funcionalidades
Este componente de tema é uma evolução de esforços anteriores com banners. O objetivo é oferecer mais facilidade e flexibilidade por meio do uso de configurações de tema.
Abaixo estão os destaques das funcionalidades:
- Limitar a exibição a usuários logados ou anônimos
- Limitar a exibição exclusivamente para dispositivos móveis ou desktop
- Limitar a exibição a páginas específicas
- Opções de descarte, expansão e visibilidade permanente
- 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 é 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 em usar cookies no seu site, o ideal é 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 pelo período especificado 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 já fecharam o banner anteriormente, certifique-se de alterar o “nome do cookie”. Isso essencialmente redefinirá qualquer estado persistente e permitirá que o usuário feche o banner mais uma vez.
Configurações
| Nome | Descrição |
|---|---|
| mostrar para membros | Exibir o banner para usuários logados no fórum |
| mostrar para anônimos | Exibir o banner para usuários anônimos |
| exibir em dispositivos móveis | Exibir o banner em dispositivos móveis |
| exibir em desktop | Exibir o banner em computadores desktop |
| exibir na página inicial | Exibir o banner na página inicial |
| url deve conter | Insira os caminhos que devem exibir o banner. Adicione * ao final do caminho como um curinga |
| descartável | Permitir que os usuários fechem o banner |
| recolhível | Permitir que os usuários expandam e recolham o banner |
| estado recolhido padrão | Estado recolhido padrão quando a configuração de recolhível está ativada |
| tempo de vida do cookie | O tempo de vida 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 qualquer cookie relacionado ao banner criado anteriormente será excluído na próxima vez que um usuário fizer um carregamento completo da página. Os valores são medidos como uma única unidade, então definir “year” será um ano, “week” será uma semana, etc. |
| nome do cookie | Quando alterações importantes forem feitas no banner, você deve alterar o nome do cookie para garantir que todos os seus usuários vejam as alterações. |
| banner de largura total | Exibir o banner na largura total do navegador |
| trocar posição padrão | 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 |
| imagem de fundo do banner | A URL de origem para sua imagem de fundo. Dica: Você pode fazer upload de uma imagem para seu tema principal e usar a URL dela, mas certifique-se de não usar a seção “Uploads” deste componente. Qualquer upload adicionado a este componente será excluído sempre que for atualizado. |
| imagem de fundo do banner escuro | A URL de origem para sua imagem de fundo quando o modo escuro do sistema for detectado. |
| cor de fundo | Usada no lugar de uma imagem de fundo |
| cor de fundo escuro | Usada no lugar de uma imagem de fundo quando o modo escuro do sistema for detectado. |
| cor do texto primário | A cor principal do texto do banner |
| cor do texto primário escuro | A cor principal do texto do banner quando o modo escuro do sistema for detectado |
| cor do texto secundário | A cor do texto do ícone e dos títulos de texto, e a cor de fundo do botão. |
| cor do texto secundário escuro | 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. |
| cor do texto de link | A cor do texto dos links dentro do banner |
| cor do texto de link escuro | 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? Componentes de tema estão disponíveis para uso em nossos planos Pro, Business e Enterprise.

