Poderia um membro da @staff considerar mover este tópico para Customization > Theme component? Não consigo criar novos tópicos lá.
 |
Resumo | O 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 no 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 recursos no repositório do GitHub.
Capturas de tela
Botões
Um caso de uso específico: um botão ‘Pergunte-nos por MP’
Recursos
- Transforma um link normal em um botão em qualquer lugar 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 (padding), 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 substitua 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 saberão realmente como fazer. Você pode também usar Palavras Monitoradas para filtrar posts que contenham
[wrap=custom-button]para aprovação, o que restringiria a funcionalidade.
Instalação
Em Administração > 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
(Nota: Isso usa a funcionalidade integrada do Discourse para abrir o Compositor 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 esse 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 do seu ‘Nome Completo’ e codifique os valores dos parâmetros em URL. A configuração Quem pode enviar mensagem a este grupo? do grupo ainda determina quem pode abrir um compositor endereçado, e visitantes deslogados serão solicitados a fazer login.
Configurações
| Configuração | Propósito |
|---|---|
button_default_color |
Cor de fundo e borda padrão 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 da fonte 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 esse recurso 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.
