---
url: https://docs.ogmabox.com/fa/app/plugins.md
description: >-
  افزونه‌های Ogma را از بسته‌های محلی، پوشه‌ها، بایگانی‌های zip و بازار نصب،
  مدیریت، به‌روزرسانی و توسعه دهید.
---

# افزونه‌ها {#plugins}

افزونه‌ها صفحه‌های رابط کاربری سفارشی، پردازش سمت سرور، قلاب‌های رویداد و پنل‌های تنظیمات را به Ogma اضافه می‌کنند؛ همهٔ این امکانات به مجوزهای اعلام‌شدهٔ افزونه محدودند.

## افزونه‌ها چه امکاناتی اضافه می‌کنند {#what-plugins-can-add}

* صفحه‌های رابط کاربری سفارشی که از پیمایش سمت چپ در دسترس‌اند.
* مسیرهای سمت سرور برای پردازش درخواست‌ها یا پاسخ‌ها.
* قلاب‌های رویداد که با ترافیک ثبت‌شده فعال می‌شوند.
* صفحه‌های تنظیمات برای پیکربندی اختصاصی افزونه.
* فرمان‌هایی که می‌توان در پنل فرمان ثبت کرد.

## نصب از پوشه {#install-from-folder}

1. در نمای افزونه‌ها روی **نصب** کلیک کنید.
2. **مسیر پوشه** را انتخاب کنید.
3. پوشهٔ ریشهٔ افزونه را انتخاب کنید. این پوشه باید شامل یک مانیفست معتبر افزونه و فایل‌هایی باشد که مانیفست اعلام می‌کند.
4. Ogma بسته را اعتبارسنجی و ثبت می‌کند.
5. افزونه را فعال کنید تا شروع به کار کند.

## نصب از بایگانی Zip {#install-from-zip-archive}

1. در نمای افزونه‌ها روی **نصب** کلیک کنید.
2. **فایل ZIP** را انتخاب کنید.
3. فایل `.zip` افزونه را انتخاب کنید.
4. نام و نسخهٔ شناسایی‌شدهٔ افزونه را بررسی کنید.
5. روی **نصب** کلیک کنید، سپس افزونه را فعال کنید.

نصب‌های Zip در پوشهٔ افزونه‌های تحت مدیریت Ogma کپی می‌شوند. پس از نصب می‌توانید بایگانی اصلی را حذف کنید.

## هشدارهای سازگاری {#compatibility-warnings}

پس از نصب، ممکن است Ogma در صفحهٔ جزئیات افزونه هشدارهایی نشان دهد. این هشدارها اطلاع‌رسانی‌اند و مانع اجرای افزونه نمی‌شوند.

هشدارهای رایج:

* **فایل‌های بدون ارجاع** - فایل‌هایی که در بسته موجودند اما مانیفست آن‌ها را اعلام نمی‌کند.
* **نبود لایهٔ سازگاری زمان اجرا** - افزونه از APIای استفاده می‌کند که به لایهٔ سازگاری نیاز دارد و آن لایه در این نسخهٔ Ogma موجود نیست.

پیش از فعال‌کردن افزونه‌ای ناآشنا، هشدارها را بررسی کنید.

## فعال و غیرفعال‌کردن {#enable-and-disable}

کلید **فعال** در ردیف افزونه را تغییر دهید تا افزونه فعال یا غیرفعال شود. افزونه‌های غیرفعال نصب‌شده باقی می‌مانند اما اجرا نمی‌شوند. فعال‌سازی دوباره، افزونه را بدون نصب مجدد برمی‌گرداند.

## زبانه‌های جزئیات افزونه {#plugin-detail-tabs}

یک افزونه را انتخاب کنید تا پنل جزئیات آن باز شود. پنل زبانه‌های زیر را دارد.

| زبانه | محتوا |
|-----|----------|
| نمای کلی | نام، نسخه، نویسنده، توضیحات و منبع افزونه. |
| هشدارها | مشکلات سازگاری شناسایی‌شده هنگام نصب یا فعال‌سازی. |
| مجوزها | مجوزهای درخواستی افزونه و مجوزهایی که Ogma هنگام اجرا اعطا کرده است. |
| فایل‌ها | فهرست فایل‌های بستهٔ افزونه. |
| گزارش رویدادها | خروجی زمان اجرای افزونه، با برجسته‌سازی نحو برای سطرهای گزارش ساختاریافته. |
| رابط کاربری | صفحهٔ سفارشی افزونه که در همان پنل نمایش داده می‌شود. |

## مجوزها {#permissions}

زبانهٔ مجوزها هر مجوز اعلام‌شده در مانیفست افزونه و وضعیت فعلی اعطای آن را نشان می‌دهد. مجوز فراخوانی‌های سمت سرور در سرور اعمال می‌شود. رابط کاربری وضعیت زندهٔ هر مجوز را بازتاب می‌دهد.

اگر افزونه مطابق انتظار عمل نمی‌کند، زبانهٔ مجوزها را بررسی کنید تا مطمئن شوید مجوزهای لازم اعطا شده‌اند.

## حالت توسعه {#dev-mode}

افزونه‌های نصب‌شده از پوشه نشان **توسعه** و دکمهٔ **بارگذاری مجدد** دارند.

روی **بارگذاری مجدد** کلیک کنید تا تغییرات کد بدون نصب مجدد اعمال شوند. افزونه دوباره راه‌اندازی می‌شود و همهٔ قلاب‌ها و مسیرها را دوباره ثبت می‌کند. این چرخهٔ استاندارد کار برای نویسندگان افزونه است.

افزونه‌های حالت توسعه به پوشهٔ منبع متصل می‌مانند. تغییرات فایل‌های آن پوشه در بارگذاری مجدد بعدی اعمال می‌شوند.

## بازار {#marketplace}

زبانهٔ **بازار افزونه‌ها** افزونه‌های جامعهٔ کاربران را از فهرست Awesome Ogma Plugins نشان می‌دهد.

1. فهرست افزونه‌ها را مرور یا جست‌وجو کنید.
2. روی افزونه‌ای کلیک کنید تا توضیحات، نسخه و فرادادهٔ سازگاری آن را ببینید.
3. برای نصب مستقیم روی **نصب** کلیک کنید.
4. اگر نسخهٔ سازگار جدیدتری برای افزونهٔ نصب‌شده از بازار موجود باشد، اقدام به **به‌روزرسانی** تغییر می‌کند.

نصب از بازار برای دریافت بسته به اتصال شبکه نیاز دارد.

## صفحه‌های مرتبط {#related-pages}

* [شروع سریع افزونه](/fa/plugins/quickstart)
* [SDK سمت سرور](/fa/plugins/backend-sdk)
* [SDK رابط کاربری](/fa/plugins/frontend-sdk)