توثيق Fjord
الوحدات
01
الترحيب
رحّب بالأعضاء الجدد وودّع المغادرين وعيّن الرتب تلقائيًا.
الوظائف المتاحة
- رسائل ترحيب ووداع مخصصة
- بطاقات ترحيب بتصميم خاص
- منح الأدوار تلقائياً للأعضاء الجدد
- قنوات منفصلة للانضمام والمغادرة
ما الذي يمكن الترحيب به؟
من خلال الترحيب يمكنك تلقائيًا الترحيب بالأعضاء الجدد، وتوديع الأعضاء المغادرين، وتعيين الأدوار عند الانضمام. يمكن استخدام المناطق الثلاثة بشكل مستقل عن بعضها البعض.
حقوق Discord المطلوبة
مطلوب "إرفاق ملفات" لبطاقة الترحيب. إدارة الأدوار مطلوبة فقط للأدوار التلقائية.
الإعداد
- حدد الخادم الذي تريد إدارته.
- افتح مرحبًا.
- فعّل رسائل الترحيب أو رسائل الوداع أو الرتب التلقائية.
- حدد قناة نصية يمكن الوصول إليها أو دورًا واحدًا على الأقل.
- تحقق من المعاينة واحفظ التغييرات.
بالنسبة للأدوار التلقائية، يجب أن يكون دور 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 دورًا كحد أقصى.
- تحقق ضمن إعدادات الخادم → الأدوار من أن دور Fjord أعلى من الأدوار المستهدفة.
- قم بتنشيط تعيين الأدوار التلقائي وحدد الأدوار المطلوبة.
- احفظ التحديد.
لا ينبغي تعيين الأدوار ذات الحقوق الإدارية الشاملة تلقائيًا. يعرض 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، فقد يختلف العرض حسب العميل وعرض الشاشة.
02
المشرف التلقائي
يكتشف AutoMod المحتوى غير المرغوب ويطبّق قواعد الخادم.
- عشرة مرشحات للمحتوى والرسائل المزعجة والروابط والإشارات
- نطاقات منفصلة للأدوار والقنوات
- حتى عشرة مستويات تحذير مع الحذف أو التقييد أو الطرد أو الحظر
03
سجل النشاط
سجّل الأحداث المهمة في قنوات Discord التي تختارها.
- دعم 89 نوعاً من الأحداث
- قناة سجلات مشتركة
- سجلات يمكن تفعيلها بشكل مستقل
04
التضمينات
أنشئ رسائل منظمة بالمحرر المرئي من دون كتابة JSON.
- عناوين وأوصاف وحقول ووسائط
- معاينة مباشرة أثناء التحرير
- الحفظ ثم التعديل مجدداً
رتب التفاعل
يختار الأعضاء رتبهم باستخدام الأزرار والقوائم. اضبط مجموعات الرتب ورسائل V1/V2 والمنشورات المُدارة.
الوظائف المتاحة
- يدعم التنسيقان المعاينة والألوان والصور وتعدد التضمينات وفتحها ونسخها وحذفها وترتيبها. يستخدم V1 حقول Discord الثابتة وV2 كتلًا حرة. توضح الأقسام التالية المدخلات والفروق.
- أزرار رتب بتسميات ورموز تعبيرية وأربعة أنماط ورتبة واحدة أو أكثر لكل خيار
- قوائم بنص إرشادي وأوصاف ورموز تعبيرية واختيار فردي أو متعدد
- يسمح V1 باختيارات رتب مستقلة متعددة تحت الرسالة كلها. تشترك في خمسة صفوف إجراءات كحد أقصى. كل قائمة تستخدم صفًا وحتى خمسة أزرار تشترك في صف. لذلك تُتاح خمس قوائم دون صفوف أزرار إضافية فقط. كل اختيار يضم حتى 25 خيارًا. يمنح V2 كل حاوية اختيارًا بأزرار أو قائمة ضمن الحد المشترك. نقل تضمين V1 لا ينقل اختيار رتب مستقلًا. الأزرار زرقاء أو رمادية أو خضراء أو حمراء، لكن لا يوجد محرر أزرار روابط مواقع أو إرسال لمرة واحدة.
- معاينة مباشرة تحاكي اختيار الرتب دون تغيير رتب الأعضاء الفعلية
- تسمية التركيبات ونسخها وحفظ المسودات ونشر الرسائل وتحديثها وإزالة المنشورات
- إرشادات حول صلاحيات الرتب وتسلسلها وأحجام الصور وحدود النص والمكونات المشتركة
05
الإعدادات
في الإعدادات، يمكنك اختيار اللغة والمنطقة الزمنية واللون الافتراضي للتضمينات، وتفويض الوصول إلى لوحة التحكم وإدارة بيانات الوحدات المحفوظة.
- اللون الافتراضي للرسائل المضمنة من الروبوت
- اللغة والمنطقة الزمنية
- تفويض الوصول إلى لوحة التحكم
- إدارة بيانات الوحدات المحفوظة
06
الأوامر
جميع أوامر Fjord المائلة وأذوناتها وطريقة حل المشكلات.