 |
ملخص | يحوّل Discourse Custom Post Button الروابط داخل منشورات Discourse إلى أزرار مُنسّقة. |
 |
المستودع | github.com/koloki-co/discourse-custom-post-button |
 |
دليل التثبيت | تثبيت سمة أو مكوّن سمة |
 |
جديد على سمات Discourse؟ | دليل المبتدئين لاستخدام سمات Discourse |
ثبّت مكوّن السمة هذا
هذا مكوّن سمة مجتمعي يُصان من قِبل Koloki Ltd. إنه ليس مكوّنًا رسميًا لـ Discourse. إنه في مرحلة ألفا، لذا قد يحتوي على أخطاء. يرجى الإبلاغ عن الأخطاء وطلب الميزات في مستودع GitHub.
لقطات الشاشة
الأزرار
حالة استخدام محددة: زر «اسألنا سؤالاً عبر رسالة خاصة»
الميزات
- يحوّل رابطًا عاديًا إلى زر في أي مكان داخل موضوع أو منشور باستخدام
[wrap]. - يوفر إعدادات قابلة للضبط على مستوى مكوّن السمة (TC) للون الخلفية الافتراضي، ونصف قطر الحواف، والمساحة البينية، ووزن الخط، ولون النص، وشفافية التحويم، وإلا يستخدم إعدادات الموقع الافتراضية.
- يسمح لزر فردي بتجاوز لون الخلفية الافتراضي.
- يدعم النص التوضيحي بجانب الزر.
- يحافظ على المحتوى الأساسي كرابط عادي، بحيث يمكن للأزرار فتح صفحات خارجية أو مسارات داخلية في Discourse مثل
/new-message.
مهم: إذا تم تثبيت هذا المكوّن، يمكن لأي مستخدم في منتدك إنشاء هذه الأزرار. لتقييد إمكانية إنشاء الأزرار على مستخدمين محددين، سيتطلب ذلك إضافة (Plugin) كاملة. ومع ذلك، في الممارسة العملية، يحتاج المستخدمون إلى معرفة أنه مثبّت وكيفية إنشاء زر، لذا أشك في أن القليل فقط سيعرفون كيفية القيام بذلك. يمكنك أيضًا استخدام كلمات المراقبة لتصفية المنشورات التي تحتوي على
[wrap=custom-button]للموافقة عليها، مما سيقيد هذه الوظيفة.
التثبيت
في الإدارة > المظهر > السمات والمكونات، افتح علامة التبويب المكونات، اختر تثبيت، واختر التثبيت من عنوان مستودع Git. استخدم:
https://github.com/koloki-co/discourse-custom-post-button
بعد التثبيت، أضف المكوّن إلى كل سمة نشطة حيث يجب أن يكون متاحًا.
الاستخدام
زر أساسي
سيتم استخدام لون الزر الافتراضي من إعدادات مكوّن السمة (TC)
[wrap=custom-button][نص زر المخصص](https://example.com)[/wrap]
إعداد اللون لكل زر
[wrap=custom-button color=#7CC146][نص زر المخصص](https://example.com)[/wrap]
زر يتبعه نص توضيحي
[wrap=custom-button][نص زر المخصص](https://example.com)[/wrap]
[wrap=text-after-button]نص إضافي توضيحي[/wrap] (في سطر جديد)
فتح رسالة خاصة لمجموعة
(ملاحظة: هذا يستخدم وظيفة Discourse المدمجة لفتح محرر الكتابة بنص مُعبّأ مسبقًا - هذه часть من الوظيفة ليست من مكوّن السمة، بل أستخدمها فقط لإظهار حالة استخدام محتملة. يتطلب إعدادات المجموعة للسماح بالرسائل الخاصة إلى تلك المجموعة.)
[wrap=custom-button][اسألنا سؤالاً](/new-message?groupname=somegroup&title=Aask%20Us&body=Please%20type%20your%20question%20here.)[/wrap]
استخدم اسم المجموعة المُصيغ (slugified) بدلاً من «الاسم الكامل» ورمّز قيم المعلمات بتشفير URL. لا يزال إعداد من يمكنه إرسال رسالة إلى هذه المجموعة؟ للمجموعة يحدد من يمكنه فتح محرر موجه، وسيُطلب من الزوار غير المسجلين تسجيل الدخول.
الإعدادات
| الإعداد | الغرض |
|---|---|
button_default_color |
لون الخلفية والحد الافتراضي للزر |
button_border_radius |
نصف قطر زوايا الزر |
button_padding |
المساحة حول تسمية الزر |
button_font_weight |
وزن تسمية الزر |
button_text_color |
لون تسمية الزر |
button_hover_opacity |
شفافية الزر عند التحويم |
يكشف المكوّن أيضًا عن إعداد svg_icons للأيقونات المتاحة للسمات، لكنه لا يدرج حاليًا أيقونة في زر المنشور. سأضيف هذه الميزة إذا كان هناك طلب عليها.
ملاحظات
- يغيّر المكوّن العرض فقط. تبقى الأزرار روابط ولا تتغير أذونات الوجهة.
- قد تعرض عملاء البريد الإلكتروني وسياقات أخرى لا تقرأ السمة النشطة لـ Discourse الرابط الأساسي دون تنسيق الزر.
- مرخّص المكوّن بموجب رخصة MIT.
نشأ المكوّن من نفس نمط [wrap] المفيد الذي تمت مناقشته في كيفية تضمين زر في منشور موضوع.
