Este guia fornece uma visão geral abrangente dos recursos de pesquisa do Discourse, incluindo filtros, opções e técnicas avançadas.
Nível de usuário necessário: Todos os usuários
O Discourse oferece uma poderosa funcionalidade de pesquisa com inúmeros filtros e critérios. Ao usar o formulário de pesquisa avançada, ele anexa automaticamente a sintaxe relevante à sua consulta. Por exemplo, selecionar [x] Em minhas mensagens adicionará in:personal à sua consulta de pesquisa.
Este guia abrange todas as opções e recursos de pesquisa disponíveis no Discourse e fornece dicas e truques úteis para usar a função de pesquisa.
Filtros
O Discourse fornece uma ampla gama de filtros para ajudá-lo a refinar seus resultados de pesquisa. Aqui está uma lista abrangente de filtros disponíveis:
| Sintaxe | Descrição |
|---|---|
in:personal-direct |
Retorna postagens em mensagens pessoais apenas entre dois usuários |
in:all-pms |
 Apenas para administradores Retorna postagens de todas as mensagens pessoais, incluindo aquelas das quais você não faz parte |
in:all |
Retorna postagens de tópicos públicos e mensagens pessoais |
in:tagged |
Retorna postagens de tópicos que têm pelo menos uma tag |
in:untagged |
Retorna postagens de tópicos sem tags |
in:seen |
Retorna postagens que você viu (para usuários logados) |
in:unseen |
Retorna postagens que você não viu (para usuários logados) |
in:wiki |
Retorna postagens wiki |
in:watching |
Retorna postagens de tópicos que você está assistindo |
in:tracking |
Retorna postagens de tópicos que você está acompanhando |
posts_count:X |
Retorna postagens de tópicos que têm exatamente X postagens |
min_posts:X |
Retorna postagens de tópicos com pelo menos X postagens |
max_posts:X |
Retorna postagens de tópicos com no máximo X postagens |
min_views:X |
Retorna postagens de tópicos com pelo menos X visualizações |
max_views:X |
Retorna postagens de tópicos com no máximo X visualizações |
badge:name_or_id |
Retorna postagens vinculadas à concessão de um distintivo específico |
created:@username |
Retorna postagens de tópicos criados por username |
group:group_name |
Retorna postagens de usuários dentro do grupo group_name |
group_messages:group_name |
Retorna postagens de mensagens pessoais enviadas para o grupo group_name |
personal_messages:username |
Apenas para administradores Retorna postagens de mensagens pessoais do usuário especificado |
-tags:tag1,tag2,tag3 |
Retorna postagens não marcadas com tag1, tag2 ou tag3 |
filetypes:ext1,ext2,ext3 |
Retorna postagens com uploads das extensões de arquivo ext1, ext2 ou ext3 |
categories:category1,category2 |
Retorna postagens das categorias category1 e category2 |
status:open |
Retorna postagens de tópicos que não estão fechados ou arquivados |
status:closed |
Retorna postagens de tópicos fechados |
status:archived |
Retorna postagens de tópicos arquivados |
status:noreplies |
Retorna postagens de tópicos sem respostas |
status:single_user |
Retorna postagens de tópicos com postagens de apenas um usuário |
status:public |
Retorna postagens de tópicos em categorias públicas |
before:YYYY-MM-DD |
Retorna postagens criadas antes da data especificada |
after:YYYY-MM-DD |
Retorna postagens criadas após a data especificada |
with:images |
Retorna postagens contendo imagens |
Ordem
Você pode classificar seus resultados de pesquisa usando as seguintes opções de ordem:
| Sintaxe | Descrição |
|---|---|
order:latest |
Classifica os resultados do mais novo para o mais antigo (atalho: l) |
order:oldest |
Classifica os resultados do mais antigo para o mais novo |
order:latest_topic |
Classifica os resultados por data do tópico, do mais novo para o mais antigo |
order:oldest_topic |
Classifica os resultados por data do tópico, do mais antigo para o mais novo |
order:views |
Classifica os resultados pelo número de visualizações |
order:likes |
Classifica os resultados pelo número de curtidas |
order:read |
(apenas logado) classifica pela data em que você visitou o tópico pela última vez (atalho: r) |
Aliases
O Discourse fornece vários aliases para facilitar a pesquisa:
| Sintaxe | Equivalente |
|---|---|
l |
order:latest |
in:personal |
in:messages |
min_post_count: |
min_post: |
in:mine |
in:created |
category: |
categories: |
# |
Pode ser usado para categorias e tags, dependendo do contexto |
user: |
@ |
@me |
@your_own_username |
f |
in:first |
t |
in:title |
Pesquisando Palavras Exatas
O Discourse usa uma técnica chamada Stemming para encontrar palavras relacionadas. Embora isso seja frequentemente útil, pode haver momentos em que você deseja pesquisar uma palavra exata. Você pode fazer isso envolvendo sua palavra com espaços e aspas duplas, assim: \" termo \".
Isso garante que ele pesquise apenas a palavra “termo” e exclua outras palavras relacionadas.
Exemplo: Pesquisando por @menções
Atualmente, a pesquisa por @menções não é diretamente suportada. No entanto, você pode conseguir isso usando o método de pesquisa de palavra exata:
https://meta.discourse.org/search?q=“%20%40username%20”
%20é como os espaços são codificados em URLs e%40é como o símbolo@é codificado.
Essa consulta procurará especificamente por @username (entre aspas e espaços).
Combinando Opções de Pesquisa
Você pode combinar várias opções de pesquisa para criar consultas mais específicas. Por exemplo:
-
status:open category:support tag:urgent after:2023-01-01 order:latest
Isso pesquisará tópicos de suporte abertos marcados como urgentes, criados após 1º de janeiro de 2023 e classificará os resultados pela postagem mais recente. -
@jane_doe in:watching min_posts:5 with:images
Isso pesquisará postagens de Jane Doe em tópicos que você está assistindo, com pelo menos 5 postagens e contendo imagens.
Permissões e Limitações
Algumas opções de pesquisa avançada podem exigir certas permissões de usuário ou podem ser limitadas a funções de usuário específicas. Por exemplo:
in:all-pmsestá disponível apenas para administradores, não para usuários regulares ou moderadores.personal_messages:usernameestá disponível apenas para administradores.
Sempre considere sua função de usuário e permissões ao usar opções de pesquisa avançada.
Alternativa de Pesquisa: Filtro de Lista de Tópicos
Um recurso experimental de /filter está disponível que suporta muitos tipos de filtro. Você pode aprender mais no tópico oficial: Experimental topics list filter feature
Arquivos Fonte
Para uma visão mais técnica dessas opções, todos os filtros e parâmetros de pesquisa podem ser encontrados em search.rb - procure pelos métodos advanced_filter.
Dicas Adicionais
-
Você também pode pesquisar menções de tags como Bug https://meta.discourse.org/search?q=“%20%23bug”
-
Alguns filtros podem ser adicionados por plugins. Por exemplo, o plugin Solved adiciona:
status:solved: Retorna postagens de tópicos resolvidosstatus:unsolved: Retorna postagens de tópicos não resolvidos em categorias que permitem marcação como resolvido
-
O plugin Topic Voting adiciona uma opção de ordem adicional:
order:votes: Classifica os resultados pelo número de votos no tópico que contém a postagem
Dedique algum tempo para experimentar diferentes combinações de filtros e opções para encontrar a estratégia de pesquisa mais eficaz para suas necessidades.
