تعاریف مهم

1. Additional Service (سرویس اضافی)
   هر سرویسی که مستقل از Plesk هم می‌تواند وجود داشته باشد، اما می‌توان آن را به عنوان یک قابلیت جانبی به پلن‌های میزبانی اضافه کرد (مثلاً ضداسپم اختصاصی).
2. Hosting Plan (پلن میزبانی)
   بسته‌ای از منابع و امکانات که به مشتریان ارائه می‌شود (مثلاً پلن Silver یا Gold).
   سرویس اضافی می‌تواند فقط به یک پلن خاص متصل شود.
3. PN (Plesk Notifications)
   سیستم اعلان داخلی Plesk که تغییرات مربوط به سایت‌ها، دامنه‌ها، حساب‌های ایمیل و اشتراک‌ها (subscriptions) را به سرویس شما اطلاع می‌دهد.
4. Subscription (اشتراک)
   نمونه‌ای واقعی از یک پلن میزبانی که به مشتری اختصاص داده شده است.
   اگر پلنی شامل یک سرویس اضافی باشد، تمام اشتراک‌های آن پلن هم از آن سرویس بهره‌مند می‌شوند.
5. Plan_Item_Interface
   یک اینترفیس (interface) در Plesk که باید پیاده‌سازی شود تا سرویس شما مشخص کند:
   • چه ویژگی‌هایی دارد
   • چه تغییراتی باید رصد شوند
   • کد مدیریت تغییرات چیست
6. Custom Button (دکمه سفارشی)
   راهی برای نمایش سرویس به مشتری در پنل Plesk (مثلاً در بخش Websites & Domains).
7. Plesk Extension (افزونه Plesk)
   روشی پیشرفته‌تر برای ادغام سرویس‌ها در Plesk، اگر نیاز به دسترسی به منابع داخلی یا GUI داشته باشید.

شرکت‌های هاستینگ می‌توانند با اضافه کردن سرویس‌های جانبی (third-party services) به Plesk، ارزش پلن‌های میزبانی خود را بیشتر کنند. این سرویس‌ها می‌توانند هر چیزی باشند که روی یک URL در دسترس است (مثلاً یک افزونه Plesk یا یک اپلیکیشن وب). حتی اگر سرویس کاملاً مستقل از Plesk باشد، باز هم می‌توان آن را اضافه کرد. نمونه‌ها: فیلتر اسپم، ابزار آمار ترافیک، سیستم پشتیبانی.

ادمین و ری‌سلرها می‌توانند هنگام طراحی پلن‌های هاستینگ، سرویس‌های اضافی را به آن‌ها متصل کنند. مثلاً یک فیلتر ایمیل خاص را فقط به پلن Silver اختصاص دهند و در پلن‌های دیگر ارائه ندهند.

✅ روش‌های اضافه کردن سرویس به Plesk

1. از طریق GUI (رابط کاربری Plesk)

• به Service Plans > Additional Services بروید.
• سرویس را اضافه کنید.
• می‌توانید آن را به شکل یک Custom Button به صفحه Websites & Domains مشترکین اضافه کنید.

📌 این روش برای سرویس‌هایی مناسب است که به اعلان‌های Plesk (PN) نیاز ندارند.

2. از طریق Programming Call (کدنویسی/API)

این روش باعث می‌شود سرویس شما بتواند از طریق Plesk Notifications (PN) تغییرات را رصد کند.
مثلاً اگر سرویس فیلتر ایمیل دارید، باید از تغییر نام حساب‌های کاربری مطلع شود تا همچنان به درستی کار کند.

• در این روش باید سرویس خود را به PN ثبت کنید.
• عیب این روش: جزئیات سرویس قابل ویرایش از طریق Plesk GUI نخواهند بود.
• همچنین سرویس به صورت پیش‌فرض برای مشتریان قابل مشاهده نیست (باید با Custom Button یا Extension نمایش داده شود).

🔔 Plesk Notifications (PN) چه چیزهایی را اطلاع می‌دهد؟

PN تغییرات مربوط به:

• اشتراک‌ها (Subscriptions)
• وب‌سایت‌ها (Sites)
• حساب‌های ایمیل (Email Accounts)

📌 چون سرویس‌ها به پلن‌ها متصل هستند، هر تغییری در اشتراک‌های آن پلن هم شامل سرویس می‌شود.

🛠️ مراحل ثبت سرویس با PN

1. یک کلاس سرویس اختصاصی بسازید که اینترفیس زیر را پیاده‌سازی کند: Plan_Item_Interface
2. با پیاده‌سازی اینترفیس:
   • مشخصات سرویس در Plesk تعریف می‌شود.
   • نوع تغییراتی که باید دریافت کند مشخص می‌شود.
   • کدی که در هنگام تغییر باید اجرا شود نوشته می‌شود.
   📌 این کد همیشه در Context مدیر (Administrator context) اجرا می‌شود.
3. این کلاس را با یک Programming Call در Plesk ثبت کنید.

⚠️ نکته‌ها:

• این بخش توضیح نمی‌دهد که چطور سرویس‌های third-party را بسازید یا به منابع داخلی Plesk دسترسی دهید.
• اگر می‌خواهید سرویس ثبت‌شده برای مشتریان هم قابل مشاهده باشد، می‌توانید:
  • یک Custom Button بسازید که به URL سرویس شما اشاره کند.
  • یا یک Extension برای Plesk بنویسید.

📝 خلاصه ساده

• سرویس اضافی = هر سرویس جانبی (مثل ضد اسپم).
• اضافه کردن سرویس:
  • از طریق GUI (ساده، بدون اعلان PN).
  • از طریق Programming/API (پیشرفته، با اعلان PN).
• برای نمایش سرویس به مشتری → Custom Button یا Extension.
• برای ثبت سرویس با PN → پیاده‌سازی اینترفیس Plan_Item_Interface و ثبت کلاس.

کیان پور