Links em Destaque do Banner

:information_source: Resumo Banner Featured Links permite que você crie um banner de links.
:eyeglasses: Prévia Theme Creator
:hammer_and_wrench: Repositório GitHub - Arkshine/discourse-banner-featured-links · GitHub
:question: Guia de Instalação Como instalar um tema ou componente de tema
:open_book: Novo em Temas do Discourse? Guia para iniciantes sobre o uso de Temas do Discourse

Instale este componente de tema

Resumo

Banner Featured Links permite que você crie um banner de links.
Ele oferece uma ampla gama de opções de personalização.

É um recurso inspirado no fantástico tema Discourse “Meta Branded”.

Recursos

A aparência padrão – usa a cor do tema.
image

O botão pode ser estilizado separadamente:
image

Você pode colocar os links em vários lugares através da configuração plugin outlet.
Uma lista de locais comuns é fornecida na descrição.

:information_source: Recomendo usar o componente de tema Barra de Ferramentas do Desenvolvedor para ver onde estão localizados os plugin outlets!

Por exemplo, se você quiser imitar o tema Meta Brand, use o outlet search-banner-below-input. Isso pressupõe que você instalou o componente Search Banner.

Detalhes

O estilo atual pode ser alcançado com as seguintes configurações:

Incentivo você a tentar seu próprio estilo!

Configurações

Geral

Nome Descrição
links Links de texto a serem exibidos no cabeçalho.
show_for_members Exibir os links para usuários logados.
show_for_anon Exibir os links para usuários anônimos.
display_on_mobile Exibir os links em dispositivos móveis.
display_on_desktop Exibir os links em computadores desktop.
display on homepage Exibir os links na página inicial.
url must contain Insira os caminhos que devem exibir o banner. Adicione * ao final do caminho como um curinga.
plugin outlet O local para exibir os links.
Locais Comunsabove-main-containerabove-site-headerafter-headerbefore-header-panelbefore-list-areabefore-topic-listbelow-site-headerheader-list-container-bottomtopic-above-post-stream
Componente Search Banner:
search-banner-below-headlinesearch-banner-below-input

Configuração links:

Nome Descrição
Ícone O ícone ou emoji do FontAwesome a ser exibido para os links.
Atalhos
Windows: Win + ..
Mac: Cmd + Ctrl + Space
ChromeOS: Launch + Shift + Space
Título O título do link.
URL A URL para onde o link aponta.
Target Abre o documento vinculado:
_blank: em uma nova janela ou aba (este é o padrão)
_self: no mesmo quadro onde foi clicado
_parent: no quadro pai
_top: no corpo completo da janela.

Você também pode estilizar por botão. Isso substituirá o estilo global.

Nome Descrição
Largura A largura do botão.
Fonte A fonte do botão.
Arredondamento A quantidade de arredondamento a ser aplicada ao botão.
Fundo A cor de fundo do botão.
Fundo ao Passar o Mouse` A cor de fundo do botão ao passar o mouse.
Cor` A cor do texto cor do botão.
Cor ao Passar o Mouse` A cor do texto cor do botão ao passar o mouse.
Borda A borda do botão.
Borda ao Passar o Mouse A borda do botão ao passar o mouse.
Sombra A sombra do botão.
Classe CSS Uma classe CSS personalizada a ser aplicada ao botão.
Útil se você quiser estilizar o botão de forma diferente e as configurações não forem suficientes.
Você pode direcionar com .banner-featured-links__link.sua-classe {}

Estilização Global

Personalize o espaçamento e a aparência padrão dos links.
Você pode substituir a estilização de botão para cada link individualmente.

Estilização do Contêiner de Botões

Personalize o contêiner dos links.

Nome Descrição
buttons wrapper max width A largura máxima do contêiner de botões.
buttons wrapper margin A margem do contêiner de botões.
mobile buttons wrapper max width A largura máxima do contêiner de botões em dispositivos móveis.
mobile buttons wrapper margin A margem do contêiner de botões em dispositivos móveis.

Espaçamento dos Botões & Fonte do Texto

Personalize o espaçamento dos botões e o tamanho da fonte do texto.

Nome Descrição
buttons justify Como distribuir o espaço entre e ao redor dos links.
buttons gap O espaçamento entre os botões.
buttons font A fonte dos botões.
mobile buttons justify Como distribuir o espaço entre e ao redor dos links em dispositivos móveis.
mobile buttons gap O espaçamento entre os botões em dispositivos móveis.
mobile buttons direction A direção dos botões em dispositivos móveis.
mobile buttons font A fonte dos botões em dispositivos móveis.

Estilização de Botão

Personalize a aparência padrão dos botões.

Nome Descrição
button width A largura do botão.
button padding O preenchimento do botão.
button rounding A quantidade de arredondamento a ser aplicada ao botão.
button background A cor de fundo do botão.
button background hover A cor de fundo do botão ao passar o mouse.
button color A cor do texto cor do botão.
button colo hover A cor do texto cor do botão ao passar o mouse.
button border A borda do botão.
button border hover A borda do botão ao passar o mouse.
button shadow A sombra do botão.

Personalização Avançada

Você pode usar o seguinte CSS para personalizar ainda mais:

.banner-featured-links {
  &__wrapper {

  }

  &__wrapper-links {

  }

  &__link {

  }
}

Se você fornecer uma personalização por botão, pode fornecer um nome de classe na configuração CSS Classname.

Em seguida, você pode direcionar desta forma:

.banner-featured-links {
  &__link.minha-classe {

  }
}

Links Úteis

Créditos

  • Discourse pela ideia, inspirada no incrível tema Meta Branded.
  • Don e nolo – Eles criaram uma versão inicial; eu peguei algumas de suas ideias.
20 curtidas

Um comentário meta para melhorar uma introdução de componente de boa qualidade: uma captura de tela de um celular. Isso economizaria tempo ao escolher entre utilidade, prós e contras.

3 curtidas

Isso foi inspirado no tema Meta Branded?

Eu acho que sim :wink:

3 curtidas

Devo ter lido muito rápido - eu estava olhando a seção ‘Créditos’ :laughing:

3 curtidas

Sem problemas. Atualizei a seção de créditos para torná-la mais clara. Obrigado!

3 curtidas

Fiz um pequeno ajuste se você instalou o componente pela primeira vez. :+1:
Meu último commit renomeou uma configuração, mas os valores padrão não foram atualizados.
Graças a @manuel por relatar o problema!

5 curtidas

Olá @Arkshine, muito obrigado por este plugin!

Estou usando há um tempo, mas depois de adicionar outro botão hoje, ele quebrou todo o fórum, então agora está assim:

Você sabe por que isso pode ter acontecido?

2 curtidas

Ei, isso significa que se você remover este botão, ele não quebrará?

Bem, tive que entrar em contato com a equipe do Discourse para desativar o plugin, então tudo voltou ao normal, sim.

Agora estou meio hesitante em restaurar as configurações antigas para testar a teoria :sweat_smile:

2 curtidas

Entendi, sem problemas. Desculpe por isso! Você é o primeiro a ter esse problema. \nVocê ainda se lembra quais valores inseriu para o botão? Se eu conseguir reproduzir, isso seria útil!

3 curtidas

Claro, muito obrigado pela ajuda!

Isso é realmente estranho, pois fiz alterações não muito tempo atrás e funcionou perfeitamente.

Removi um dos botões e adicionei o novo:

Aqui estão os logs, se ajudar

[{“url”:“Topics tagged new-widget Widgets”,“target”:“_self”,“button_color_hover”:“#197bff”},{“url”:“Topics tagged In-Progress Progress”,“target”:“_self”,“button_color_hover”:“#197bff”},{“url”:“CSS Codes - Elfsight Community Codes”,“target”:“_self”,“button_color_hover”:“#197bff”},{“url”:“Ask the Community - Elfsight Community Recaps”,“target”:“_self”},{“icon”:“:trophy:”,“text”:"Join our Champion Program! ",“url”:“Elfsight Champion Program: Help us grow our community forum! - Announcements - Elfsight Community”}]

Anterior: [{“url”=>“Topics tagged new-widget”, “icon”=>“:fire:”, “text”=>“New Widgets”, “target”=>“_self”, “button_color_hover”=>“#197bff”}, {“url”=>“Topics tagged In-Progress”, “icon”=>“”, “text”=>“In Progress”, “target”=>“_self”, “button_color_hover”=>“#197bff”}, {“url”=>“CSS Codes - Elfsight Community”, “icon”=>“”, “text”=>“CSS Codes”, “target”=>“_self”, “button_color_hover”=>“#197bff”}, {“url”=>“Ask the Community - Elfsight Community”, “icon”=>“”, “text”=>“Support”, “target”=>“_self”, “button_color_hover”=>“#197bff”}, {“url”=>“Elfsight Champion Program: Help us grow our community forum! - Announcements - Elfsight Community”, “icon”=>“:trophy:”, “text”=>“Join our Champion Program! “, “target”=>”_self”}]

3 curtidas

Graças à ajuda de @Helga_Razinkova no PM, consegui reproduzir o problema.
Enviei uma correção :+1:.

Em resumo, o componente não esperava que as configurações fossem atualizadas através do Editor de Configurações e, com um campo icon ausente, ocorreu um erro.

2 curtidas

Isto é brilhante! É tão abrangente e personalizável; parece que você pensou em praticamente tudo.

Notei um pequeno bug em que os ícones não estão visíveis às vezes.

É assim que meus links ficam:
image

É assim que acontece quando você:

  1. Usa o Chrome (não tentei em outros navegadores, desculpe)
  2. Navega para longe de uma página com os Links em Destaque do Banner
  3. Retorna à página usando o botão ‘Voltar’ do navegador

image

Você pode demonstrar isso sozinho em ehealthforum.nz

4 curtidas

Obrigado Nathan! Eu enviei uma correção. Me avise se ainda acontecer!

4 curtidas

Maravilhoso!!! Tudo corrigido.

Encontrei outro bug de UX menor (mas preocupante):

O texto nos botões ainda é capturado pela pseudo classe :visited, o que significa que a cor do texto se comporta de forma estranha ao passar o mouse depois que cada link foi visitado.

Este é o estado sem hover:

image

Este é o estado com hover antes de visitar (tanto o ícone quanto o texto mudam)
image

Este é o estado com hover depois de visitar (observe que o ícone muda, mas o texto não)
image

3 curtidas

@nathank Você pode tentar atualizar e ver se está melhor?

2 curtidas

Isso foi com uma instância atualizada. Houve um pequeno PR no Search Banner, mas nenhum neste TC para aplicar. Independentemente disso, fiz uma reconstrução. Ainda está lá!

Não aparece no modo anônimo, imagino que porque ele não salva meu status de visitado.

4 curtidas

Isso é compatível com o Tema AIR para servir no topo da página da Comunidade com botões que levam ao WordPress?

Tentando colocar estes abaixo da barra de pesquisa (como neste site) usando ‘search-banner-below-input’ para o “Plugin outlet” – troquei ideias com a IA e ela explicou que agora, como a pesquisa é central e não uma extensão, essa localização não funcionará. Apenas curioso se isso está correto.

1 curtida