~3 دقیقه مطالعه • بروزرسانی ۲۹ بهمن ۱۴۰۴
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→ بدنه HTMLtext→ بدنه متنی ساده
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 میتوانید اعلانها را کاملاً مطابق برند، زبان و نیازهای کسبوکارتان طراحی کنید.
نوشته و پژوهش شده توسط دکتر شاهین صیامی