افزونه‌ها
افزونه برنامه‌ای جداست که کنار پنل شما کار می‌کند: فروشگاهی که پلن‌هایتان را می‌فروشد، باتی که به کاربرها می‌گوید حسابشان رو به انقضاست، یا گزارشی از خودتان. این صفحه توضیح می‌دهد افزونه چیست و اجازهٔ چه کارهایی دارد، و شما را به افزونه‌هایی که نکسورا منتشر می‌کند راهنمایی می‌کند.
افزونه چیست
افزونه نرم‌افزار مستقلی است، با رابط و پایگاه دادهٔ خودش. به صورت سرویس یا کانتینر روی یکی از سرورهای شما اجرا می‌شود، اغلب روی سرور خود پنل، و فقط از راه شبکه با پنل حرف می‌زند.
- پنل هرگز کد افزونه را اجرا نمی‌کند. افزونه را با اجرای اسکریپت نصب خود افزونه نصب می‌کند، و بعد مثل هر برنامهٔ دیگری روی HTTPS با آن کار می‌کند.
- پنل هرگز داده‌های افزونه را ذخیره نمی‌کند. سفارش‌ها، کیف پول‌ها، اتصال‌های چت، لاگ پیام‌ها: همه در پایگاه دادهٔ افزونه است. از آن همراه با افزونه پشتیبان بگیرید، نه با پنل.
- پنل هرگز صفحه‌های افزونه را درون صفحه‌های خودش نشان نمی‌دهد. لینکی به رابط افزونه نگه می‌دارد، و شما آن را در زبانهٔ جداگانه‌ای باز می‌کنید.
حذف افزونه از پنل دسترسی‌اش را پاک می‌کند. آنچه افزونه نگه می‌دارد روی سرور خودش می‌ماند، پس ثبت دوباره آن را پیدا می‌کند.
پنل چه چیزی به افزونه می‌دهد
هر افزونه یک مانیفست امضاشده دارد، فایلی که می‌گوید به چه چیزی نیاز دارد. وقتی تأییدش کنید، پنل دقیقاً همان را به افزونه می‌دهد و نه بیشتر:
| چه چیزی | برای چه |
|---|---|
| یک توکن API | فراخوانی API پنل، محدود به دسترسی‌هایی که مانیفست می‌خواهد، هر کدام با دلیلی که ذکر می‌کند. توکن یک نرخ درخواست هم دارد که پیش از تأیید نشان داده می‌شود. |
| اشتراک رویدادها | یک وبهوک روی افزونه که رویدادهای درخواستی‌اش را دریافت می‌کند، مثل ساخته شدن یا منقضی شدن یک کاربر، و هر تحویل امضاشده است. |
| بررسی سلامت | پنل هر دقیقه مسیر سلامت افزونه را می‌پرسد و وقتی دیگر جواب ندهد آن را ناسالم علامت می‌زند. |
| لینکی به رابطش | ردیف افزونه در صفحهٔ افزونه‌ها دکمهٔ باز کردن دارد که رابط خود افزونه را در زبانهٔ تازه‌ای باز می‌کند. |
توکن و وبهوک زیر توکن‌های API و وب‌هوک‌ها با علامت افزونه نمایش داده می‌شوند، و فقط از صفحهٔ افزونه‌ها قابل تغییر یا حذف‌اند. تعلیق افزونه هر دو را هم‌زمان متوقف می‌کند. نگهداری روزمرهٔ یک افزونهٔ ثبت‌شده (سلامت، تعلیق، به‌روزرسانی‌هایی که دسترسی بیشتری می‌خواهند) در صفحهٔ افزونه‌ها است؛ اینکه چرا این‌طور ساخته شده در پلتفرم افزونه آمده است.
به‌روزرسانی هرگز بی‌صدا دسترسی را گسترش نمی‌دهد
نسخهٔ تازهٔ افزونه‌ای که دسترسی یا رویداد بیشتری می‌خواهد نصب می‌شود، اما پیش از گرفتن آن‌ها منتظر تأیید شما می‌ماند. تا آن موقع دقیقاً همان چیزی را دارد که داشت.
هر افزونه تا چه حد مورد اعتماد است
دایرکتوری افزونه‌ها در addons.nexora-panel.org هر افزونه را در یکی از سه سطح فهرست می‌کند:
| سطح | سازنده | روش نصب |
|---|---|---|
| رسمی | نکسورا. مانیفستش با کلید نکسورا امضا شده است. | با پنل روی سرور خودش، با SSH، یا با دستوری که خودتان اجرا می‌کنید |
| تأییدشده | توسعه‌دهنده‌ای دیگر، بازبینی‌شده توسط نکسورا. مانیفستش با کلید توسعه‌دهنده امضا شده که دایرکتوری آن را تضمین می‌کند. صفحهٔ تأیید نام توسعه‌دهنده را نشان می‌دهد. | مثل رسمی |
| غیررسمی | توسعه‌دهنده‌ای دیگر، فقط بعد از یک بررسی سبک فهرست شده. | با دستوری که خودتان اجرا می‌کنید، همراه با هشدار روی کارتش و در صفحهٔ تأیید |
افزونه‌ای که این پنل نمی‌تواند از روی امضایش به آن اعتماد کند باز هم قابل استفاده است: آن را دستی با افزودن افزونهٔ خودتان اضافه می‌کنید و توکن و وبهوکش را خودتان می‌سازید. اسکریپت یا بات شخصی‌ای را هم که هیچ‌وقت سراغ دایرکتوری نمی‌رود همین‌طور وصل می‌کنید.
WARNING
افزونه با دسترسی‌هایی که به آن می‌دهید روی سرور شما اجرا می‌شود. پیش از زدن تأیید و ثبت، آنچه را در صفحهٔ تأیید می‌خواهد بخوانید، به‌ویژه برای افزونهٔ غیررسمی.
افزونه‌هایی که نکسورا منتشر می‌کند
| افزونه | چه می‌کند |
|---|---|
| Nexora Shop | پلن‌هایتان را از راه یک بات تلگرام و یک وب‌اپ می‌فروشد: محصولات، سفارش‌ها، کیف پول، پرداخت کارت‌به‌کارت و درگاه، کدهای تخفیف، معرفی دوستان و نماینده‌ها. |
| اطلاع‌رسان | به هر کاربر پنل دربارهٔ حسابش خبر می‌دهد (انقضا، ترافیک، تمدید) و پیام‌های خودتان را می‌فرستد، از راه تلگرام، بله، پیامک، ایمیل یا هر API مبتنی بر HTTP. |
از کجا شروع کنید
- برای نصب یکی، نصب افزونه را برای راه کوتاه بخوانید، و بعد دایرکتوری افزونه‌ها را برای همهٔ راه‌های نصب، به‌روزرسانی و حذف.
- برای نگهداری افزونه‌ای که از قبل اجرا می‌کنید، صفحه‌ی افزونه‌ها را ببینید.
- برای نوشتن افزونهٔ خودتان، با ساختن افزونه شروع کنید و مانیفست افزونه را کنارش باز نگه دارید.