Erstellen eines Links zum Starten eines neuen Themas mit vorausgefüllten Informationen

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

Hier geschieht eine MENGE technischer Schwerstarbeit, die dies für Sterbliche ein wenig inakzeptabel macht; Ich wette, wir könnten eine “Hilfs”-Webseite erstellen, auf der Leute diese Links einfach generieren könnten.

Das Äquivalent dazu könnte ein nettes kleines Projekt für jemanden sein, das er implementieren kann:

import urllib

site = 'meta.discourse.org'
title = '''Meine spezielle Checkliste'''
category = 'todo'
tags = ['tag1', 'tag2']

template = '''\
# Wichtig!

Mache diese Dinge:

[ ] Ding eins
[ ] Ding zwei
'''

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

druckt diesen Link

[MarcP]

@Discourse

möglicherweise

möglich* - Ich dachte, Dokumente wären ein Wiki :denkend:

[Moin]

@MarcP

Ich dachte, Dokumentationen wären ein Wiki

Das wurde geändert

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]

Danke für die Idee! Sie hat mich dazu inspiriert, Prefilled composer link generator zu erstellen

[supermathie (Michael Brown)]

Oh! Das ist eine großartige Implementierungsidee. Gut gemacht!

[fbpbdmin (deepblue)]

eine Frage.

Ich habe eine Theme-Komponente implementiert, sie hat einen Button, der beim Klicken das Formular zum Erstellen eines neuen Themas mit vorab ausgefülltem Inhalt und Titel öffnet. So wie hier:

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

Es funktioniert gut, es öffnet das Formular zum Erstellen eines neuen Themas, aber wenn ich nicht fortfahren möchte, klicke ich auf „Verwerfen“ (Discard). Dies verwirft das Thema nicht, sondern speichert es stattdessen als Entwurf … Da ich auf „Verwerfen“ geklickt habe, möchte ich nicht, dass es als Entwurf gespeichert wird, ich muss die Entwürfe später bereinigen.

Ich frage mich, ob dies bei Verwendung dieser new-topic-URL erwartet wird? Gibt es eine Möglichkeit, es nicht als Entwurf zu speichern, wenn ich mich entscheide, es zu verwerfen?

Danke.

Wie man reproduziert:

1. Fügen Sie in einer Theme-Komponente einen Button hinzu, dessen Referenz auf die new-topic-URL wie folgt gesetzt ist:

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

// Die URL für ein neues Thema
const createTopicUrl = `https://www.mydomain.com/new-topic?title=${title}&body=${topicBody}`;

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

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

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

// Den "neues Thema"-Button zur UI hinzufügen
return `<li> class="news-item">
<hr>
<div class="news-title"><a href="${url}" target="_blank">${title}</a></div>${meta}${description}</li>`;

2. Klicken Sie auf den „neues Thema“-Button, sehen Sie, dass das Formular für ein neues Thema mit vorab ausgefülltem Titel und Inhalt geöffnet wird.
3. Klicken Sie auf Verwerfen (Discard) und bestätigen Sie.
4. Überprüfen Sie „Meine Beiträge“, es gibt einen neuen Entwurf für dieses verworfene neue Thema…

[NateDhaliwal]

Ich kann das hier auf Meta nicht reproduzieren. Tritt dies im abgesicherten Modus auf? Welche Version hat Ihre Instanz? Danke.

[fbpbdmin (deepblue)]

Meine Instanz ist Version 2026.1.0

Wenn ich die systemeigene Erfahrung nutze, um ein neues Thema zu erstellen, wird es beim Verwerfen nicht als Entwurf gespeichert.

Mein Fall ist, dass ich die new-topic-URL mit einem Button verknüpft habe, der in einer Theme-Komponente hinzugefügt wurde.
Ich bin mir nicht sicher, warum dies von der systemeigenen Erfahrung abweicht…

[fbpbdmin (deepblue)]

Hallo Nate,
Copilot hat dies unten erklärt.
Wenn das wahr ist, frage ich mich, ob wir ein Argument in der URL haben könnten, um dies zu verhindern. Das wäre großartig.
Sagen wir &auto_save=false
Vielen Dank für deine Hilfe.

Ja, das ist in Discourse zu erwarten. Das Öffnen des Komponisten über die URL new-topic (mit vorausgefülltem Titel/Text) erstellt einen Entwurf, sobald der Komponist initialisiert wird. Selbst wenn Sie auf „Verwerfen“ klicken und dies bestätigen, speichert Discourse möglicherweise trotzdem einen Entwurfseintrag für diese Route, damit der Inhalt später wiederhergestellt werden kann. Dieses Verhalten stammt von der Kernlogik zum automatischen Speichern von Entwürfen im Komponisten und nicht von Ihrem URL-Format.

Wenn Sie Entwürfe vermeiden möchten, benötigen Sie einen benutzerdefinierten Ansatz (z. B. ein Modal öffnen, in die Zwischenablage kopieren oder die Composer-API mit Überschreibungen des Entwurfsschlüssels aufrufen), aber die einfache URL new-topic wird immer das automatische Speichern von Entwürfen aktivieren.

[NateDhaliwal]

Ich bin mir nicht sicher, ob das zutreffend ist . Ich kann das im abgesicherten Modus hier auf Meta nicht reproduzieren. Ich glaube, Sie verwenden die stabile/ESR-Version für Ihr Forum?