هل يمكن أن ينظر عضو من @staff في نقل هذا إلى #customization:theme-component، فأنا غير قادر على إنشاء مواضيع جديدة هناك.
 |
الملخص | يحوّل Discourse Custom Post Button الروابط داخل منشورات Discourse إلى أزرار مصممة. |
 |
المستودع | github.com/koloki-co/discourse-custom-post-button |
 |
دليل التثبيت | تثبيت سمة أو مكوّن سمة |
 |
جديد على سمات Discourse؟ | دليل المبتدئين لاستخدام سمات Discourse |
ثبّت هذا المكوّن السميّ
هذا مكوّن سمة مجتمعي يحافظ عليه Koloki Ltd. إنه ليس مكوّنًا رسميًا من Discourse. إنه في مرحلة ألفا، لذا قد يحتوي على أخطاء. يرجى الإبلاغ عن الأخطاء وطلب الميزات في مستودع GitHub.
لقطات شاشة
الأزرار
حالة استخدام محددة: زر «اسألنا سؤالاً عبر رسالة خاصة»
الميزات
- يحوّل رابطًا عاديًا إلى زر في أي مكان داخل موضوع أو منشور باستخدام
[wrap]. - يوفر إعدادات افتراضية قابلة للتعديل على مستوى المكوّن (TC) للون الخلفية، وزوايا الحواف، والمسافة البادئة، ووزن الخط، ولون النص، وشفافية التحويم، وإلا فإنه يستخدم الإعدادات الافتراضية لموقعك.
- يسمح لزر فردي بتجاوز لون الخلفية الافتراضي.
- يدعم النص التوضيحي بجانب الزر.
- يحافظ على المحتوى الأساسي كرابط عادي، بحيث يمكن للأزرار فتح صفحات خارجية أو مسارات داخلية في Discourse مثل
/new-message.
مهم: إذا تم تثبيت هذا المكوّن السميّ (TC)، فيمكن أي مستخدم في منتداك إنشاء هذه الأزرار. لتقييد قدرة الأزرار على مستخدمين معينين، سيتطلب ذلك إضافة (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 name) بدلاً من «الاسم الكامل» ورمّز قيم المعلمات عبر URL. لا يزال إعداد من يمكنه إرسال رسائل إلى هذه المجموعة؟ للمجموعة يحدد من يمكنه فتح محرر موجه، وسيُطلب من الزوار غير المسجلين تسجيل الدخول.
الإعدادات
| الإعداد | الغرض |
|---|---|
button_default_color |
لون الخلفية والحد الافتراضي للزر |
button_border_radius |
نصف قطر زوايا الزر |
button_padding |
المساحة حول تسمية الزر |
button_font_weight |
وزن تسمية الزر |
button_text_color |
لون تسمية الزر |
button_hover_opacity |
شفافية الزر عند التحويم |
يكشف المكوّن أيضًا عن إعداد svg_icons للأيقونات المتاحة للسمة، لكنه لا يُدرج أيقونة حاليًا في زر المنشور. سأضيف هذه الميزة إذا كان هناك طلب عليها.
ملاحظات
- يغيّر المكوّن العرض فقط. تبقى الأزرار روابط ولا تتغير صلاحيات الوجهة.
- قد تعرض عملاء البريد الإلكتروني وسياقات أخرى لا تحمّل سمة Discourse النشطة الرابط الأساسي دون تنسيق الزر.
- مرخّص المكوّن بموجب رخصة MIT.
نشأ المكوّن من نفس نمط [wrap] المفيد الذي تم نقاشه في كيف تضمين زر في منشور موضوع.
