---
url: https://docs.ogmabox.com/ar/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}

* [بدء سريع للإضافات](/ar/plugins/quickstart)
* [SDK الخلفية](/ar/plugins/backend-sdk)
* [SDK الواجهة الأمامية](/ar/plugins/frontend-sdk)