 |
Resumo | Usuários criam coleções de Tópicos vinculados |
 |
Link do Repositório | https://github.com/Alteras1/discourse-collections |
 |
Guia de Instalação | Como instalar plugins no Discourse |
Pré-visualização
Móvel
Coleções
Isso permite que os usuários criem coleções de Tópicos que ficam visíveis ao visualizar os respectivos Tópicos. As coleções podem incluir qualquer URL e serão visíveis em qualquer Tópico vinculado. As coleções podem ser organizadas em seções, e qualquer alteração em uma coleção é refletida em todos os tópicos vinculados. Não há restrição quanto ao Tópico a ser vinculado, portanto, os usuários podem criar uma coleção entre categorias/tags.
Título e Descrição
Campo opcional disponível para entrada. Se fornecidos, estes serão exibidos no topo da lista.
Seções
Recurso organizacional opcional. Ao adicionar um cabeçalho de seção, a coleção pode ser dividida em seções, permitindo que seções recolhíveis sejam exibidas.
Subcoleções
Os usuários também podem criar uma subcoleção, que é exibida apenas para um único tópico, permitindo que os usuários vinculem URLs relevantes (ou seja, posts específicos/recursos externos) apenas para o tópico único. Quaisquer URLs de tópicos adicionados não serão vinculados.
Permissões
O plugin permite que qualquer usuário crie uma coleção para seus próprios Tópicos. Por padrão, os usuários só podem vincular aos seus próprios Tópicos e devem adicionar outros usuários como mantenedores, que podem adicionar seus próprios Tópicos à coleção. Essa configuração pode ser desativada, permitindo apenas que grupos específicos tenham controle total sobre qualquer coleção (por padrão, Equipe e TL4).
Demo de Permissões
Configurações
| Nome | Descrição |
|---|---|
| coleções habilitadas | Habilita/desabilita o plugin. Padrão: true |
| coleção por proprietário do tópico | Permite que o autor do tópico crie coleções. Padrão: true |
| coleção por proprietário do tópico permite grupos | Restringe os autores de tópicos que podem criar coleções. Limita coleção por proprietário do tópico. Padrão: TL1 |
| subcoleção por proprietário do tópico permite grupos | Restringe os autores de tópicos que podem criar subcoleções. Limita coleção por proprietário do tópico. Padrão: TL1 |
| modificação de coleção por grupos permitidos | Grupos autorizados a criar/modificar qualquer coleção. Padrão: Admin Moderators TL4. |
| seções em subcoleção | Permite cabeçalhos de seção em subcoleções. Padrão: true |
Alternativas
Este plugin é fortemente inspirado por (e em algum momento foi baseado no) plugin Discourse Doc Categories. Embora o plugin Doc Categories tenha um bom mecanismo de indexação e a exibição seja excelente, o design foi pensado para páginas no estilo wiki, onde tudo é compilado em uma única categoria. Da mesma forma, a indexação depende de entrada de texto formatada em um Tópico separado, o que tem suas próprias vantagens e desvantagens.
O componente de tema DiscoTOC - automatic table of contents também permite organizar links fora do corpo da postagem, mas é limitado a um único tópico.
Se seu objetivo for apenas uma organização no estilo wiki, Discourse Doc Categories seria uma melhor opção. Se você precisar apenas que algumas páginas tenham Tópicos vinculados, DiscoTOC - automatic table of contents seria melhor.
Notas
Isso foi originalmente projetado para apoiar a migração do fórum do qual faço parte para o Discourse. Como um fórum focado em escrita, os usuários mantêm tópicos separados para diferentes finalidades, resultando em uma situação em que links entre tópicos em diferentes categorias são praticamente necessários. Para ajudar a facilitar isso, criei este plugin para apoiar a auto-organização dos usuários.
Existe uma linha do tempo alternativa em que isso é apenas um componente de tema, onde a indexação ocorreria com divs inseridos pelo usuário com URLs para outras postagens. Mas depois de desenvolver 90% das ferramentas, assistentes e código para fazer isso, percebi que simplesmente não valia a pena e que o usuário provavelmente ignoraria todos os tutoriais escritos e ainda reclamaria sobre por que as coisas não estavam funcionando. Então, esse caminho foi abandonado. Honestamente, não é uma má solução, pois seria muito mais leve do que um plugin, mas colocaria uma carga desnecessária sobre os usuários para garantir que eles tivessem a formatação correta não apenas em uma postagem, mas em várias.
Atualmente, marquei isso como experimental, pois ainda não estou 100% definido sobre os recursos de interface do usuário (ou seja, ícones) e o sistema de permissões. Além disso, preciso adicionar testes de unidade automatizados.
(iPad)
