# تثبيت التطبيقات وإدارتها على متجرك

**القسم:** تطبيقات المطورين  ·  **أدنى خطة:** يحددها كل تطبيق  ·  **من يثبّته:** صاحب المتجر

التطبيق خدمة يصنعها مطوّر من خارج DZBuild وتعمل على متجرك عبر DZBuild API. تثبّته من موقع التطبيق نفسه: تعرض عليك DZBuild شاشة موافقة فيها قائمة بما سيستطيع التطبيق فعله، ولا يحصل التطبيق على أي وصول قبل موافقتك. بعد التثبيت يصبح لكل تطبيق صفحة في لوحة التحكم ترى فيها ما غيّره، وتتراجع عن أي تغيير، وتزيل التطبيق.

## أين تظهر التطبيقات[​](#أين-تظهر-التطبيقات "رابط مباشر إلى أين تظهر التطبيقات")

افتح **لوحة التحكم → الإضافات** على [`/dashboard/addons`](https://dzbuild.com/dashboard/addons). للتطبيقات قسم خاص بها هو **تطبيقات المطورين**، تحت الإضافات القابلة للتثبيت في [كتالوج الإضافات](https://dzbuild.com/ar/ar/docs/addons/overview.md). يظهر هذا القسم عندما تعرض DZBuild تطبيقاً لكل المتاجر أو عندما يكون تطبيق مثبّتاً على متجرك. والتطبيق الذي ثبّته يبقى في هذا القسم حتى لو أوقفته DZBuild أو توقفت عن عرضه، لكي تتمكن دائماً من إزالته.

تعرض كل بطاقة اسم التطبيق ووصفه وعبارة **من تطوير** مع اسم المطوّر، وإحدى هذه الحالات:

| ما تعرضه البطاقة                            | ماذا يعني                                                                                                                                                                         |
| ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **متاح** وزر **تثبيت**                      | يمكنك تثبيت التطبيق. زر **تثبيت** يفتح موقع التطبيق في علامة تبويب جديدة، ومنه يبدأ التثبيت.                                                                                      |
| اسم خطة مثل **PRO** وزر **الترقية إلى Pro** | يحتاج التطبيق هذه الخطة. إذا كان مثبّتاً من قبل فإنه يتوقف عن العمل على هذا المتجر حتى تقوم بالترقية، ويبقى زر **إدارة** على البطاقة لتتمكن من إزالته.                            |
| **فتح** و**إدارة**                          | التطبيق مثبّت على هذا المتجر. زر **فتح**، إن كان التطبيق يوفّره، يفتح التطبيق في علامة تبويب جديدة ويخبره بالمتجر الذي تعمل عليه. وزر **إدارة** يفتح صفحة التطبيق في لوحة التحكم. |
| **موقوف**                                   | أوقفت DZBuild التطبيق ولم يعد يصل إلى متجرك. زر **إدارة** يتيح لك إزالته.                                                                                                         |

## كيف تثبّت تطبيقاً[​](#كيف-تثبّت-تطبيقاً "رابط مباشر إلى كيف تثبّت تطبيقاً")

1. اضغط **تثبيت** على بطاقة التطبيق، أو ادخل إلى موقع التطبيق مباشرة، وابدأ التثبيت من هناك. إذا لم تكن مسجّل الدخول إلى DZBuild فسجّل الدخول أولاً، وبعدها تفتح شاشة الموافقة.
2. تحقّق من أعلى الشاشة: اسم التطبيق، و**من تطوير** مع اسم المطوّر، وموقع التطبيق وبريد الدعم الخاص به. التطبيق الذي راجعته DZBuild يحمل شارة **راجعته DZBuild**.
3. تحت **اختر المتاجر التي يصل إليها**، حدّد متجراً واحداً أو أكثر من متاجرك. أول متجر يمكن استعماله يكون محدداً مسبقاً. التثبيت الواحد يشمل 10 متاجر كحد أقصى.
4. اقرأ **ما يستطيع هذا التطبيق فعله**. يحصل التطبيق على هذه الصلاحيات فقط ولا شيء غيرها.
5. اضغط **موافقة وتثبيت**. تعيدك DZBuild إلى موقع التطبيق الذي يُكمل التثبيت. بعدها يظهر التطبيق في **تطبيقات المطورين** على كل متجر حدّدته.

إذا ضغطت **رفض** بدلاً من ذلك تعود إلى موقع التطبيق دون أن تمنحه أي وصول. وفي آخر الشاشة تذكير بأنك تستطيع إزالة التطبيق في أي وقت من صفحة الإضافات.

المتجر الذي خطته أقل من الخطة الدنيا للتطبيق يظهر باهتاً مع علامة **غير متاح** والخطة التي يحتاجها التطبيق. وإذا لم يكن أي متجر من متاجرك مؤهلاً، تقول الشاشة إن التطبيق لا يمكن تثبيته على متاجرك حالياً. وإذا لم توافق DZBuild على التطبيق أو أوقفته، تظهر لك رسالة "هذا التطبيق غير متاح." بدل شاشة الموافقة.

صاحب المتجر وحده يستطيع تثبيت تطبيق. حساب عضو الفريق يرى **التثبيت متاح لأصحاب المتاجر فقط** ويُطلب منه أن يثبّت صاحب المتجر التطبيق من حسابه.

## ما يمكن السماح للتطبيق بفعله[​](#ما-يمكن-السماح-للتطبيق-بفعله "رابط مباشر إلى ما يمكن السماح للتطبيق بفعله")

تعرض شاشة الموافقة وصفحة التطبيق سطراً واحداً لكل مجال طلبه التطبيق. وإذا طلب التطبيق تغيير مجال ما، ترى سطر التغيير الخاص به. هذه هي الصلاحيات الوحيدة التي يمكن لتطبيق أن يطلبها:

| المجال       | سطر الاطلاع                                                | سطر التغيير                                                                        |
| ------------ | ---------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| المتجر       | الاطلاع على معلومات متجرك وإعداداته                        | الاطلاع على إعدادات متجرك وتصميمه وقالبه وتعديلها                                  |
| المنتجات     | الاطلاع على منتجاتك                                        | الاطلاع على منتجاتك وإنشاؤها وتعديلها وحذفها                                       |
| الطلبات      | عرض الطلبات، قراءة فقط                                     | إنشاء الطلبات وتعديلها                                                             |
| التوصيل      | غير متاح للتطبيقات                                         | إرسال طلباتك إلى شركة التوصيل                                                      |
| الزبائن      | الاطلاع على زبائنك وبياناتهم (الاسم، الهاتف، العنوان)      | غير متاح للتطبيقات                                                                 |
| صفحات الهبوط | الاطلاع على صفحات الهبوط                                   | الاطلاع على صفحات الهبوط وإنشاؤها وتعديلها ونشرها                                  |
| أكواد الخصم  | الاطلاع على أكواد التخفيض                                  | الاطلاع على أكواد التخفيض وإنشاؤها وتعديلها (هذا يغيّر الأسعار التي يدفعها زبائنك) |
| البيكسلات    | الاطلاع على بيكسلات التتبع الإعلاني                        | الاطلاع على بيكسلات التتبع الإعلاني وإضافتها وتعديلها                              |
| الشحن        | الاطلاع على أسعار التوصيل وإعداداته                        | الاطلاع على أسعار التوصيل وتعديلها وربط شركات التوصيل أو فصلها                     |
| الإحصائيات   | الاطلاع على إحصائيات متجرك                                 | غير متاح للتطبيقات                                                                 |
| WhatsApp     | الاطلاع على قوالب رسائل واتساب ورصيدك وسجل الرسائل المرسلة | إرسال رسائل واتساب لزبائنك بخصوص طلباتهم (تُخصم كل رسالة من رصيد واتساب)           |

ثلاثة من هذه المجالات تستحق نظرة ثانية قبل الموافقة:

* **التوصيل.** يستطيع التطبيق إرسال الطلبات إلى شركة التوصيل دون أن تطلب منك DZBuild تأكيد كل إرسال، ولا يوجد زر **تراجع** للإرسال. أما إضافة [Claude](https://dzbuild.com/ar/ar/docs/addons/claude.md) فتنتظر موافقتك على كل إرسال.
* **أكواد الخصم.** الكود الذي ينشئه التطبيق أو يعدّله يُطبَّق على ما يدفعه زبائنك عند الطلب.
* **WhatsApp.** كل رسالة تُدفع من رصيد [مرسل واتساب](https://dzbuild.com/ar/ar/docs/addons/whatsapp-sender.md)، مثل الرسالة التلقائية.

بعض الوصول لا يُتاح لأي تطبيق أبداً. لا توجد صلاحية للتوليد بالذكاء الاصطناعي، لذلك لا يستطيع أي تطبيق صرف نقاط الذكاء الاصطناعي من رصيدك. ولا توجد صلاحية تشمل خطتك ومدفوعاتك، أو فريقك، أو نطاقاتك، أو مفاتيح API الخاصة بك. ولا يستطيع التطبيق التراجع عن التغييرات: زر **تراجع** يبقى بين يديك، في صفحة التطبيق.

## صفحة التطبيق[​](#صفحة-التطبيق "رابط مباشر إلى صفحة التطبيق")

اضغط **إدارة** على بطاقة التطبيق لتفتح صفحته. تعرض الصفحة:

* **تاريخ التثبيت**، و**آخر نشاط** (آخر مرة استعمل فيها التطبيق وصوله، أو **لم يُستخدم بعد**)، و**ثبّته** أي الحساب الذي وافق على التثبيت.
* **ما يستطيع هذا التطبيق فعله**: الصلاحيات التي يملكها التطبيق، بالكلمات نفسها التي في شاشة الموافقة.
* **آخر التغييرات التي أجراها**: آخر 20 تغييراً أجراها التطبيق على متجرك، مع زر **تراجع** بجانب كل تغيير يمكن إرجاعه.
* **الإشعارات المرسلة إلى التطبيق**: هل يرسل متجرك إشعارات إلى التطبيق، وكيف جرى آخر إشعار.
* **إزالة التطبيق**.
* روابط إلى موقع التطبيق وبريد الدعم، وزر **فتح** إن كان التطبيق يوفّره.

التطبيق الذي يستطيع الاطلاع على طلباتك قد يطلب أن يُبلَّغ عند وصول طلب أو تغيّر حالته. عندها تعرض بطاقة الإشعارات **العنوان متحقَّق منه** أو **العنوان لم يُتحقَّق منه بعد**، و**الإرسال متوقف** إذا توقف الإرسال، وعدد المحاولات الفاشلة المتتالية، وآخر إشعار مع حالته: **قيد الإرسال** أو **تم التسليم** أو **فشل التسليم**. والتطبيق الذي لا يستقبل إشعارات يظهر له سطر يقول ذلك.

أعضاء الفريق الذين لديهم صلاحية الإضافات (راجع [الفريق والصلاحيات](https://dzbuild.com/ar/ar/docs/operations/team.md)) يستطيعون فتح هذه الصفحة وفتح التطبيق نفسه. لا يظهر لهم زر **تراجع**، وتقول لهم بطاقة **إزالة التطبيق**: **هذا الإجراء متاح لصاحب المتجر فقط.**

## التراجع عن تغيير أجراه التطبيق[​](#التراجع-عن-تغيير-أجراه-التطبيق "رابط مباشر إلى التراجع عن تغيير أجراه التطبيق")

تشمل القائمة التغييرات على إعدادات متجرك وتصميمه وقالبه وصفحته الرئيسية، والتصنيفات، والمخزون، وأكواد الخصم، والبيكسلات، وأسعار التوصيل وإعداداته، وأقسام صفحات الهبوط. أما التعديلات الأخرى، مثل اسم منتج أو سعره أو حالة طلب، فلا تظهر في القائمة ولا يمكن التراجع عنها من هذه الصفحة.

اضغط **تراجع** بجانب التغيير وأكّد. تعيد DZBuild القيمة التي كانت قبل ذلك التغيير، ويتحول الزر إلى علامة **تم التراجع**. التغيير الذي أنشأ شيئاً جديداً، مثل كود خصم أو تصنيف، ليس له زر **تراجع**: احذف ذلك العنصر من صفحته إن لم تعد تريده. وإذا لم يعد العنصر الذي مسّه التغيير موجوداً، ترفض DZBuild التراجع وتخبرك بالسبب.

## إزالة تطبيق[​](#إزالة-تطبيق "رابط مباشر إلى إزالة تطبيق")

1. افتح صفحة التطبيق بزر **إدارة**.
2. اضغط **إزالة التطبيق** وأكّد.

يفقد التطبيق الوصول إلى المتجر فوراً، وتُلغى الإشعارات التي كانت تنتظر الإرسال إليه. تعود إلى صفحة الإضافات مع رسالة تؤكد إزالة التطبيق. منتجاتك وطلباتك وإعداداتك تبقى كما هي، بما في ذلك ما غيّره التطبيق. تراجع عن تلك التغييرات قبل إزالة التطبيق، لأن صفحته وقائمة تغييراته تختفيان مع التثبيت.

الإزالة تخص المتجر الذي تعمل عليه. إذا كان التطبيق مثبّتاً على عدة متاجر من متاجرك، انتقل إلى كل واحد منها لتزيله منه (راجع [متاجر متعددة](https://dzbuild.com/ar/ar/docs/operations/multi-store.md)). يمكنك تثبيت التطبيق مجدداً لاحقاً من موقعه، وتفتح شاشة الموافقة من جديد.

## كم يكلّف[​](#كم-يكلّف "رابط مباشر إلى كم يكلّف")

لا تضيف DZBuild أي رسوم على تثبيت تطبيق. تعمل التطبيقات في كل الخطط، بما فيها Free، إلا إذا حدد التطبيق خطة دنيا. تظهر تلك الخطة على بطاقة التطبيق، وفي شاشة الموافقة بجانب كل متجر خطته أقل منها؛ ولا يمكن تحديد تلك المتاجر. وإذا نزلت خطة متجر لاحقاً تحت الحد الأدنى للتطبيق، يتوقف التطبيق عن العمل على ذلك المتجر حتى تقوم بالترقية (راجع [الترقيات والنزول](https://dzbuild.com/ar/ar/docs/plans/upgrades.md)).

رسائل WhatsApp التي يرسلها التطبيق تُخصم من رصيدك في مرسل واتساب، كما ذُكر أعلاه.

## للمطوّرين[​](#للمطوّرين "رابط مباشر إلى للمطوّرين")

أدلة بناء تطبيق على DZBuild موجودة على [dzbuild.dev](https://dzbuild.dev).

## أسئلة شائعة[​](#أسئلة-شائعة "رابط مباشر إلى أسئلة شائعة")

**هل يستطيع عضو الفريق تثبيت تطبيق؟** لا. صاحب المتجر وحده يستطيع الموافقة على التثبيت. عضو الفريق الذي يفتح شاشة الموافقة يرى **التثبيت متاح لأصحاب المتاجر فقط** ويُطلب منه أن يثبّت صاحب المتجر التطبيق من حسابه.

**لماذا تعرض صفحة التثبيت رسالة "هذا التطبيق غير متاح"؟** لم توافق DZBuild على التطبيق بعد، أو أوقفته. وإلى أن توافق عليه DZBuild، لا يعمل التطبيق إلا على متاجر مطوّره. تواصل مع مطوّر التطبيق لتعرف متى يصبح متاحاً.

**وافقت على التثبيت لكن التطبيق لا يظهر في تطبيقات المطورين. ماذا أفعل؟** الموافقة تعيدك إلى موقع التطبيق الذي يُكمل التثبيت من جهته. ابدأ التثبيت من جديد من موقع التطبيق. شاشة الموافقة التي تبقى مفتوحة أكثر من 10 دقائق تجيب بأن رابط التثبيت غير صالح أو انتهت صلاحيته، والبدء من جديد من موقع التطبيق يحل ذلك. وإذا بقي التطبيق غائباً، راسل بريد الدعم الظاهر في شاشة الموافقة.

**هل يمكنني منح تطبيق وصولاً إلى بعض متاجري فقط؟** نعم. حدّد تلك المتاجر فقط في شاشة الموافقة، حتى 10 متاجر في كل تثبيت. لكل متجر تثبيته الخاص، لذلك يمكنك إزالة التطبيق من متجر وإبقاؤه على متجر آخر.