Este guia explica como usar strings de consulta para obter visualizações de tópicos filtradas e personalizadas em qualquer site Discourse. As strings de consulta podem ser usadas por todos os usuários para visualizar listas específicas de tópicos, criar links personalizados para listas exclusivas de tópicos e pesquisar tópicos que atendam a critérios específicos.
Nível de usuário necessário: Todos os usuários
As strings de consulta são textos que você pode adicionar ao final da maioria das URLs do Discourse para obter uma visualização personalizada e filtrada de tópicos. Elas podem ser úteis para visualizar listas específicas de tópicos, criar links personalizados para listas exclusivas de tópicos e pesquisar tópicos que atendam a critérios específicos.
Entendendo as strings de consulta
Uma string de consulta é adicionada ao final de uma URL, começando com um ponto de interrogação (?), seguida por parâmetros e seus valores. Por exemplo:
https://meta.discourse.org/?status=open
Nesta URL, ?status=open é a string de consulta.
A lista de tópicos que você vê ao usar strings de consulta ainda será limitada aos tópicos acessíveis pela sua conta de usuário. Nenhuma configuração precisa ser ativada para usar strings de consulta.
Parâmetros de string de consulta disponíveis
Aqui estão os parâmetros de string de consulta que você pode usar em todos os sites Discourse:
Status
Use ?status=_ para exibir tópicos com um status específico:
open: Apenas tópicos abertosclosed: Apenas tópicos fechadosarchived: Apenas tópicos arquivadoslisted: Apenas tópicos listados (visíveis)unlisted: Apenas tópicos não listadosdeleted: Apenas tópicos excluídospublic: Apenas tópicos em categorias públicas (não restritas à leitura)
Pesquisa
Use ?search=_ para criar uma página completa de resultados de pesquisa. Substitua _ pelos seus termos de pesquisa.
Estado
Use ?state=_ para exibir tópicos com um estado específico:
muted: Mostrar tópicos que você silenciounormal: Mostrar tópicos que você definiu como normaistracking: Mostrar tópicos que você está acompanhandowatching: Mostrar tópicos que você está monitorandowatching_first_post: Mostrar tópicos em categorias ou com tags para os quais você está monitorando a primeira postagem
Ordem crescente
Use ?ascending=true para exibir tópicos por data em ordem crescente. O padrão é ordem decrescente.
Ordem
Use ?order=_ para exibir tópicos em ordem decrescente por vários critérios:
likes: Por número de curtidasop_likes: Por curtidas na postagem originalviews: Por visualizaçõesposts: Por número de postagens (respostas)activity: Por data da última atividade (inclui a databumped_at)posters: Por número de participantescategory: Por nome da categoria (Z-A)created: Por data de criação do tópico (tópicos mais recentes primeiro)
Filtros de contagem de postagens
?max_posts=_: Retorna tópicos com contagem de postagens igual ou inferior a_?min_posts=_: Retorna tópicos com contagem de postagens igual ou superior a_
Filtros de idade
?before=_: Retorna tópicos criados há mais de_dias?bumped_before=_: Retorna tópicos atualizados pela última vez há mais de_dias
IDs de tópicos
Use ?topic_ids=_ para exibir uma lista de tópicos com IDs específicos. Aceita uma string separada por vírgulas com IDs de tópicos.
Categoria
Use ?category=_ para exibir uma lista de tópicos para categorias específicas. Aceita uma string separada por vírgulas com números de ID de categoria.
Use ?no_subcategories=true para excluir tópicos de subcategorias ao filtrar por categoria.
Tags
Use ?tags=_ para filtrar tópicos por tags. Por exemplo, https://meta.discourse.org/?tags=how-to mostraria todos os tópicos com a tag how-to.
Use ?match_all_tags=true combinado com ?tags=_ para exigir que os tópicos tenham todas as tags especificadas (em vez de qualquer uma delas).
Use ?no_tags=true para mostrar apenas tópicos que não possuem tags.
Use ?exclude_tag=_ para excluir tópicos com uma tag específica.
Filtro de curtidas
Use ?f=liked para mostrar apenas tópicos nos quais o usuário atual curtiu uma postagem.
Parâmetros específicos de plugins
Alguns plugins adicionam parâmetros de string de consulta adicionais:
Plugin Solved
Se você tiver o plugin Solved instalado:
?solved=yes: Mostrar tópicos resolvidos?solved=no: Mostrar tópicos não resolvidos
Plugin Assign
Se você tiver o plugin Assign instalado:
?assigned=username: Ver todos os tópicos atribuídos a um usuário específico?assigned=*: Ver todos os tópicos atribuídos a todos os usuários?assigned=me: Ver todos os tópicos atribuídos ao usuário atual?assigned=nobody: Ver todos os tópicos não atribuídos
Combinando strings de consulta
Você pode combinar várias strings de consulta usando o símbolo de e comercial (&). Ao usar várias strings de consulta, apenas o primeiro parâmetro precisa do símbolo ?. Por exemplo:
https://meta.discourse.org/?max_posts=1&status=closed
Esta URL mostraria tópicos fechados com apenas uma postagem.
Usando a página de pesquisa avançada
Você também pode usar a página de pesquisa avançada para construir essas URLs com uma interface gráfica e, em seguida, copiar a URL resultante. Observe que alguns filtros de pesquisa podem não funcionar como parâmetros de string de consulta fora do contexto de pesquisa.
