قالب‌های اعلان (Notification Templates) در cPanel & WHM

1. مقدمه

cPanel & WHM برای رویدادهای مختلف مانند پر شدن سهمیه دیسک، انقضای SSL، شکست بکاپ، ساخت اکانت جدید، خطاهای سرویس‌ها و... اعلان (Notification) ارسال می‌کند. این اعلان‌ها با استفاده از Template Toolkit ساخته می‌شوند و شما می‌توانید آن‌ها را کاملاً شخصی‌سازی کنید: افزودن لوگو، تغییر متن، فارسی‌سازی، تغییر رنگ، افزودن لینک پشتیبانی و...

محل ذخیره قالب‌ها

• قالب‌های اصلی (پیش‌فرض): /usr/local/cpanel/etc/icontact_templates/
• قالب‌های سفارشی (توصیه‌شده): /var/cpanel/templates/icontact_templates/

هشدار مهم: هر تغییری در پوشه اصلی با آپدیت cPanel حذف می‌شود. همیشه از پوشه سفارشی استفاده کنید.

---

2. ساختار نام فایل‌های قالب

قالب‌ها با این فرمت نام‌گذاری می‌شوند:

textnotification_name.type.tmpl

اجزای نام:

• notification_name: نام رویداد (مثلاً wwwacct/Notify)
• type: نوع قالب:
  • subject → موضوع ایمیل
  • html → بدنه HTML
  • text → بدنه متنی ساده

---

3. مهم‌ترین اعلان‌ها و قالب‌های موجود

مسیر قالب	توضیح اعلان	محل تنظیم	نکات
Accounts/ChildDistributionFailure.*	شکست انتقال قابلیت‌ها به child node	Contact Manager	مربوط به DNS Cluster
Backup/Failure.*	شکست بکاپ	Contact Manager	مهم
Backup/Success.*	بکاپ موفق	Contact Manager	—
BandwidthUsageExceeded/User.*	رسیدن به سقف پهنای باند	Tweak Settings	برای کاربران نهایی
Check/SSLCertExpired.*	SSL منقضی شده	Contact Manager	بسیار مهم
chkservd/Notify.*	داون شدن سرویس‌ها (Apache، MySQL، Exim)	Contact Manager	حیاتی‌ترین اعلان
Quota/DiskWarning.*	نزدیک شدن به سقف دیسک	Contact Manager	—
SSL/CertificateExpiring.*	نزدیک شدن به انقضای SSL	Contact Manager	—
wwwacct/Notify.*	ساخت اکانت جدید	Contact Manager	پرکاربرد

---

4. متغیرهای قابل استفاده در قالب‌ها

4.1 متغیرهای CPANEL (همیشه در دسترس)

• [% CPANEL.locale %] → زبان کاربر
• [% CPANEL.split_time_dhms(seconds) %] → تبدیل ثانیه به روز/ساعت/دقیقه

4.2 متغیرهای NOTICE (وابسته به نوع اعلان)

• [% NOTICE.domain %] → دامنه
• [% NOTICE.ip_address %] → آی‌پی
• [% NOTICE.host_server %] → hostname سرور
• [% NOTICE.quota_limit %] → سقف quota

در هدر هر قالب، لیست کامل متغیرهای قابل استفاده نوشته شده است.

---

5. نحوه شخصی‌سازی قالب‌ها (Customize Templates)

گام ۱ — ساخت پوشه سفارشی

mkdir -p /var/cpanel/templates/icontact_templates

گام ۲ — کپی include و wrapper (فقط بار اول)

cp -rpl /usr/local/cpanel/etc/icontact_templates/{include,wrapper} /var/cpanel/templates/icontact_templates/

گام ۳ — کپی قالب موردنظر

مثلاً برای اعلان ساخت اکانت جدید:

cp /usr/local/cpanel/etc/icontact_templates/wwwacct/Notify.subject.tmpl \
/var/cpanel/templates/icontact_templates/wwwacct/Notify.subject.tmpl

گام ۴ — ویرایش قالب

nano /var/cpanel/templates/icontact_templates/wwwacct/Notify.subject.tmpl

نمونه تغییر موضوع ایمیل:

[% CPANEL.locale.maketext('Example Hosting: New account created on [_1] ([_2])', NOTICE.host_server, NOTICE.domain) %]

گام ۵ — اعمال تغییرات

/usr/local/cpanel/bin/rebuild-templates

---

نتیجه‌گیری

قالب‌های اعلان در cPanel & WHM یکی از قدرتمندترین ابزارهای شخصی‌سازی هستند. با استفاده از پوشه سفارشی، Template Toolkit و متغیرهای NOTICE و CPANEL می‌توانید اعلان‌ها را کاملاً مطابق برند، زبان و نیازهای کسب‌وکارتان طراحی کنید.