Fjord

توثيق Fjord

الوحدات

01

الترحيب

رحّب بالأعضاء الجدد وودّع المغادرين وعيّن الرتب تلقائيًا.

الوظائف المتاحة

  • رسائل ترحيب ووداع مخصصة
  • بطاقات ترحيب بتصميم خاص
  • منح الأدوار تلقائياً للأعضاء الجدد
  • قنوات منفصلة للانضمام والمغادرة

ما الذي يمكن الترحيب به؟

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

حقوق Discord المطلوبة

عرض القناة إرسال الرسائل إرفاق الملفات إدارة الأدوار تضمين الروابطالإشارة إلى الرتب غير المتاحة للجميع

يحتاج Fjord إلى هذا الإذن فقط إذا كان النص العادي لرسالة الترحيب أو الوداع سينبّه رتبة لا يمكن للجميع الإشارة إليها. يُحظر استخدام @everyone و@here في نظام الترحيب ولا تعمل الإشارة إليهما فيه.

مطلوب "إرفاق ملفات" لبطاقة الترحيب. إدارة الأدوار مطلوبة فقط للأدوار التلقائية.

الإعداد

  1. حدد الخادم الذي تريد إدارته.
  2. افتح مرحبًا.
  3. فعّل رسائل الترحيب أو رسائل الوداع أو الرتب التلقائية.
  4. حدد قناة نصية يمكن الوصول إليها أو دورًا واحدًا على الأقل.
  5. تحقق من المعاينة واحفظ التغييرات.

بالنسبة للأدوار التلقائية، يجب أن يكون دور Fjord فوق كل الأدوار التي سيتم تعيينها.

رسالة ترحيب

يمكن تعديل المفتاح والقناة بشكل منفصل. يحتفظ التعطيل بالقناة المختارة. يمسح خيار بدون قناة الاختيار فقط في البداية، ويبقى المحرر متاحًا. الحفظ بلا قناة يعطّل الخدمة المعنية ويغلق محرر رسالتها. ينطبق ذلك على الترحيب والوداع.

يتم إرسال رسالة الترحيب بمجرد انضمام العضو إلى الخادم. يتم حفظ القناة ونص الرسالة وبطاقة الترحيب معًا. تُظهر المعاينة كيفية تفاعل النص والبطاقة قبل الحفظ.

إرسال رسالة ترحيباختياري

لتشغيل الترحيب التلقائي أو إيقافه.

القناةمطلوبة عند التنشيط

تحدد القناة النصية التي يمكن الوصول إليها والتي يتم نشر التحية فيها.

الرسالةاختيارية

تحتوي على نص الرسالة العادية. يمكن استخدام العناصر النائبة والأدوار والقنوات والرموز التعبيرية للخادم عبر التحديدات.

بطاقة الترحيباختيارية

تضيف بطاقة صورة مصممة شخصيًا إلى الترحيب.

عنصر نائب للرسائل

العنصر النائبيتم استبداله بـمثال
{member.user.name}اسم مستخدم Discord للعضوcorvus48
{member.mention}ذكر العضوة الجديدة@Mira
{member.user.id}معرف مستخدم Discord للعضو123456789012345678
{member.user.global_name}اسم العرض العام للعضوMira
{guild.name}اسم الخادممجتمع Fjord
{guild.member_count}عدد العضوية الحالي1,248

استخدم اختيار العناصر النائبة في المحرر. بهذه الطريقة يتم استخدام الاسم بدقة ويتم تجنب الأخطاء المطبعية بين قوسين متعرجين.

محررات الرسائل والبطاقات المرفقة

{guild.icon}أيقونة الخادم
{member.avatar}صورة العضو

دون تصميم محفوظ، بطاقة الترحيب مفعلة والتضمين معطل. يبدأ الوداع بنص عادي دون تضمين أو بطاقة. الترحيب والوداع ورتب الانضمام تُفعّل بشكل مستقل. يوفر المحرران V1 وV2 ونصًا وتضمينات اختيارية. مفتاح البطاقة المولدة موجود في محرر الترحيب. يستخدم النص الفارغ النص الافتراضي المعروض.

محتوى الرسالة حتى 1,800 حرف، منفصل عن نص التضمين.

للترحيب والوداع اختيار مستقل بين V1 وV2. يتطلب التغيير تأكيدًا ويعيد ضبط نص الرسالة والتضمينات والصور وأزرار الروابط في ذلك المحرر. تبقى القناة والتفعيل وتصميم البطاقة المنفصل. يطبق الحفظ التغيير، ويعيد الإلغاء الحالة المحفوظة السابقة.

V1

يستخدم V1 تضمينات Discord التقليدية بلون تمييز ومناطق ثابتة، بحد أقصى عشرة تضمينات. أرقام الجدول هي حدود الأحرف. المؤلف والعنوان والوصف والتذييل وجميع أسماء الحقول وقيمها معًا لا تتجاوز 6000 حرف عبر جميع التضمينات. للنص العادي حد منفصل. لكل تضمين V1 حد أقصى 25 حقلًا.

الإدخالحد الأحرفالحالة
المؤلف256اختياري
رابط المؤلف512اختياري
العنوان256اختياري
رابط العنوان (اختياري)512اختياري
الوصف4096اختياري
نص التذييل2048اختياري
اسم الحقل256مطلوب بعد الإضافة
قيمة الحقل1024مطلوب بعد الإضافة

كل مناطق التصميم اختيارية. عند إضافة حقل يصبح اسمه وقيمته مطلوبين. احذف الحقول غير المستخدمة. العرض جنبًا إلى جنب يفعّل الحقول المتجاورة، ويتحدد ترتيبها النهائي حسب Discord وعرض الشاشة. رابط المؤلف أو أيقونته يتطلب اسم المؤلف، ورابط العنوان يتطلب عنوانًا، وأيقونة التذييل تتطلب نص تذييل. الروابط الاختيارية عناوين HTTP(S) كاملة. الطابع الزمني يعرض وقت الإرسال.

اختيار الرتب والقنوات متاح في النص العادي ووصف V1 وقيم الحقول. لا تتوفر أدوات الإشارة هذه في المؤلف والعنوان والتذييل وأسماء الحقول، لكن رموز الخادم متاحة في هذه النصوص. رابط المؤلف ورابط العنوان يقبلان URL فقط، دون رتب أو قنوات أو رموز تعبيرية. الإشارات داخل التضمينات التقليدية لا ترسل تنبيهًا.

يعرض Discord أيقونة المؤلف فقط إذا تم إدخال اسم مؤلف أيضًا. أدخل اسمًا أعلاه حتى تظهر الأيقونة في المعاينة. يعرض Discord أيقونة التذييل فقط إذا تم إدخال نص تذييل أيضًا. أدخل نصًا أعلاه حتى تظهر الأيقونة في المعاينة.

V2

يمكن أن تحتوي كتلة الصورة على معرض من عشر صور كحد أقصى. استخدم «+ صورة أخرى» لإضافة صور يمكن حذفها بشكل منفرد. لكل صورة وصورة مصغرة وصف اختياري حتى 80 حرفًا وخيار إخفاء المحتوى. يدعم القسم ثلاثة نصوص حتى 4000 حرف لكل نص. استخدم «+ نص آخر» لإضافة نصين إضافيين كحد أقصى. في الملحق اختر صورة مصغرة أو زر رابط. يتطلب الزر تسمية حتى 80 حرفًا وعنوان HTTP(S) كاملًا حتى 512 حرفًا. الرمز التعبيري وتعطيل الزر اختياريان. تحسب النصوص الإضافية وزر الملحق ضمن حد المكونات. لا تحسب الصور المنفردة في المعرض كمكونات إضافية.

في V2 يمكن إخفاء الحاويات والصور، بما فيها الصور المصغرة، باستخدام خيار المحتوى المخفي. يبقى المحتوى مخفيًا حتى النقر عليه.

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

لا يحتوي V2 على حقول المؤلف التقليدية أو إدخال رابط العنوان أو الحقول المتجاورة أو أيقونات التذييل أو مفتاح الطابع الزمني. استخدم Markdown للعناوين والروابط في النص. المثال أدناه ينشئ تذييلًا صغيرًا ورمز الوقت ينشئ طابعًا زمنيًا. لا يوفر V1 كتل V2 حرة الترتيب. لا يمكن خلط التنسيقين في رسالة واحدة.

-# ... · {time.full}

حاوية

ألوان سريعة · 10

كتلة نص

Markdown · 4000

قسم مع صورة مصغرة

Markdown · 4000 · Thumbnail ≤ 5 MB

صورة

PNG · JPG/JPEG · WebP · GIF ≤ 10 MB

فاصل

إظهار الخط الفاصل · صغير / كبير

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

تعمل عناصر الاستبدال الستة أيضًا في نصوص التنسيقين. يُستخدم اسم المستخدم عند عدم وجود اسم عرض عالمي. لا يظهر عنصر الإشارة للعضو في مناطق V1 غير الداعمة للإشارات. لأيقونة المؤلف والصورة المصغرة والكبيرة وأيقونة التذييل في V1، وللصور المصغرة وكتل الصور في V2، اختر صورة خاصة أو أيقونة الخادم أو صورة العضو. دون أيقونة خادم تبقى الصورة فارغة. المعاينة تستخدم حسابك والإرسال يستخدم العضو الحقيقي. هذه المصادر الديناميكية خاصة بالترحيب والوداع.

عند تعطيل التضمين تُرسل بطاقة الترحيب المفعلة كصورة منفصلة مع النص العادي. عند تفعيل التضمين تشغل الصورة الكبيرة لأول تضمين V1 أو تُضاف لأول حاوية V2. لا يمكن استبدال مكان البطاقة بصورة كبيرة خاصة. تقبل التضمينات الأخرى وكتل الصور الإضافية في V2 صورك. بعد إعادة الترتيب تتبع البطاقة التضمين الأول الجديد. تصميمها مستقل عن V1/V2.

حدود الصور لكل ملف. في V1 تقبل أيقونة المؤلف والصورة المصغرة وأيقونة التذييل 5 MB لكل منها. حد الصورة الكبيرة مطابق لحد كتل V2 الموضح أدناه. تُقبل PNG وJPG/JPEG وWebP وGIF. اختيار ملف يستبدل الصورة وإزالة يفرغ مكانها. لا تظهر أيقونات المؤلف والتذييل دون النص المقابل.

إدراج محتوى في الرسائل

يحتوي محرر الرسائل على تحديداته الخاصة للعناصر النائبة والأدوار والقنوات والرموز التعبيرية للخادم. يتم إدراج الإدخال المحدد في موضع الكتابة الحالي.

التحديدالاستخدام
Wildcardيقوم بإدراج معلومات العضو أو الخادم الديناميكية من الجدول أعلاه.
الأدوارتصفح أدوار الخادم وأدخل ذكر الدور المطلوب. @everyone غير متاح للاختيار.
القنواتتصفح القنوات المتاحة وقم بتعيين رابط القناة.
الرموز التعبيرية للخادمتصفح الرموز التعبيرية الخاصة بالخادم وأدخل رمزًا تعبيريًا ثابتًا أو متحركًا للخادم.

يمكنك فتح التحديدات باستخدام الأزرار الموجودة في المحرر. أثناء الكتابة، يفتح @ اختيار الدور، ويفتح # اختيار القناة، ويفتح : اختيار الرموز التعبيرية للخادم. يتم إدخال المزيد من الأحرف لتصفية القائمة المعنية.

يمكن أن تحتوي رسائل الترحيب والوداع على 1800 حرف كحد أقصى لكل منهما. يتم احتساب الإدخالات المدرجة كجزء من محتوى الرسالة.

تصميم بطاقة ترحيب

يوفر محرر البطاقة المحتوى والتخطيط والسطح والحلقة والنص.

المحتوى

يشمل المحتوى خلفية وصورة أو لونًا اختياريًا وعنوانًا وعنوانًا فرعيًا وخطوطًا مع بحث ومعاينات وصفحات.

التخطيط

التخطيط يسار أو وسط.

المساحة

السطح شفافية عادية من 0–100 % أو طبقة Liquid اختيارية بلون وعتامة 0–100 % وضبابية 0–64 px. تعطّل Liquid تحكم العتامة العادي.

الحلقة

الحلقة لون أساسي وشدة 0–100 % ومظلّل اختياري بلون وقوة 0–100 % وزاوية 0–360°.

النص

النص لون أساسي وشدة ومظلّل اختياري بلون وقوة وموضع 0–100 %.

لا توجد أدوات حرة لحجم الصورة الشخصية أو أحجام الخطوط المنفردة أو مواضع النص العشوائية.

إعادة الضبط تستعيد التصميم الافتراضي. الحفظ والإلغاء عبر شريط الحفظ المشترك.

استخدم الخلفية الافتراضية أو لونًا موحدًا أو صورتك الخاصة. يمكن تحريك الصورة وتكبيرها في محرر القص. يوفر المساحة أيضًا طبقة سائلة مع اللون والعتامة والتمويه.

الخاصيةالمدعومةملاحظة
حجم الملفالحد الأقصى 10 ميجا بايتلا يمكن حفظ الملفات الأكبر حجمًا كخلفية.
تنسيقات الصورPNG، JPG/JPEG، WebP وGIFيتم التحقق من تنسيق الملف الفعلي بناءً على محتوى الصورة.
تنسيق البطاقة1200 × 600 بكسلسيتم اقتصاص الصورة المحددة في قسم البطاقة هذا في المحرر.
الرسوم المتحركةنتيجة ثابتةيتم حفظ البطاقة النهائية بتنسيق PNG. ولذلك لا يتم الاحتفاظ بالرسوم المتحركة من ملفات GIF أو WebP.

العنوان ≤ 120 · العنوان الفرعي ≤ 160

عناصر استبدال البطاقة

{member.user.name} · {guild.name} · {guild.member_count}

أبعاد البطاقة 1200 × 600 بكسل وتُنتج بصيغة PNG ثابتة. تستخدم المعاينة حسابك وبيانات نموذجية من الخادم المختار. عند الانضمام تُستخدم بيانات العضو. تتطلب معاينة المتصفح اتصالًا صالحًا بلوحة التحكم.

رسالة الوداع

يمكن تعديل المفتاح والقناة بشكل منفصل. يحتفظ التعطيل بالقناة المختارة. يمسح خيار بدون قناة الاختيار فقط في البداية، ويبقى المحرر متاحًا. الحفظ بلا قناة يعطّل الخدمة المعنية ويغلق محرر رسالتها. ينطبق ذلك على الترحيب والوداع.

يتم إرسال رسالة الوداع عندما يغادر العضو الخادم. يمكنه استخدام قناة مستهدفة مختلفة ونص خاص به. لا يمكن دائمًا حل الإشارات بعد المغادرة. لذلك يُفضّل استخدام {member.user.global_name}.

إرسال رسالة وداعاختياري

لتشغيل أو إيقاف تشغيل الوداع التلقائي.

القناةمطلوبة عند التنشيط

تحدد القناة النصية التي يمكن الوصول إليها والتي سيتم نشر رسالة الوداع فيها.

الرسالةاختيارية

تحتوي على نص وداع يصل إلى 1800 حرف ومساعدات الإدراج المتاحة.

الأدوار التلقائية

يمكن لـ Fjord تعيين أدوار متعددة للأعضاء الجدد فورًا بعد الانضمام. لا يمكن تعيين الأدوار التي يديرها Discord والأدوار الموجودة فوق دور Fjord.

الأدوار التلقائيةاختيارية

لتشغيل تعيين الدور أو إيقافه عند الانضمام.

الأدوارمطلوبة عند التنشيط

تصفح تحديد الدور وحدد دورًا واحدًا على الأقل و25 دورًا كحد أقصى.

  1. تحقق ضمن إعدادات الخادم → الأدوار من أن دور Fjord أعلى من الأدوار المستهدفة.
  2. قم بتنشيط تعيين الأدوار التلقائي وحدد الأدوار المطلوبة.
  3. احفظ التحديد.

لا ينبغي تعيين الأدوار ذات الحقوق الإدارية الشاملة تلقائيًا. يعرض Fjord فقط الأدوار التي يمكن تعيينها بشكل عام.

إصلاح الأخطاء

مشكلةتحقق
لم يتم إرسال أي رسالة.هل الخدمة مفعلة وما زالت القناة متاحة وهل مسموح للمضيق رؤيتها والكتابة بها؟
البطاقة مفقودة.هل تم تنشيط البطاقة وهل لدى Fjord "إرفاق الملفات" مباشرة في القناة المستهدفة؟
لم يتم تعيين دور.هل دور Fjord أعلى من الدور المستهدف وهل يمتلك Fjord "إدارة الأدوار" بشكل صحيح؟
يظل العنصر النائب دون تغيير.هل تم إدراجه باستخدام تحديد العنصر النائب وهل التهجئة والأقواس صحيحة؟
لا تظهر التغييرات.احفظ التغييرات المعلّقة بشريط الحفظ المشترك؛ يطبّق تغييرات الرسائل والبطاقة معًا.

يجمع V2 حتى خمسة أزرار روابط في صف إجراءات واحد. يُطبق الحد الكلي للمكونات بدل حد خمسة صفوف في V1.

أزرار الروابط تفتح مواقع ولا تمنح رتبًا. كل زر مضاف يحتاج تسمية حتى 80 حرفًا ورابط HTTP(S) كامل حتى 512 حرفًا. الرمز التعبيري اختياري. يمكن ترتيب الأزرار وحذفها. يعرض V1 الأزرار أسفل التضمينات، خمسة في الصف وخمسة صفوف إجمالًا، أي 25 زرًا. يعرضها V2 داخل حاويتها ويحسب الأزرار والصفوف ضمن حد 40.

تُرسل أزرار الروابط فقط عند تفعيل التضمينات.

المتطلبات والحدود

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

المعاينة والمحتوى المخفي وملفات الصور

في معاينة V2 تحتفظ صورة المعرض المنفردة بنسبة أبعادها. تظهر الصور المتعددة في شبكة بمساحات قص متساوية بنسبة 16:9. تستخدم صورتان أو أربع صور عمودين، وتستخدم ثلاث صور ومن خمس إلى عشر صور ثلاثة أعمدة. تظهر الصورة المصغرة يمين نص القسم. يوفر وصف الصورة نصًا بديلًا وليس تعليقًا مرئيًا إضافيًا.

تخص مفاتيح إخفاء الصور والحاويات محرر V2. يمكن إخفاء كل صورة في المعرض والصور المصغرة بشكل مستقل. يخفي إعداد الحاوية محتواها مع إبقاء إطارها الخارجي ظاهرًا. يكشف النقر المحتوى في المعاينة دون تغيير الإعداد المحفوظ. يستطيع الأعضاء أيضًا كشف المحتوى المخفي بالنقر في Discord.

تقبل صور الرسائل PNG وJPG/JPEG وWebP وGIF. يجب أن يتوافق نوع الملف مع محتوى الصورة. تغيير امتداد ملف HTML أو SVG لا يجعله صورة مدعومة. تبقى حدود جداول الصور مطبقة على كل ملف. إذا رُفضت صورة محلية أو تعذرت قراءتها، فاختر الملف الأصلي مجددًا وأعد الحفظ.

تدعم حقول نص Markdown روابط الويب والبريد الإلكتروني. تفتح المعاينة روابط HTTP(S) وmailto، لكنها لا تفتح الملفات المحلية أو عناوين Blob. تتطلب روابط المؤلف والعنوان وأزرار الروابط عناوين HTTP(S) كاملة. لا تنشر المعاينة رسالة. تحقق من النتيجة المحفوظة في Discord، فقد يختلف العرض حسب العميل وعرض الشاشة.