Créer un lien pour démarrer un nouveau sujet avec des informations pré-remplies

[Discourse]

This documentation explains how to create a link that starts a new topic in Discourse with pre-filled information.

Required user level: All users

Sometimes you may want to provide users with a link that opens a new topic composer with certain information pre-filled. This can be useful for various use cases including bug report templates, feature requests, or standardized posts.

Constructing the URL

Base URL

To compose a new pre-filled topic with no extra information, you append /new-topic to your site URL, like so:

https://discourse.example.com/new-topic

Clicking on this will open up a blank new topic composer for any logged-in user (if not logged-in, you’ll be prompted to signin/signup before then opening the composer).

Additional Parameters

While a link to open a blank composer can sometimes be useful, the main strength of this feature is the ability to pre-fill the composer with extra information.

To do this, you can add parameters to the base URL:

https://discourse.example.com/new-topic?title=topic%20title&body=topic%20body&category=category/subcategory&tags=email,planned

This will open a composer window pre-filled with topic title, body, category and tags.

Breaking down the link / URL to show the available options, we have:

• Base URL: https://discourse.example.com/new-topic
• The ? URL operator to add the different options
• Topic title: title=topic%20title
• The &, used each time when including another parameter
• Body: body=topic%20body
• The category and subcategory separated by a slash / if you want to include them: category=category/subcategory
• The tags separated by comma(s) , if you want to include multiple tags: tags=email,planned

Each of the parameters is optional and can be mix and matched depending on your desired end result.

As an alternative to using the category/subcategory name, you can specify a numeric category_id instead, like:

https://meta.discourse.org/new-topic?title=topic%20title&category_id=3

Example

You can try this here on Meta:

https://meta.discourse.org/new-topic?title=topic%20title&body=topic%20body&category=support/wordpress&tags=wordpress

https://meta.discourse.org/new-topic?title=topic%20title&body=topic%20body&category=support/wordpress&tags=wordpress

Though please don’t actually create the topic For a more hands-on explore of the feature use our demo site, try.discourse.org

Using a pre-filled URL with Featured Links

This feature also supports Featured Links, provided that the body parameter is not also included.

The URL must be URL encoded for the link to work.

For example, to create a topic with the following URL https://www.xkcd.com/556, the link will be:

https://meta.discourse.org/new-topic?title=https%3A%2F%2Fwww.xkcd.com%2F556

Best Practices

• w3Schools HTML URL Encoding Reference is a good resource to find what text characters are encoded as in the URL. If you have a lot of text to add, there is also a text-to-URL converter in the ‘Try It Yourself’ section.
• Always URL encode the parameters to avoid issues with special characters.
• If you’re unsure about the category ID, you can check it by looking at the number in the category URL. (eg. https://meta.discourse.org/c/documentation/using-discourse/126)
• Test the pre-filled links to ensure they work as expected.

It is not currently possibly to have a pre-filled link that opens a composer to reply to a specific topic.

Additional Resources

• Creating pre-filled personal message links

[supermathie (Michael Brown)]

Il y a BEAUCOUP de travail technique lourd qui se déroule ici, ce qui rend cela un peu inacceptable pour les mortels ; je parie que nous pourrions créer une page Web « d’aide » qui permettrait aux gens de générer facilement ces liens.

L’équivalent de ceci pourrait être un petit projet astucieux à implémenter :

import urllib

site = 'meta.discourse.org'
title = '''Ma liste de contrôle spéciale'''
category = 'todo'
tags = ['tag1', 'tag2']

template = '''\
# Important !

Faites ces choses :

[ ] chose un
[ ] chose deux
'''

query = urllib.parse.urlencode(dict(
    title =    title,
    category = category,
    tags =     ','.join(tags),
    body =     template,
))
print(f'https://{site}/new-topic?{query}')

imprime ce lien

[MarcP]

@Discourse

possiblement

possible* - Je pensais que la documentation était un wiki

[Moin]

@MarcP

Je pensais que la documentation était un wiki

Cela a été modifié

Discourse documentation policy

There are two locations for Discourse documentation - one for official content, created and supported by the Discourse team, and one for community-contributed content. Official documentation Documentation is the home for official Discourse documentation. At Discourse, official documentation means the following: It is written by members of the Discourse team. It can only be edited by members of the Discourse team. It is supported by Discourse. It follows (or will be updated to follow) the doc…

[Moin]

Merci pour l’idée ! Elle m’a inspiré à créer Prefilled composer link generator

[supermathie (Michael Brown)]

Oh ! C’est une excellente idée d’implémentation. Bon travail !

[fbpbdmin (deepblue)]

une question.

J’ai implémenté un composant de thème, il contient un bouton, cliquez pour ouvrir le formulaire de nouveau sujet avec un contenu et un titre pré-remplis. comme ceci

https://www.mydomain.com/new-topic?title=${title}&body=${body}

cela fonctionne bien, il ouvre le formulaire de nouveau sujet, mais si je ne veux pas continuer, cliquez sur “Ignorer”
cela n’ignore pas le sujet, cela l’enregistre comme brouillon à la place… puisque j’ai cliqué sur “Ignorer”, je ne veux pas qu’il soit enregistré comme brouillon, je dois nettoyer les brouillons plus tard

je me demande si c’est le comportement attendu en utilisant cette URL de nouveau sujet ?
y a-t-il un moyen de ne pas l’enregistrer comme brouillon si je choisis de l’ignorer.

merci.

comment reproduire :

1. dans un composant de thème, ajoutez un bouton, sa référence est définie sur l’URL de nouveau sujet comme ci-dessous

const topicBody = `.....`;
const title = "....";

// l'URL pour un nouveau sujet
const createTopicUrl = `https://www.mydomain.com/new-topic?title=${title}&body=${topicBody}`;

const createTopicLink = `<span><a href="${createTopicUrl}" rel="noopener noreferrer">nouveau sujet</a></span>`;

const meta = `<div>${publisher}${pub_date} ${createTopicLink}</div>`;

const description = `<p>${description}</p>`;

// ajouter le bouton "nouveau sujet" à l'interface utilisateur
return `<li class="news-item"><hr>
<div class="news-title"><a href="${url}" target="_blank">${title}</a></div>${meta}${description}</li>`;

2. cliquez sur le bouton “nouveau sujet”, voyez le formulaire de nouveau sujet s’ouvrir avec le titre et le contenu pré-remplis.
3. cliquez sur ignorer, confirmez
4. vérifiez “mes messages”, il y a un nouveau brouillon pour ce sujet ignoré..

[NateDhaliwal]

Je n’arrive pas à reproduire cela ici sur Meta. Est-ce que cela se produit en mode sans échec ? Quelle est la version de votre instance ? Merci.

[fbpbdmin (deepblue)]

mon instance est la version 2026.1.0

en utilisant l’expérience intégrée du système pour créer un nouveau sujet, si je l’abandonne, il n’est pas sauvegardé comme brouillon.

mon cas est que j’ai accroché l’URL de nouveau sujet à un bouton ajouté dans un composant de thème.
je ne suis pas sûr pourquoi c’est différent de l’expérience intégrée…

[fbpbdmin (deepblue)]

salut, Nate
copilot a expliqué cela ci-dessous,
si c’est vrai, je me demande si on pourrait avoir un argument dans l’URL pour éviter cela, ce serait super
disons &auto_save=false
merci pour ton aide.

Oui, c’est ce à quoi il faut s’attendre dans Discourse. Ouvrir le compositeur via l’URL new-topic (avec titre/corps pré-remplis) crée un brouillon dès que le compositeur est initialisé. Même si vous cliquez sur « Jeter » et confirmez, Discourse peut toujours conserver une entrée de brouillon pour cette route afin que le contenu puisse être restauré plus tard. Ce comportement provient de la logique d’autosave des brouillons/compositeurs de base, et non de votre format d’URL.

Si vous souhaitez éviter les brouillons, vous auriez besoin d’une approche personnalisée (par exemple, ouvrir une modale, copier dans le presse-papiers ou appeler l’API du compositeur avec des remplacements de clé de brouillon), mais l’URL new-topic simple engagera toujours l’autosave des brouillons.

[NateDhaliwal]

Je ne suis pas sûr que ce soit exact . Je ne peux pas reproduire cela en mode sans échec ici sur Meta. Je crois que vous êtes sur la version stable/ESR de votre forum ?

[fbpbdmin (deepblue)]

salut Nate, oui, je ne suis pas sûr non plus de cette réponse de Gemini.

fait intéressant, je ne peux plus le reproduire aujourd’hui.
mon composant de thème n’a pourtant subi aucun changement dans cette partie.

merci pour ton aide, je posterai si j’ai d’autres découvertes…