Botão de Categorias Assistidas do Discourse

:discourse: Resumo Botão de Observar Categoria adiciona uma marcação span que se torna um botão “Observar esta categoria” nos posts.
:hammer_and_wrench: Repositório https://github.com/pacharanero/discourse-watch-category-button
:open_book: Novo em Temas do Discourse? Guia básico para usar Temas do Discourse

Instale este componente de tema

:information_source: Este componente de tema usa a sessão do usuário logado para atualizar os níveis de notificação de categoria; não são necessárias chaves de API.

Recursos

  • Adiciona um botão “Observar esta categoria” dentro dos posts usando um span seguro para sanitização.

  • Clicar no botão define o nível de notificação de categoria do usuário atual para Observando, seja para a categoria atual ou para uma categoria selecionada pelo CategoryId.

  • Somente posts criados por grupos permitidos (padrão: staff) são transformados em botões (isso reduz a chance deste TC ser usado indevidamente para fazer pessoas observarem categorias por falsificação).

  • Suporta direcionamento para um ID específico de categoria ou para a categoria do post atual.

  • Integra-se à funcionalidade existente de notificações de Observação do Discourse, sem alterar como o status de Observação é gerenciado de outra forma pelo usuário em suas preferências, por categoria ou nos cancelamentos de inscrição de notificações por e-mail.

Uso

Definir uma categoria específica

<span data-watch-category="3">Observar esta categoria</span>

Usar a categoria do post atual

<span data-watch-category="current">Observar esta categoria</span>

Resultado:

Configurações

Este componente ainda não inclui configurações de tema. Isso virá em seguida, quando eu tiver certeza de que não há bugs importantes e que este TC é útil para outras pessoas.

Considerações de segurança e privacidade

  • Estes botões só podem ser criados por usuários #staff (por enquanto)
  • Requer um clique explícito do usuário para alterar as configurações de notificação.
  • Nenhuma chave de API é usada; depende da sessão do usuário logado.

Ideias de roadmap

  • Tornar configuráveis via configurações de tema os grupos que podem criar botões.
  • Tornar configurável via configurações de tema o estilo do botão.
  • Tornar configurável o Nível de Notificação (ex.: Seguindo, Observando, Silenciado).

Contribuir

Ficarei feliz em aceitar contribuições! Por favor, abra issues ou pull requests no repositório do GitHub. Idealmente, vamos melhorar este componente em vez de fazer um fork para alterar o ALLOWED_GROUPS ou outras pequenas mudanças.

Tópicos relacionados

Ao pesquisar se este TC já havia sido criado, encontrei alguns tópicos solicitando funcionalidade semelhante:

Change notification level with a link
Can I create a link to subscribe to a category? - #3 by david
Make watching a category more prominent for users
Notification setting button with context

6 curtidas