Esta documentação explica como criar um link que inicia um novo tópico no Discourse com informações pré-preenchidas.
Nível de usuário necessário: Todos os usuários
Às vezes, você pode querer fornecer aos usuários um link que abra um novo editor de tópico com certas informações pré-preenchidas. Isso pode ser útil para vários casos de uso, incluindo modelos de relatório de bug, solicitações de recursos ou postagens padronizadas.
Construindo a URL
URL Base
Para compor um novo tópico pré-preenchido sem informações extras, você anexa /new-topic ao URL do seu site, assim:
https://discourse.example.com/new-topic
Clicar neste link abrirá um editor de novo tópico em branco para qualquer usuário logado (se não estiver logado, você será solicitado a fazer login/se registrar antes de abrir o editor).
Parâmetros Adicionais
Embora um link para abrir um editor em branco possa ser útil às vezes, a principal força deste recurso é a capacidade de pré-preencher o editor com informações extras.
Para fazer isso, você pode adicionar parâmetros à URL base:
https://discourse.example.com/new-topic?title=titulo%20do%20topico&body=corpo%20do%20topico&category=categoria/subcategoria&tags=email,planejado
Isso abrirá uma janela do editor pré-preenchida com o título do tópico, corpo, categoria e tags.
Analisando o link/URL para mostrar as opções disponíveis, temos:
- URL Base:
https://discourse.example.com/new-topic - O operador de URL
?para adicionar as diferentes opções - Título do Tópico:
title=titulo%20do%20topico - O
&, usado cada vez que um parâmetro adicional é incluído - Corpo:
body=corpo%20do%20topico - A categoria e a subcategoria separadas por uma barra
/se você quiser incluí-las:category=categoria/subcategoria - As tags separadas por vírgula(s)
,se você quiser incluir várias tags:tags=email,planejado
Cada um dos parâmetros é opcional e pode ser combinado dependendo do resultado final desejado.
Como alternativa ao uso do nome da categoria/subcategoria, você pode especificar um category_id numérico, como:
https://meta.discourse.org/new-topic?title=titulo%20do%20topico&category_id=3
Exemplo
Você pode tentar isto aqui no Meta:
https://meta.discourse.org/new-topic?title=titulo%20do%20topico&body=corpo%20do%20topico&category=support/wordpress&tags=wordpress
Mas, por favor, não crie o tópico de verdade
Para explorar o recurso de forma mais prática, use nosso site de demonstração, try.discourse.org
Usando DevTools do Navegador
Abra o console do navegador (F12 → Console) e use o URLSearchParams embutido para construir a URL — ele lida com toda a codificação percentual automaticamente:
const base = 'https://discourse.example.com/new-topic';
const url = base + '?' + new URLSearchParams({
title: 'Meu título do tópico',
body: `Texto do corpo aqui...\nsuporta múltiplas linhas`,
category: 'support',
tags: 'bug,urgente'
});
console.log(url); // copie esta url
Usando uma URL pré-preenchida com Featured Links
Este recurso também suporta Featured Links, desde que o parâmetro body não seja incluído.
A URL deve ser codificada em URL para que o link funcione.
Por exemplo, para criar um tópico com a seguinte URL https://www.xkcd.com/556, o link será:
https://meta.discourse.org/new-topic?title=https%3A%2F%2Fwww.xkcd.com%2F556
Melhores Práticas
- O Referência de Codificação de URL HTML do w3Schools é um bom recurso para descobrir como os caracteres de texto são codificados na URL. Se você tiver muito texto para adicionar, há também um conversor de texto para URL na seção ‘Try It Yourself’.
- Sempre codifique as URLs dos parâmetros para evitar problemas com caracteres especiais.
- Se você não tiver certeza sobre o ID da categoria, pode verificá-lo observando o número na URL da categoria. (ex: Using Discourse - Discourse Meta)
- Teste os links pré-preenchidos para garantir que funcionem como esperado.