يصف هذا الدليل كيفية إنشاء رابط لبدء رسالة شخصية جديدة بمعلومات مملوءة مسبقًا، بما في ذلك أفضل الممارسات.
مستوى المستخدم المطلوب: جميع المستخدمين
يتيح لك Discourse إنشاء رسالة شخصية جديدة بمعلومات مملوءة مسبقًا عبر معلمات URL. يمكن أن يوفر هذا الوقت ويضمن الاتساق للرسائل الشائعة.
هيكل عنوان URL
لإنشاء رسالة جديدة مملوءة مسبقًا، قم بتهيئة عنوان URL الخاص بك بهذا الشكل:
https://discourse.example.com/new-message?username=techapj&title=message%20title&body=message%20body
عند تفكيكها، تتضمن معلمات عنوان URL ما يلي:
- عنوان URL الأساسي:
https://discourse.example.com/new-message - اسم المستخدم:
username=techapj - العنوان:
title=message%20title - النص الأساسي:
body=message%20body - عامل تشغيل
؟في عنوان URL لإضافة الخيارات المختلفة
يمكنك تجربة هذا على try.discourse.org:
https://try.discourse.org/new-message?username=rudy&title=message%20title&body=message%20body
يمكنك أيضًا إنشاء رسالة مملوءة مسبقًا لمجموعة عبر عنوان URL:
https://meta.discourse.org/new-message?groupname=team&title=topic%20title&body=topic%20body
لاحظ المعلمة groupname في عنوان URL أعلاه، وهذا يعني أنك تريد إنشاء رسالة جديدة مملوءة مسبقًا لمجموعة (على عكس username لإنشاء رسالة لمستخدم). يمكنك أيضًا استخدام group_name كبديل لـ groupname.
العلامات (Tags)
يمكنك ملء العلامات مسبقًا في رسالة شخصية عن طريق إضافة المعلمة tags:
https://discourse.example.com/new-message?username=techapj&title=Bug%20Report&body=Details&tags=tag1,tag2
يتطلب هذا إعداد الموقع pm_tags_allowed_for_groups ليشمل المجموعات التي ينتمي إليها المستخدم. إذا لم يكن وضع العلامات للرسائل الخاصة ممكنًا للمستخدم، فسيتم تجاهل المعلمة tags بصمت.
أفضل الممارسات
-
يمكنك إرسال رسالة إلى مستخدمين متعددين عن طريق فصل أسماء المستخدمين بفواصل. على سبيل المثال
https://meta.discourse.org/new-message?username=foo,bar -
لست بحاجة إلى ملء جميع المعلمات. على سبيل المثال، أي مما يلي سيعمل:
https://meta.discourse.org/new-message https://meta.discourse.org/new-message?username= https://meta.discourse.org/new-message?title=foo&body=bar https://meta.discourse.org/new-message?groupname= -
يمكنك إضافة مسافات أسطر باستخدام الرمزين %0A و %0A%0D لإعطاء بعض الهيكلة لنص الرسالة:
https://yoursite.discourse.org/new-message?username=test_user&title=Bug%20Report&body=Please%20include%20all%20relevant%20details.%0A%0DCPU:%0AMemory:%0A%0DDescribe%20Issue: -
إذا كان لديك DiscourseConnect (SSO)، يمكنك الارتباط بـ
example.com/session/ssoثم تعيين مسار العودة لإنشاء الرسالة الشخصية. إذا كان المستخدم قد سجل الدخول بالفعل، فسيتم إعادة توجيهه تلقائيًا إلى عنوان URL الذي يوفره مسار العودة. إذا لم يكن قد سجل الدخول، فسيتم نقله إلى صفحة تسجيل الدخول DiscourseConnect ثم إعادة توجيهه إلى عنوان URL لمسار العودة. ستحتاج إلى ترميز مسار العودة لعنوان URL.href="http://localhost:3000/session/sso?return_path=http%3A%2F%2Flocalhost%3A3000%2Fnew-message%3Fusername%3Dscossar%26title%3DInformation+requested+about+gentle+yoga+classes">
غير مدعوم حاليًا
- استخدام عنوان URL المملوء مسبقًا لتكوين رسالة إلى مجموعات متعددة.
- استخدام عنوان URL المملوء مسبقًا لفتح أداة الإنشاء في صفحة ملخص المستخدم.
- استخدام البريد الإلكتروني بدلاً من اسم المستخدم لملء رسالة شخصية مسبقًا.