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

[Discourse]

تشرح هذه الوثائق كيفية إنشاء رابط يبدأ موضوعًا جديدًا في ديسكورس (Discourse) بمعلومات مملوءة مسبقًا.

المستوى المطلوب للمستخدم: جميع المستخدمين

قد ترغب أحيانًا في تزويد المستخدمين برابط يفتح مُنشئ موضوع جديد بمعلومات مملوءة مسبقًا. قد يكون هذا مفيدًا لحالات استخدام مختلفة بما في ذلك قوالب تقارير الأخطاء، أو طلبات الميزات، أو المنشورات الموحدة.

بناء عنوان URL

عنوان URL الأساسي

لإنشاء موضوع جديد مملوء مسبقًا بدون معلومات إضافية، يمكنك إضافة /new-topic إلى عنوان URL الخاص بموقعك، كالتالي:

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

سيؤدي النقر على هذا الرابط إلى فتح مُنشئ موضوع جديد فارغ لأي مستخدم قام بتسجيل الدخول (إذا لم يكن مسجلاً للدخول، سيُطلب منك تسجيل الدخول/الاشتراك قبل فتح المُنشئ).

المعلمات الإضافية

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

للقيام بذلك، يمكنك إضافة معلمات إلى عنوان URL الأساسي:

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

سيؤدي هذا إلى فتح نافذة مُنشئ مملوءة مسبقًا بعنوان الموضوع والنص والفئة والوسوم.

بتقسيم الرابط / عنوان URL لإظهار الخيارات المتاحة، لدينا:

• عنوان URL الأساسي: https://discourse.example.com/new-topic
• عامل تشغيل ? في عنوان URL لإضافة الخيارات المختلفة
• عنوان الموضوع: title=topic%20title
• الرمز &، المستخدم في كل مرة يتم فيها تضمين معلمة أخرى
• النص: body=topic%20body
• الفئة والفئة الفرعية مفصولتان بشرطة مائلة / إذا كنت ترغب في تضمينهما: category=category/subcategory
• الوسوم مفصولة بفاصلة (فواصل) , إذا كنت ترغب في تضمين وسوم متعددة: tags=email,planned

كل معلمة اختيارية ويمكن خلطها ومطابقتها اعتمادًا على النتيجة النهائية المطلوبة.

كبديل لاستخدام اسم الفئة/الفئة الفرعية، يمكنك تحديد category_id رقمي بدلاً من ذلك، مثل:

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

مثال

يمكنك تجربة هذا هنا على 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

على الرغم من ذلك، من فضلك لا تقم بإنشاء الموضوع فعليًا للمزيد من الاستكشاف العملي للميزة، استخدم موقع العرض التجريبي الخاص بنا، try.discourse.org

استخدام أدوات المطور في المتصفح

افتح وحدة تحكم المتصفح (F12 → Console) واستخدم URLSearchParams المضمنة لبناء عنوان URL - حيث يتعامل مع جميع ترميزات النسبة المئوية تلقائيًا:

const base = 'https://discourse.example.com/new-topic';
const url = base + '?' + new URLSearchParams({
  title: 'My topic title',
  body: `Body text here...
supports multi line`,
  category: 'support',
  tags: 'bug,urgent'
});
console.log(url); // انسخ عنوان URL هذا

استخدام رابط مملوء مسبقًا مع الروابط المميزة

تدعم هذه الميزة أيضًا الروابط المميزة، بشرط عدم تضمين معلمة النص (body).

يجب ترميز عنوان URL لكي يعمل الرابط.

على سبيل المثال، لإنشاء موضوع بعنوان URL التالي https://www.xkcd.com/556، سيكون الرابط:

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

أفضل الممارسات

• مرجع ترميز URL لـ HTML الخاص بـ w3Schools هو مصدر جيد للعثور على ترميز أحرف النص في عنوان URL. إذا كان لديك الكثير من النصوص لإضافتها، فهناك أيضًا محول نص إلى عنوان URL في قسم “جربه بنفسك”.
• قم دائمًا بترميز المعلمات لتجنب المشاكل مع الأحرف الخاصة.
• إذا لم تكن متأكدًا من مُعرّف الفئة، يمكنك التحقق منه بالنظر إلى الرقم الموجود في رابط الفئة. (على سبيل المثال، https://meta.discourse.org/c/documentation/using-discourse/126)
• اختبر الروابط المملوءة مسبقًا للتأكد من أنها تعمل كما هو متوقع.

ليس من الممكن حاليًا الحصول على رابط مملوء مسبقًا يفتح مُنشئًا للرد على موضوع معين.

موارد إضافية

• 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}')

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

[Moin]

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

[supermathie (Michael Brown)]

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