| 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 é fornecer 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, expansibilidade e visibilidade constante
- Opção de largura total do navegador
- Gerenciamento de cores
- Personalização de cabeçalho 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 no cabeçalho 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 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 com 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 anteriormente fecharam o banner, 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 no mobile | Exibir o banner em dispositivos móveis |
| exibir no 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 o banner seja fechado pelos usuários |
| recolhível | Permitir que o banner seja expandido e recolhido pelos usuários |
| estado recolhido padrão | Estado recolhido padrão quando a configuração de recolhimento 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 “nenhum”, NENHUM cookie será usado com este componente, e quaisquer cookies relacionados ao banner criados anteriormente 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, então definir “ano” será um ano, “semana” será uma semana, etc. |
| nome do cookie | 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. |
| 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 dessa imagem, 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 é 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 é detectado. |
| cor do texto primário | A cor do texto principal do banner |
| cor do texto primário escuro | A cor do texto principal do banner quando o modo escuro do sistema é detectado |
| cor do texto secundário | A cor do texto do ícone e dos cabeçalhos de texto, e a cor de fundo do botão. |
| cor do texto secundário escuro | A cor do texto do ícone e dos cabeçalhos de texto, e a cor de fundo do botão quando o modo escuro do sistema é detectado. |
| cor do texto do link | A cor do texto dos links dentro do banner |
| cor do texto do link escuro | A cor do texto dos links dentro do banner quando o modo escuro do sistema é 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.

