تشرح هذه الدليل كيفية تخصيص الرموز التعبيرية (الإيموجي) على موقع Discourse الخاص بك من خلال مجموعات الرموز التعبيرية القابلة للاختيار، ورفع رموز جديدة، وتكوين إعدادات الموقع، وتعديل أحجام الرموز التعبيرية.
مستوى المستخدم المطلوب: مسؤول
اختيار مجموعة الرموز التعبيرية
يدعم Discourse حاليًا خمس مجموعات من الرموز التعبيرية:
- Fluent UI
- Noto
- OpenMoji
- Twemoji
- Standard (Unicode)
لمحة عامة حول مظهر المجموعات المختلفة، يمكنك الاطلاع على مقارنة مجموعات الرموز التعبيرية هذه. يمكنك تكوين إعداد الموقع emoji_set في /admin/config/emoji/settings جنبًا إلى جنب مع إعدادات أخرى تتعلق بالرموز التعبيرية.
إضافة رموز تعبيرية مخصصة
لإضافة رموز تعبيرية مخصصة:
-
انتقل إلى Admin → Appearance → Emoji في
/admin/config/emoji -
انقر على زر Add emoji لتسمية وتصنيف ورفع صورة الرمز التعبيري الخاص بك
إذا كان لديك ملفات رموز تعبيرية متعددة للرفع، يمكنك تحديد ما يصل إلى 10 ملفات صورة في منتقي الملفات للرفع الجماعي. سيتم استخدام أسماء ملفات الصور كأسماء للرموز التعبيرية في هذه الحالة.
الاستيراد الجماعي للرموز التعبيرية المخصصة
يمكنك استيراد ما يصل إلى 1000 رمز تعبيري عبر ملف ZIP واحد يحتوي على فهرس emojis.csv. يجب أن يحتوي ملف CSV على الأعمدة التالية مع العناوين: name، group، filename.
name,group,filename
emoji_a,group_name,image.png
تعتمد عملية الاستيراد بالكامل على الفهرس. إذا كان الملف أو الصف مفقودًا، سيتم تخطيه. يمكن ترك حقل group فارغًا، وفي هذه الحالة سيتم إضافة الرمز التعبيري المخصص إلى مجموعة default.
للاستيراد:
-
انتقل إلى Admin → Appearance → Emoji في
/admin/config/emoji -
انقر على زر Import، وحدد ملف ZIP الذي يحتوي على رموزك التعبيرية.
-
معاينة الاستيراد وتأكيد التغييرات. يمكنك حل أي تعارضات هنا عن طريق تحديد الرموز التعبيرية التي تريد الاحتفاظ بها. قد تحدث التعارضات إذا كان هناك رمز تعبيري موجود مسبقًا بنفس الاسم (ومجموعة/صورة مختلفة). لإكمال الاستيراد، انقر على Confirm import.
التصدير الجماعي للرموز التعبيرية المخصصة
يمكن تصدير الرموز التعبيرية المخصصة في ملف ZIP واحد. سيحتوي ملف ZIP الناتج على فهرس emojis.csv، جاهز للاستيراد إلى أي موقع Discourse دون تعديل. يحتوي هذا على الصورة، والاسم، ومجموعة كل رمز تعبيري.
للتصدير، انقر على زر Select to export، وحدد جميع الرموز التعبيرية التي تقوم بتصديرها. عندما تكون جاهزًا، انقر على زر Export، وسيتم تنزيل ملف ZIP.
تثبيت الرموز التعبيرية في أعلى منتقي الرموز
يمكنك تثبيت أي مجموعة من الرموز التعبيرية في أعلى منتقي الرموز التعبيرية. الوصول إلى الإعداد emoji_picker_pinned_groups عبر Admin → Appearance → Emoji → Settings في /admin/config/emoji/settings. أدخل اسم مجموعة الرموز التعبيرية المراد تثبيتها في أعلى المنتقي.
يمكن تثبيت كل من مجموعات الرموز التعبيرية المخصصة والعادية في الأعلى. على سبيل المثال، إدخال flags سينقل مجموعة رموز الأعلام إلى الأعلى فوق الابتسامات.
أسماء مجموعات الرموز التعبيرية الافتراضية:
smileys_&_emotionpeople_&_bodyanimals_&_naturefood_&_drinktravel_&_placesactivitiesobjectssymbolsflags
إعدادات الرموز التعبيرية
يمكنك الوصول إلى إعدادات الرموز التعبيرية في /admin/config/emoji/settings لتخصيص كيفية عمل الرموز التعبيرية على موقعك.
enable_emoji- تمكين عرض واستخدام الرموز التعبيرية في مثيل Discourse الخاص بك. إذا تم تعطيله، لن يتم عرض الرموز التعبيرية ولن يتمكن المستخدمون من الوصول إليها أو استخدامها في حقول النص.emoji_set- حدد النمط المفضل لديك للرموز التعبيرية. يمكن أن توفر مجموعات الرموز التعبيرية المختلفة مظاهر فريدة للرموز المعروضة على الموقع.max_emojis_in_title- الحد الأقصى المسموح به للرموز التعبيرية في عنوان الموضوع (الافتراضي: 1). إذا كان القيمة المحددة صفرًا، فهو يمنع استخدام أي رموز تعبيرية في عناوين المواضيع.enable_emoji_shortcuts- سيتم تحويل نصوص الابتسامات الشائعة مثل:):p:(إلى رموز تعبيرية.emoji_autocomplete_min_chars- الحد الأدنى لعدد الأحرف المطلوبة لتفعيل نافذة الإكمال التلقائي للرموز التعبيرية (الافتراضي: 0).enable_inline_emoji_translation- يمكّن الترجمة للرموز التعبيرية المضمنة (بدون أي مسافة أو علامات ترقيم قبلها).emoji_deny_list- هذه الرموز التعبيرية لن تكون متاحة للاستخدام في القوائم أو الرموز القصيرة.emoji_picker_pinned_groups- هذه مجموعات الرموز التعبيرية المثبتة في أعلى منتقي الرموز التعبيرية.external_emoji_url- عنوان URL لخدمة خارجية لصور الرموز التعبيرية. اتركه فارغًا لاستخدام الافتراضي.discourse_reactions_enabled_reactions- يحدد قائمة بالتفاعلات المفعلة، يُسمح بأي رمز تعبيري هنا. التفاعلات الافتراضية: +1، laughing، open_mouth، clap، confetti_ball، و hugs.discourse_reactions_excluded_from_like- التفاعلات التي لا تحسب كإعجاب. أي تفاعلات غير مدرجة في هذه القائمة ستحسب كإعجاب للشارات والتقارير والأغراض الأخرى.discourse_reactions_allow_any_emoji- إذا تم تمكين هذا، سيضيف زرًا يسمح للمستخدمين باختيار أي رمز تعبيري في منتقي التفاعلات. سيسمح للأعضاء باختيار أي رمز تعبيري، بما في ذلك الرموز المخصصة، للتفاعلات. لتقييد التفاعلات المتاحة، استخدم إعداد موقعemoji_deny_list.
تغيير حجم الرموز التعبيرية المخصصة
بشكل افتراضي، يتم تغيير حجم جميع الرموز التعبيرية عبر CSS إلى 20x20، ولكن يمكن تجاوز ذلك باستخدام CSS مخصص. للحفاظ على النسبة الصحيحة والأحجام الأصلية في المنشورات، أضف CSS التالي:
/* Make emoji normal size (don't force square) */
div.topic-post img.emoji[src*="uploads"],
div.d-editor-preview img.emoji[src*="uploads"],
div.emoji-modal img.emoji[src*="uploads"],
div.d-editor-textarea-wrapper img.emoji[src*="uploads"],
div.title-wrapper img.emoji[src*="uploads"],
td.main-link img.emoji[src*="uploads"] {
width: auto;
height: auto;
}
لتخصيص حجم رمز تعبيري معين، استخدم:
img.emoji[title=":youremoji:"] {
height: XXpx;
width: YYpx;
}
لتغيير حجم الرموز التعبيرية في رسائل الدردشة وحالة المستخدم في الدردشات:
div.chat-message-text img.emoji[src*="uploads"],
span.user-status-message img.emoji[src*="uploads"] {
width: auto;
height: auto;
}