Coleções

Plugin
1
:information_source: Resumo Usuários criaram coleções de Tópicos vinculados
:hammer_and_wrench: Link do Repositório https://github.com/Alteras1/discourse-collections
:open_book: Guia de Instalação Como instalar plugins no Discourse

Prévia

Mobile

Coleções

Isso permite que os usuários criem coleções de Tópicos que são visíveis ao visualizar esses 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 quaisquer alterações em uma coleção são refletidas em todos os Tópicos vinculados. Não há restrição no Tópico a ser vinculado, então os usuários podem criar uma coleção entre categorias/tags.

Título e Descrição

Campo opcional disponível para entrada. Se fornecido, 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 a exibição de seções colapsáveis.

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, postagens específicas/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. Esta configuração pode ser desativada, permitindo que apenas grupos específicos tenham controle total sobre qualquer coleção (por padrão, Staff e TL4).

Demo de Permissões

Configurações

Nome Descrição
coleções ativadas Ativar/desativar o plugin. Padrão: true
coleção por proprietário do tópico Permitir que o OP do tópico crie coleções. Padrão: true
grupos permitidos para coleção por proprietário do tópico Restringir o OP do tópico que pode criar coleções. Limita coleção por proprietário do tópico. Padrão: TL1
modificação de coleção por grupos permitidos Grupos permitidos para criar/modificar qualquer coleção. Padrão: Admin Moderators TL4.
seções em subcoleção Permitir cabeçalhos de seção em subcoleções. Padrão: true

Alternativas

Este plugin é fortemente inspirado (e em um 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 ótima, o design foi feito para páginas estilo wiki, onde tudo é compilado em uma única categoria. Da mesma forma, a indexação depende de entrada de texto formatado em um Tópico separado, que tem seus próprios prós e contras.

O componente de tema DiscoTOC - automatic table of contents também permite a organização de links fora do corpo da postagem, mas é limitado a um único tópico.

Se o seu objetivo é apenas uma organização estilo wiki, Discourse Doc Categories seria um ajuste melhor. Se você precisa apenas que algumas páginas tenham Tópicos vinculados, DiscoTOC - automatic table of contents seria melhor.

Observações

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, tópicos separados são mantidos por usuários para diferentes propósitos, resultando em uma situação onde 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 onde 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 não valia a pena e que o usuário provavelmente pularia todos os tutoriais escritos e ainda reclamaria por que as coisas não estavam funcionando. Então, esse caminho foi abandonado. Honestamente, não é uma solução ruim, pois seria muito mais leve do que um plugin, mas teria colocado um ônus desnecessário 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% certo sobre os recursos da interface do usuário (ou seja, ícones) e o sistema de permissões. Além disso, preciso adicionar testes unitários automatizados.

20 curtidas
Post Collections, Topic-to-Topic Navigation Buttons, Menus, Anchor Links, and Topic TOC
2

Para sua informação: todos os vídeos estavam quebrados :thinking: (iPad)

1 curtida
3

Huh, eu pensei que o Safari do iOS suportava WebM…

Troquei os vídeos por MP4. Valeu!

5 curtidas
4

É possível habilitar coleções ‘públicas’ como na Discourse Docs?

1 curtida
5

Desculpe se não ficou claro, todas as coleções são “públicas”. Todos os usuários verão a mesma coleção sobre o mesmo tópico. Este plugin destina-se a organizar tópicos, não a ser uma espécie de “pasta de favoritos” privada para os usuários.

Tópico do Discourse com Coleção visualizado por um usuário anônimo
Tópico do Discourse com Coleção visualizado por um usuário anônimo1920×1243 155 KB

5 curtidas
6

Plugin atualizado com suporte para Emojis e Quadrados Coloridos na barra lateral!

5 curtidas
7

Isso parece realmente incrível. E documentação absolutamente brilhante - isso tem meu voto para o melhor Plugin documentado em meta.discourse.org!!

Você considerou estender isso para que também cubra listas de tópicos?

Frequentemente, acho que seria muito útil ter uma coleção de links por categoria ou por tag. Um exemplo é uma categoria privada dedicada a um grupo específico, que também usa algumas outras ferramentas (como algumas pastas no Google Docs, um portal do governo local, um canal de chat associado e uma caixa de entrada de grupo). Seria ideal ter controle dos moderadores da categoria sobre isso.

3 curtidas
8

Muito obrigado!

É definitivamente algo que considerei antes, mas não acho que se encaixaria bem com o design atual de ser uma forma orientada pelo usuário para organizar tópicos. Não é ideal para o nível de categoria/tag, pois teria que ser limitado ao controle do moderador. O caso de uso original era cobrir o link de tópicos relacionados grandes demais para 1-2 tópicos, mas pequenos demais para uma tag/categoria.

Fazer com que as listas de tópicos exibam a indexação na barra lateral para categorias pode ser feito através do plugin Discourse Doc Categories, embora com um método de configuração diferente. Definitivamente é um incômodo ter que ter dois plugins fazendo duas coisas muito semelhantes, mas acho que a filosofia original para cada um é diferente o suficiente para justificar as abordagens separadas.

Adicionar uma extensão de compatibilidade para o Private Topics Plugin é uma ideia muito legal do ponto de vista do usuário. Terei que considerar isso…

Isso deixa apenas o nível por tag. Fazer um PR para o Discourse Doc Categories (ou criar um novo plugin/TC) para tags é uma opção, mas não está ativamente em minha mente. Talvez no futuro.

9

Na verdade, isso provavelmente funcionaria bem para o meu caso de uso. Não tenho certeza se é adaptável o suficiente para isso, no entanto (vou brincar com isso mais tarde esta semana).

Parece muito interessante. Que caso de uso você tem em mente?

10

Para usuários regulares, a categoria com Tópicos Privados ativados exibiria apenas seus próprios tópicos. Então, eu poderia ver este sendo um dos poucos lugares onde permitir que o plugin Collections eleve uma coleção do nível de tópicos para o nível de categoria por usuário faz sentido.

O fórum do qual faço parte realmente tem uma categoria privada para os usuários usarem como um campo pessoal de rascunho/teste. E eles criam muitos tópicos, então a organização de tópicos impulsionada pelo usuário às vezes acontece aqui.

11

Eu realmente esperava que fosse um sistema de coleção onde os usuários pudessem criar categorias e colocar tópicos de sua escolha, como uma galeria. Ah, bem.

12

Como isso não é aquilo?

1 curtida
13

Minha suposição é que você não pode criar categorias.

14

Eu realmente aprecio a interface de arrastar e soltar deste Plugin para criar sequências arbitrárias de Tópicos, como capítulos de um livro, que podem ser facilmente reorganizadas.

Iniciei um Componente de Tema para adicionar navegação sequencial para Coleções, como \text{<kbd>}\text{< Anterior}\text{</kbd>} e \text{<kbd>}\text{Próximo >}\text{</kbd>} e Paginação em um Modal…

Aqui está meu repositório de trabalho

3 curtidas
15

Muito necessário, estou analisando isso hoje e este era o último componente que parecia precisar.

@Alteras Estou com um bug no X de fechar do modal no modal “Criar Coleções”. É possível passar o mouse e clicar, mas ele não fecha o modal até que a página seja atualizada.

1 curtida
16

Oooo, este é um conceito legal. Eu adoro o modal para visualização rápida dos diferentes tópicos vinculados. Também ajuda a informar os usuários que existe uma coleção para aqueles que não têm/mantêm a barra lateral aberta 24 horas por dia, 7 dias por semana.

Estou curioso sobre a decisão de trocar o conteúdo da postagem em vez de apenas redirecionar o usuário para o tópico.

Eu realmente gosto da ideia de usar < Prev e Next > acima da linha do tempo para navegar entre os tópicos sem precisar da barra lateral. Talvez pudesse ser com a linha do tempo como o toc, para que possa ser facilmente acessado em tópicos longos com a primeira postagem sem ter que rolar para cima… Ou talvez apenas decorar a postagem superior/inferior…

Se você estiver de acordo, eu gostaria de explorar a adição de algumas dessas ideias diretamente ao plugin, talvez com configurações de site extras para administradores. Claro que não tenho objeção em ter um TC construído a partir do plugin, mais personalização para os usuários. Me avise se precisar de ajuda com seu TC. Você deve ser capaz de obter as informações da coleção atualmente exibidas do serviço ember service:collection-sidebar sem ter que analisar o DOM.

Hmm… isso é realmente estranho. Não consigo replicar. Recentemente fiz algumas alterações atualizando o plugin para resolver alguns problemas de depreciação, então isso pode ter afetado? Por favor, verifique se o plugin está atualizado. Por favor, compartilhe também os detalhes da sua configuração (navegador, celular/desktop, versão do discourse).

2 curtidas
17

Estou desatualizado, talvez seja por isso. Eu ainda estava no commit de 6 de novembro.
ETA: Ignore, a atualização resolveu.

1 curtida
18

Eu gosto da rapidez. Não é um design fundamentado.

Como a ordenação arbitrária de itens é a oportunidade aqui, onde o sequenciamento não está decididamente atrelado a nenhuma linha do tempo, meu objetivo inicial é reutilizar os comportamentos de menu de rolagem horizontal aninhados do núcleo, como temos na exibição de Perfis de Usuário, por exemplo, onde, abaixo do Título da Coleção (estacionário) e da Descrição (se/quando presente), há duas linhas de rolagem/deslizamento horizontal – Cabeçalhos de Seção e seus Tópicos Associados abaixo deles.

multilevel-horizontal-swiping
multilevel-horizontal-swiping648×169 16.3 KB

Também dentro do modal há uma exibição vertical recolhível (desliza rapidamente para dentro/fora da esquerda) replicando o comportamento da barra lateral esquerda fora do modal.
…

Por favor, Vá em Frente!

2 curtidas
19

Agora que está funcionando (obrigado pelo aviso sobre a atualização acima), algumas coisas que descobri:

  1. O botão Coleções fica visível mesmo quando o usuário não faz parte dos grupos permitidos. Isso resulta em um Erro Interno do Servidor (exibido de forma elegante em uma barra vermelha no modal) ao tentar criar uma coleção.
  2. Na barra lateral de coleções, o botão na parte inferior oferece a opção original Criar Coleção. É preciso usar o botão na postagem original para gerenciá-la; seria muito útil ter uma opção Gerenciar imediatamente a partir do botão na barra lateral da coleção.
  3. Seria possível separar as permissões de Coleção e Subcoleção? Subcoleções poderiam ser imensamente úteis para indivíduos que gostariam de reunir tópicos por conta própria, sem o impacto generalizado que uma Coleção tem em todos os tópicos vinculados.

Por último, como este plugin lida com duas coleções vinculando o mesmo tópico? Duas subcoleções? Isso me inclina mais para a sugestão nº 3 para facilitar o gerenciamento de objetivos sobrepostos para usuários que gostam do recurso de coleções.

EDIT: Percebi que o nº 1 é um erro relacionado à modificação de Coleção por grupos permitidos que permitem tópicos não pertencentes ao usuário. Ainda assim, uma mensagem de erro melhor poderia ser útil!

1 curtida
20

Portanto, a configuração modificação de coleção por grupos permitidos destina-se à equipe e a usuários altamente privilegiados, ou seja, ajudantes que mantêm wikis. Embora pareça que terei que corrigir os erros.

Desde que a modificação de coleção por grupos permitidos esteja configurada adequadamente alta, coleções e subcoleções só devem ser criadas/modificadas pelo proprietário do tópico (e equipe). Os proprietários de tópicos devem poder adicionar usuários comuns como mantenedores a coleções ou subcoleções, que podem então adicionar seus próprios tópicos. Não tenho certeza de quais são suas configurações para justificar a separação delas.

Duas coleções não podem vincular ao mesmo tópico. Um erro deve ser exibido ao tentar vincular um tópico que já está em uma coleção. Da mesma forma, apenas uma subcoleção é permitida por tópico. Isso ocorre porque as coleções são todas públicas e devem ser feitas apenas pelos proprietários dos tópicos.

Hmm… Tenho a sensação de que seria melhor criar um plugin separado que seja apenas pastas de favoritos que possam ser visualizados publicamente ou privadamente… “Coleções Pessoais?” “Biblioteca de Favoritos?” “Playlists de Tópicos?” Ou talvez eu apenas expanda este. Mas o código subjacente e a filosofia seriam bem diferentes entre os dois recursos… É um pouco lamentável que o nome “Coleções” seja bastante amplo e possa ser interpretado de várias maneiras.

2 curtidas