|||
|—|—|—|
|:discourse2: | Resumo | Discourse Templates permite a criação de modelos de conteúdo para uso repetido. Os modelos são armazenados como tópicos em uma categoria especial, onde podem ser editados e discutidos conforme necessário. |
|:open_book: | Guia de Instalação | Este plugin está incluído no núcleo do Discourse. Não é necessário instalar o plugin separadamente.
Este plugin é praticamente uma nova versão do Discourse Canned Replies, mas é mais flexível e armazena os modelos de uma maneira diferente.
Funcionalidades
Este plugin usa uma ou mais categorias para armazenar os modelos para uso posterior. O primeiro post de cada tópico nessas categorias será usado como modelo para as respostas.
Essa abordagem oferece muito mais funcionalidade do que o discourse-canned-replies oferecia antes, pois cada modelo terá histórico de edição, poderá ter tags associadas e os posts subsequentes poderão ser usados para discutir o conteúdo do modelo, se necessário.
Apenas tópicos visíveis serão usados como modelos, portanto, tópicos não listados e arquivados não serão exibidos.
O plugin também aproveita as configurações de segurança das categorias para verificar quais usuários podem usar os modelos. Se o usuário puder ler os tópicos na categoria, a opção “inserir modelos” no compositor estará disponível para uso. O usuário só poderá ver os modelos/tópicos nas categorias às quais tem acesso.
Múltiplas categorias pai e/ou subcategorias podem ser usadas para fornecer diferentes conjuntos de modelos a serem usados por diferentes grupos de usuários e para organizar os modelos.
Modelos privados
O plugin também suporta modelos privados. Modelos privados são mensagens privadas marcadas como modelos. Essas mensagens estarão disponíveis como modelos apenas para o autor da mensagem.
Mensagens arquivadas não serão listadas como modelos.
Você pode encontrar todos os seus modelos privados em:
/u/{NOME-DO-USUÁRIO}/messages/tags/{TAG-DO-MODELO-PRIVADO}
Configurações:
discourse templates enabled: Ativa o plugindiscourse templates categories: Categorias usadas para armazenar os modelos. Cada tópico nessas categorias e suas subcategorias será usado como modelo e estará disponível para usuários que puderem vê-los em suas categorias originais.discourse templates enable private templates: Habilita o uso de modelos privados.discourse templates groups allowed private templates: Grupos de usuários permitidos a usar modelos privados.
Membros da equipe sempre são permitidos.
discourse templates private templates tags: Tags que serão usadas para marcar mensagens privadas como modelos.
Como usar
Após instalar o plugin, você precisará criar pelo menos uma categoria para armazenar os modelos.
Observe que todo usuário que tiver acesso para ler os tópicos nesta categoria poderá usar a funcionalidade do plugin no compositor.
Tornar novos tópicos wikis por padrãonas configurações da categoria.
Depois, especifique a categoria nas configurações do plugin.
É isso. Agora você só precisa criar alguns tópicos na categoria especificada e eles estarão disponíveis para uso como modelos.
Se desejar, você pode criar subcategorias para organizar melhor os modelos ou para fornecer diferentes conjuntos de respostas para vários grupos de usuários.
Para inserir modelos, você deve primeiro abrir o compositor de respostas e clicar no botão de extras, depois selecionar a opção “Inserir modelo”.
Selecione o modelo desejado, você pode pesquisar por texto ou tags e clicar no ícone “colar”.
Atalho de teclado
Você pode usar Ctrl+Shift+I em PCs ou ⌘+Shift+I em Macs para inserir modelos.
Modelos privados
Você precisa configurar as seguintes configurações do Discourse para que funcione:
tagging enabled: deve estar habilitado.enable personal messages: deve estar habilitado se você quiser disponibilizar o recurso para usuários não-staff.pm tags allowed for groups: você precisará permitir que os grupos que usarão modelos privados marquem mensagens privadas.
Para usar modelos privados, você deve primeiro habilitá-lo nas configurações, atribuir os grupos de usuários que podem usá-lo e atribuir pelo menos uma tag para marcar as PMs como modelo.
Para criar um modelo pessoal, os usuários devem:
- enviar uma mensagem pessoal não criptografada para si mesmos marcada com uma das tags configuradas nas configurações do plugin. Apenas o autor da mensagem a verá como um modelo privado.
Variáveis pré-preenchidas
O plugin suporta as seguintes variáveis nos modelos:
my_usernamemy_nametopic_titletopic_urloriginal_poster_usernameoriginal_poster_namereply_to_usernamereply_to_namelast_poster_usernamereply_to_or_last_poster_username.
Todas as variáveis acima suportam texto de fallback e removerão a variável se o fallback não for especificado e a variável não puder ser substituída.
Tanto o título quanto o corpo suportam substituição de variáveis.
Exemplo:
Olá %{reply_to_username,fallback:lá},
...
Atenciosamente,
%{my_name}
Se o reply_to_username não estiver disponível, o modelo será:
Olá lá,
...
Atenciosamente,
Arpit Jalan
Migração de discourse-canned-replies
Existe uma tarefa rake para migrar as respostas prontas existentes para modelos:
rake "discourse-templates:migrate-from-canned-replies"
Isso levou apenas alguns segundos para ser executado no Meta para migrar 47 respostas prontas, portanto, deve ser seguro de usar, a menos que você tenha uma quantidade enorme de respostas prontas.
A FAZER
estender a funcionalidade para outros lugares além do compositor
permitir o uso de mais de uma categoria pai como fontes de modelos
Changelog
- 2022-07-14T03:00:00Z: Adicionada a capacidade de usar várias categorias pai como fonte para modelos
- 2022-07-18T03:00:00Z: Modelos privados
- 2022-08-10T03:00:00Z: Atalho de teclado global
Este plugin agora está incluído no core do Discourse como parte de