المرجع
مرجع المتغيرات
نسخة مرجعية أوضح للمتغيرات الأكثر استخداماً: أين تعمل، ماذا تعطي، وكيف تكتب رسائل قابلة للصيانة.
المتغيرات الشائعة
| المتغير | المعنى |
|---|---|
{user} | منشن العضو المستهدف أو صاحب الحدث. |
{user.name} | اسم المستخدم. |
{user.id} | المعرف الرقمي للعضو. |
{server} | اسم السيرفر. |
{server.count} | عدد أعضاء السيرفر عند توليد الرسالة. |
{time} | طابع زمني حالي. |
متغيرات حسب السياق
| السياق | أمثلة |
|---|---|
| الترحيب | {user}, {server}, {server.count} |
| التذاكر | {ticket.id}, {ticket.channel}, {panel.name} |
| سجل الإشراف | {author}, {reason}, {user} |
قاعدة مهمة
لا تفترض أن كل متغير يعمل في كل صفحة. اكتب الرسائل بحسب السياق الذي سيُستخدم فيه القالب.
قواعد كتابة القوالب
اجعل الرسالة مفهومة حتى لو فشل متغير واحد
لا تبنِ الجملة كاملة على متغير واحد. الأفضل أن تبقى الرسالة مفهومة حتى لو غاب جزء منها.
لا تكثر من الرموز في رسالة تشغيلية
رسائل السجل أو التنبيه تحتاج وضوحاً أكثر من الزخرفة. اذكر من، ماذا، ولماذا.
ثبّت أسلوباً موحداً للأسباب والتواريخ
إذا كنت تستخدم {reason} أو {time} في أكثر من مكان، حافظ على نفس الأسلوب حتى لا تصبح الرسائل متناقضة بين الأنظمة.
أمثلة جاهزة
ترحيب
أهلاً {user} في {server}، أنت العضو رقم {server.count}.
سجل إشراف
نفّذ {author} إجراءً على {user}. السبب: {reason}. الوقت: {time}.
تأكيد تذكرة
تم إنشاء التذكرة {ticket.id} من خلال بانل {panel.name} في {ticket.channel}.