 |
Resumo | Discourse Custom Post Button transforma links em posts do Discourse em botões estilizados. |
 |
Repositório | github.com/koloki-co/discourse-custom-post-button |
 |
Guia de instalação | Instalando um tema ou componente de tema |
 |
Novo em temas do Discourse? | Guia para iniciantes sobre o uso de Temas do Discourse |
Instalar este componente de tema
Este é um componente de tema da comunidade mantido pela Koloki Ltd. Não é um componente oficial do Discourse. Está em fase alfa, portanto, pode conter bugs. Por favor, reporte bugs e solicite funcionalidades no repositório do GitHub.
Capturas de tela
Botões
Um caso de uso específico: um botão ‘Pergunte-nos por MP’
Funcionalidades
- Transforma um link normal em um botão em qualquer parte de um tópico ou post usando
[wrap]. - Fornece configurações padrão configuráveis no nível do TC (componente de tema) para cor de fundo, raio da borda, preenchimento, peso da fonte, cor do texto e opacidade ao passar o mouse; caso contrário, usa os padrões do seu site.
- Permite que um botão individual sobrescreva a cor de fundo padrão.
- Suporta texto explicativo ao lado de um botão.
- Mantém o conteúdo subjacente como um link normal, para que os botões possam abrir páginas externas ou rotas internas do Discourse, como
/new-message.
IMPORTANTE: Se este TC estiver instalado, qualquer usuário do seu fórum poderá criar esses botões. Para restringir a capacidade de criar botões a certos usuários, seria necessário um Plugin completo. No entanto, na prática, os usuários precisam saber que ele está instalado e como criar um botão, então suspeito que poucos realmente saberão como fazer. Você pode também usar Palavras Monitoradas para filtrar posts com
[wrap=custom-button]para aprovação, o que restringiria a funcionalidade.
Instalação
Em Admin > Aparência > Temas e componentes, abra a aba Componentes, selecione Instalar e escolha Instalar a partir de uma URL de repositório Git. Use:
https://github.com/koloki-co/discourse-custom-post-button
Após a instalação, adicione o componente a cada tema ativo onde ele deve estar disponível.
Uso
Botão básico
A cor padrão do botão das configurações do TC será usada
[wrap=custom-button][Texto do Seu Botão Personalizado](https://example.com)[/wrap]
Configuração de cor por botão
[wrap=custom-button color=#7CC146][Texto do Seu Botão Personalizado](https://example.com)[/wrap]
Botão seguido de texto explicativo
[wrap=custom-button][Texto do Seu Botão Personalizado](https://example.com)[/wrap]
[wrap=text-after-button]Texto explicativo adicional[/wrap] (em uma nova linha)
Abrir uma mensagem privada para um grupo
(OBS: Isso usa a funcionalidade integrada do Discourse para abrir o Composer com texto pré-preenchido - essa parte da funcionalidade não vem do Componente de Tema, estou apenas usando para demonstrar um caso de uso possível. Requer que as configurações do grupo permitam MPs para aquele grupo.)
[wrap=custom-button][Pergunte-nos](/new-message?groupname=somegroup&title=Aask%20Us&body=Please%20type%20your%20question%20here.)[/wrap]
Use o name slugificado do grupo em vez de seu ‘Full Name’ e codifique os valores dos parâmetros na URL. A configuração Quem pode enviar mensagem a este grupo? do grupo ainda determina quem pode abrir um composer endereçado, e visitantes desconectados serão solicitados a fazer login.
Configurações
| Configuração | Propósito |
|---|---|
button_default_color |
Cor padrão de fundo e borda do botão |
button_border_radius |
Raio dos cantos do botão |
button_padding |
Espaço ao redor do rótulo do botão |
button_font_weight |
Peso do rótulo do botão |
button_text_color |
Cor do rótulo do botão |
button_hover_opacity |
Opacidade do botão ao passar o mouse |
O componente também expõe uma configuração svg_icons para ícones de tema disponíveis, mas atualmente não insere um ícone em um botão de post. Adicionarei essa funcionalidade se houver demanda.
Notas
- O componente altera apenas a apresentação. Os botões permanecem como links e as permissões de destino não são alteradas.
- Clientes de e-mail e outros contextos que não carregam o tema ativo do Discourse podem exibir o link subjacente sem o estilo de botão.
- O componente é licenciado sob a Licença MIT.
O componente surgiu do mesmo padrão útil [wrap] discutido em Como incorporar um botão em um Post de Tópico.
