إنشاء رابط لبدء موضوع جديد مع معلومات مُعبأة مسبقًا

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

هناك الكثير من العمل التقني الشاق الذي يحدث هنا مما يجعله غير مقبول قليلاً للبشر؛ أراهن أننا نستطيع إنشاء صفحة ويب “مساعدة” تسمح للناس بإنشاء هذه الروابط بسهولة.

ما يعادل هذا قد يكون مشروعًا صغيرًا رائعًا لشخص ما لتنفيذه:

import urllib

site = 'meta.discourse.org'
title = '''My special checklist'''
category = 'todo'
tags = ['tag1', 'tag2']

template = '''\
# Important!

Do these things:

[ ] thing one
[ ] thing two
'''

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

يطبع هذا الرابط

[MarcP]

@Discourse

ربما

محتمل* - اعتقدت أن المستندات عبارة عن ويكي

[Moin]

@MarcP

اعتقدت أن المستندات كانت ويكي

تم تغيير هذا

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]

شكرا على الفكرة! لقد ألهمتني لإنشاء Prefilled composer link generator

[supermathie (Michael Brown)]

رائع! هذه فكرة تنفيذ رائعة. أحسنت صنعًا!

[fbpbdmin (deepblue)]

سؤال.

لقد قمت بتنفيذ مكون سمة، يحتوي على زر، انقر لفتح نموذج إنشاء موضوع جديد بمحتوى وعنوان مملوءين مسبقًا. مثل هذا

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

إنه يعمل بشكل جيد، يفتح نموذج إنشاء موضوع جديد، ولكن إذا لم أرغب في المتابعة، أنقر على “تجاهل” (Discard)
هذا لا يتجاهل الموضوع، بل يحفظه كمسودة بدلاً من ذلك… بما أنني نقرت على “تجاهل”، لا أريد أن يكون كمسودة، يجب عليّ تنظيف المسودات لاحقًا

أتساءل عما إذا كان هذا متوقعًا عند استخدام عنوان URL لإنشاء موضوع جديد هذا؟
هل هناك طريقة لعدم حفظه كمسودة إذا اخترت تجاهله.

شكراً.

كيفية التكرار:

1. في مكون سمة، أضف زرًا، يتم تعيين مرجعه إلى عنوان URL لإنشاء موضوع جديد كما يلي

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

// عنوان URL لإنشاء موضوع جديد
const createTopicUrl = `https://www.mydomain.com/new-topic?title=${title}&body=${topicBody}`;

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

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

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

// أضف زر "موضوع جديد" إلى واجهة المستخدم
return `<li class="news-item"><hr>
<div class="news-title"><a href="${url}" target="_blank">${title}</a></div>${meta}${description}</li>`;

2. انقر على زر “موضوع جديد”، وشاهد نموذج الموضوع الجديد مفتوحًا بعنوان ومحتوى مملوءين مسبقًا.
3. انقر على تجاهل (Discard)، وقم بالتأكيد
4. تحقق من “مشاركاتي”، فإنه يحتوي على مسودة جديدة لهذا الموضوع الذي تم تجاهله..

[NateDhaliwal]

لا يبدو أنني أستطيع تكرار هذا هنا على ميتا. هل يحدث هذا في الوضع الآمن؟ ما هو إصدار مثيلك؟ شكرًا لك.

[fbpbdmin (deepblue)]

إصدار نسختي هو 2026.1.0

باستخدام تجربة النظام المضمنة لإنشاء موضوع جديد، إذا تم التخلص منه، فلن يتم حفظه كمسودة.

حالتي هي، ربطت عنوان URL للموضوع الجديد بزر مضاف في مكون سمة.
لست متأكدًا من سبب اختلافه عن التجربة المضمنة…

[fbpbdmin (deepblue)]

مرحباً يا نيت،
شرح لي كوبايلوت هذا أدناه،
إذا كان هذا صحيحًا، أتساءل عما إذا كان يمكننا الحصول على وسيطة في عنوان URL لمنع ذلك، سيكون ذلك رائعًا
قل &auto_save=false
شكرًا لمساعدتك.

نعم، هذا متوقع في ديسكورس (Discourse). إن فتح المؤلف عبر عنوان URL للموضوع الجديد (مع عنوان/نص محدد مسبقًا) ينشئ مسودة بمجرد تهيئة المؤلف. حتى إذا نقرت على “تجاهل” وأكدت، فقد يحتفظ ديسكورس (Discourse) بإدخال مسودة لهذا المسار حتى يمكن استعادة المحتوى لاحقًا. يأتي هذا السلوك من منطق الحفظ التلقائي للمسودة/المؤلف الأساسي، وليس من تنسيق عنوان URL الخاص بك.

إذا كنت ترغب في تجنب المسودات، فستحتاج إلى نهج مخصص (على سبيل المثال، فتح نافذة منبثقة، أو النسخ إلى الحافظة، أو استدعاء واجهة برمجة تطبيقات المؤلف مع تجاوزات مفتاح المسودة)، ولكن عنوان URL للموضوع الجديد العادي سيشغل دائمًا الحفظ التلقائي للمسودة.

[NateDhaliwal]

لست متأكدًا مما إذا كان هذا دقيقًا . لا يمكنني إعادة إنتاج هذا في الوضع الآمن هنا على ميتا. أعتقد أنك تستخدم الإصدار المستقر/ESR لمنتدىك؟