Creare un link per avviare un nuovo argomento con informazioni precompilate

[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)]

C’è un SACCO di lavoro tecnico pesante che avviene qui che lo rende un po’ inaccettabile per i mortali; scommetto che potremmo creare una pagina web “helper” che permettesse alle persone di generare facilmente questi link.

L’equivalente di questo potrebbe essere un piccolo progetto interessante da implementare per qualcuno:

import urllib

site = 'meta.discourse.org'
title = '''La mia speciale checklist'''
category = 'todo'
tags = ['tag1', 'tag2']

template = '''\
# Importante!

Fai queste cose:

[ ] cosa uno
[ ] cosa due
'''

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

stampa questo link

[MarcP]

@Discourse

possibilmente

possibile* - Pensavo che la documentazione fosse un wiki

[Moin]

@MarcP

Pensavo che la documentazione fosse un wiki

Questo è stato modificato

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]

Grazie per l’idea! Mi ha ispirato a creare Prefilled composer link generator

[supermathie (Michael Brown)]

Oh! È un’ottima idea di implementazione. Buon lavoro!

[fbpbdmin (deepblue)]

una domanda.

Ho implementato un componente tema, ha un pulsante, clicca per aprire il modulo “nuovo argomento” con contenuto e titolo precompilati, così

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

funziona bene, apre il modulo “nuovo argomento”, ma se non voglio continuare, clicco su “Ignora”
questo non scarta l’argomento, lo salva invece come bozza… dato che ho cliccato su “Ignora”, non voglio che rimanga come bozza, devo pulire le bozze più tardi

mi chiedo se questo sia previsto utilizzando questo URL per “nuovo argomento”?
c’è un modo per non salvarlo come bozza se scelgo di ignorarlo.

grazie.

come riprodurre:

1. in un componente tema, aggiungi un pulsante, il suo riferimento è impostato sull’URL del nuovo argomento come segue

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

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

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

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

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

// aggiungi il pulsante "nuovo argomento" all'interfaccia utente
return `<li class="news-item"><hr><div>${title}</div>${meta}${description}</li>`;

2. clicca sul pulsante “nuovo argomento”, vedi il modulo “nuovo argomento” aperto con titolo e contenuto precompilati.
3. clicca su ignora, conferma
4. controlla “i miei post”, ha una nuova bozza per questo argomento “nuovo argomento” scartato..

[NateDhaliwal]

Non riesco a riprodurre questo problema qui su Meta. Succede in modalità provvisoria? Qual è la versione della tua istanza? Grazie.

[fbpbdmin (deepblue)]

La mia istanza è la versione 2026.1.0

utilizzando l’esperienza integrata del sistema per creare un nuovo argomento, se si scarta, non lo salva come bozza.

il mio caso è, ho agganciato l’URL di creazione nuovo argomento con un pulsante aggiunto in un componente del tema.
non sono sicuro del perché sia diverso dall’esperienza integrata…

[fbpbdmin (deepblue)]

ehi, Nate
copilot ha spiegato questo di seguito,
se questo è vero, mi chiedo se si possa avere un argomento nell’URL per evitarlo, sarebbe fantastico
tipo &auto_save=false
grazie per il tuo aiuto.

Sì, questo è previsto in Discourse. L’apertura del compositore tramite l’URL new-topic (con titolo/corpo precompilati) crea una bozza non appena il compositore è inizializzato. Anche se fai clic su “Ignora” e confermi, Discourse potrebbe comunque conservare una voce di bozza per quella rotta in modo che il contenuto possa essere ripristinato in seguito. Questo comportamento deriva dalla logica di salvataggio automatico della bozza del compositore principale, non dal formato del tuo URL.

Se vuoi evitare le bozze, avresti bisogno di un approccio personalizzato (ad esempio, aprire un modale, copiare negli appunti o chiamare l’API del compositore con override della chiave di bozza), ma l’URL new-topic semplice attiverà sempre il salvataggio automatico della bozza.

[NateDhaliwal]

Non sono sicuro che sia accurato . Non riesco a riprodurre questo in modalità sicura qui su Meta. Credo che tu stia utilizzando la versione stabile/ESR per il tuo forum?

[fbpbdmin (deepblue)]

ciao Nate, sì, anch’io non sono sicuro di quella risposta di Gemini.

interessante, non riesco più a riprodurlo oggi. il mio componente tema non ha modifiche in quella parte però.

grazie per il tuo aiuto, pubblicherò se ci saranno altre scoperte…