Skip to main content
المتغيرات عناصر نائبة تُستبدل بقيم حقيقية عند إرسال الرسالة.

صياغتان مختلفتان

يستخدم فيتوكس صياغتين، وهما غير قابلتين للتبادل.{User} في رسالة ترحيب تُطبع حرفياً. [user] في رسالة تذكرة تُطبع حرفياً.

القاعدة العامة

المتغيّر غير المعروف يصبح نصاً فارغاً، لا خطأً — وفي embeds، الحقل الذي ينتهي عنوانه أو قيمته فارغاً يُسقَط من الرسالة كلياً.هذا هو السبب الأكثر شيوعاً لـ “حقل embed لديّ يستمر بالاختفاء”. غالباً متغيّر مكتوب خطأً أو غير موجود لتلك الميزة.

نظام الترحيب والوداع والتحية

[Server] ليس متغيّراً. يظهر في رسالة الترحيب الافتراضية ويُطبع حرفياً. استبدله بـ [ServerName].
[Inviter] و[Code] يحتاجان إلى Manage Server ليتمكّن فيتوكس من قراءة الدعوات.

التذاكر

المجموعة الأغنى في فيتوكس. قابلة للاستخدام في embeds التذاكر، وصيغ أسماء القنوات، ورسائل ساعات الدعم.
{user} {mention} {username} {userid} {user.mention} {user.name} {user.username} {user.tag} {user.id}
{ticket} {number} {num} {ticket.number} {ticket-number} {#number} {ticket.channel} {ticket.channelName} {ticket.priority} {ticket.closeReason} {ticket.openedAt} {ticket.createdAt} {ticket.closedAt} {ticket.users}
{channel} {channel.mention} {channel.name} {channel.id} {panel} {panel.name} {panel-name} {option} {option.label}
{server} {server.name} {server.id} {server.members} {server.icon} {server.banner} {guild} {members}
{staff} {staff.mention} {staff.name} {claim.user} {claim.name} {close.user} {close.name} {close.reason} {escalate.reason} {escalate.panel} {reason}
{form.1}, {form.2} … — مفهرسة من 1، بترتيب ظهور أسئلتك.{form.Label} تعمل أيضاً باستخدام تسمية السؤال نفسه.
{date} {time} {timestamp} {time.created} {time.opened} {time.claimed} {time.closed} — كل منها يقبل أيضاً .age.{statistics.tickets.open} {statistics.tickets.created} {statistics.tickets.closed} {statistics.tickets.claimed} {statistics.tickets.averageRating}
{supportHours.status} {supportHours.nextOpen} {supportHours.nextOpenTime} {supportHours.nextOpenRelative} {supportHours.closesAt} {supportHours.closesAtTime}

المُعدِّلات

متغيّرات التذاكر تقبل مُعدِّلات بصياغة {variable?modifier=value}: upper، lower، capitalize، truncate، slice، padleft، padright، replace، fallback، date، timestamp، math، ordinal، join، if.
{user.name?upper} يصرخ بالاسم. {ticket.closeReason?fallback=No reason given} يتجنّب سقوط حقل فارغ — وهو أنظف حل لحقول embed المتلاشية.

Counting

{count} {user} {record} — بالإضافة إلى {start} و{savesLeft} في رسائل إعادة الضبط والحفظ.
{server} مُقدَّم لكن يُعرَض دائماً فارغاً. اكتب اسم سيرفرك مباشرة.

ستاربورد

{author} {stars} {channel} {link} {content} {emoji}

Self-Roles

[Role] — اسم الرتبة، في إشعارات الرسائل الخاصة.

قوالب الهدايا

{prize} {winners} {host} {endsAt} {id} {description} {requiredRole} {minAccountAge} {entryCount}

الإشعارات

كل منصة لها مجموعتها الخاصة. استخدام متغيّر لمنصة على منصة أخرى ينتج فارغاً.
{streamer.name} {streamer.url} {streamer.avatar}مباشر فقط: {stream.title} {stream.game} {stream.viewers} {stream.thumbnail}
{streamer.name} {streamer.url} {streamer.avatar}مباشر فقط: {stream.title} {stream.category} {stream.viewers} {stream.thumbnail}لاحظ {stream.category}، لا {stream.game} في تويتش.
{channel.name} {channel.avatar} {video.title} {video.url} {video.thumbnail} {video.type}
{post.title} {post.url} {post.author} {post.content} {post.flair} {post.thumbnail} {subreddit.name} {subreddit.url} {subreddit.icon}
{post.text} {post.url} {post.image} {post.likes} {author.name} {author.handle} {author.avatar}
{news.title} {news.url} {news.content} {news.category} {news.author} {game.name} {game.image}
{item.title} {item.url} {item.description} {item.author} {feed.name} {feed.url}
عاملة: {episode.title} {episode.url} {episode.description} {podcast.name}
{episode.duration} و{podcast.author} و{podcast.artwork} مُقدَّمة لكنها لا تنتج قيمة أبداً. أي حقل مبني عليها فقط يُسقَط.

متغيّرات لا تعمل

مؤكَّد أنها غير عاملة. تجنّب هذه:

استكشاف الأخطاء

عندما لا تصل الرسالة أصلاً.