# تثبيت تطبيق على موقعك

Source: https://support.kapsulehost.com/ar-ae/apps-installing

تثبيت تطبيق على موقعك

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

## قبل أن تبدأ

تحتاج إلى شيء واحد: **موقع ويب نشط** على حسابك. يقوم المعالج بالتثبيت على موقع لديك بالفعل، فهو لا ينشئ واحداً. إذا لم يكن لديك أي موقع، سيخبرك المعالج بذلك ويرتبط بك لإنشاء واحد. انظر [إنشاء موقع الويب الأول الخاص بك](https://support.kapsulehost.com/ar-ae/creating-your-first-website).

تحتاج أيضاً إلى إذن **apps:write**، وهو مملوك لمالكي الحسابات والمسؤولين.

> **Warning:** قم بعمل نسخة احتياطية قبل التثبيت على موقع يحتوي بالفعل على محتوى. المعالج يحتوي على شبكة أمان لموقع يحتوي بالفعل على تطبيق، كما هو موضح أدناه، لكن نقطة استعادة يدوية تؤخذ بتعمد تستحق دائماً أكثر من واحدة تؤخذ تلقائياً. انظر [عمل نسخة احتياطية](https://support.kapsulehost.com/ar-ae/taking-a-backup).

## الوصول إلى المعالج

1. انقر على **التطبيقات** في شريط جانب KPanel.
2. انقر على التطبيق الذي تريده.
3. انقر على **تثبيت [التطبيق]** في اللوحة على اليمين.

العنوان المباشر هو `/apps/<app-slug>/install`.

![معالج تثبيت التطبيق في KPanel، مع زر التثبيت في اللوحة على اليمين](https://support.kapsulehost.com/help/screenshots/apps-installing.1f6e023d.webp)

## الخطوة 1: التكوين

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

### الموقع

**التثبيت على الموقع.** اختر من مواقعك النشطة. هنا سيكون التطبيق.

### حساب المسؤول

- **اسم المستخدم للمسؤول.** الافتراضي هو `admin`. هذا هو اسم المستخدم الذي ستسجل دخول به، ويمكنك إضافة المزيد من المستخدمين لاحقاً.
- **كلمة مرور المسؤول.** يتم إنشاء كلمة مرور قوية بـ 16 حرفاً لك في اللحظة التي تحمل فيها الصفحة. **عرض** يكشفها و **إنشاء** يصنع واحدة جديدة. يمكنك أيضاً كتابة كلمة مرورك الخاصة؛ يجب أن تكون 8 أحرف على الأقل.
- **بريد المسؤول الإلكتروني.** اختياري. يُستخدم لتسجيل الدخول وإعادة تعيين كلمة المرور. إذا تركت فارغاً، يتم استخدام بريد حسابك الإلكتروني.

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

### إعدادات الموقع

- **اسم الموقع**، حيث يطلب التطبيق واحداً.
- **اللغة.** اللغة التي تم تعيين التطبيق عليها، المختارة من ستة عشر خياراً تشمل اللغة الإنجليزية (الولايات المتحدة)، الإنجليزية (المملكة المتحدة)، Te Reo Māori، واللغات الأوروبية والآسيوية الرئيسية. هذا يعيّن لغة محتوى التطبيق نفسه، وليس لغة KPanel.

### قاعدة البيانات

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

التطبيقات التي تحتاج قاعدة بيانات يتم توفيرها تلقائياً كجزء من التثبيت.

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

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

انقر على **متابعة**.

## الخطوة 2: المراجعة والتأكيد

تعيد شاشة المراجعة حالة القرارات في قائمة واحدة: التطبيق، الموقع، اسم الموقع، اسم المستخدم للمسؤول، كلمة مرور المسؤول (مع تبديل إظهار أو إخفاء)، بريد المسؤول الإلكتروني، اللغة واسم قاعدة البيانات. الترجمة الفرعية تقول بوضوح: **لا يتم تثبيت أي شيء حتى تؤكد.**

- **تحرير** يعود إلى الخلف لتغيير شيء ما.
- **تأكيد وتثبيت** يبدأ المهمة.

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

## الخطوة 3: التثبيت

ينتقل المعالج إلى عرض التقدم. ستشاهد، بالترتيب:

- **في قائمة الانتظار: انتظار العامل.** مهمتك في قائمة الانتظار وستبدأ قريباً.
- **تثبيت [التطبيق]**، مع ثوان مضاه مقابل وقت التثبيت النموذجي وشريط تقدم.

اترك الصفحة مفتوحة. يستمر التثبيت في الخلفية إذا انتقلت بعيداً، لكنك تفقد العرض المباشر وملخص بيانات الاعتماد في النهاية.

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

### الإلغاء

**إلغاء التثبيت** يوقف المهمة. تؤكد شاشة النتيجة: *تم إيقاف التثبيت. لم يتم تغيير أي شيء على موقعك.*

## عندما يحتوي الموقع بالفعل على تطبيق

إذا كان دليل الموقع المستهدف يحتوي بالفعل على موقع، يتوقف التثبيت برسالة تحذير تذكر ما وجدته:

> يحتوي هذا الدليل بالفعل على [التطبيق]. سيؤدي تثبيت [التطبيق الجديد] إلى الكتابة فوقه ولا يمكن التراجع عنه. سيتم أخذ نسخة احتياطية كاملة من موقعك الحالي أولاً حتى تتمكن من استعادتها.

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

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

## التطبيقات التي يثبتها فريقنا يدوياً

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

> نحن نعد [التطبيق] لك. يحتاج هذا التطبيق إلى إعداد عملي، لذلك يثبته فريقنا على موقعك بعد أن تطلب. سنرسل لك بريداً إلكترونياً في اللحظة التي يكون فيها مباشراً؛ لا يوجد شيء آخر تحتاج إلى فعله.

لم يفشل شيء ولا شيء معلق عليك. التطبيقات مجانية، لذا لا توجد رسوم بأي حال.

## الخطوة 4: أنت مباشر

عند النجاح، يعرض المعالج **[التطبيق] مباشر**، رابط لنطاقك، وملخص بيانات الاعتماد:

- اسم المستخدم للمسؤول
- كلمة مرور المسؤول، مع إظهار أو إخفاء
- بريد المسؤول الإلكتروني
- عنوان الموقع

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

تنهي زرين التدفق: **فتح [التطبيق]** يذهب مباشرة إلى التطبيق، و **العودة إلى التطبيق** يعود إلى صفحة الكتالوج.

## ماذا لو فشل

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

الأسباب الشائعة وما يجب فعله:

- **حدود الموارد.** إذا كان الحد الأدنى من RAM للتطبيق أعلى مما تعطيه خطتك، قد يفشل التثبيت في منتصف الطريق. تحقق من الشكل **Min RAM** على صفحة التطبيق. انظر [ترقية خطتك](https://support.kapsulehost.com/ar-ae/upgrading-your-plan).
- **حقل مرفوض.** يرفض المعالج الإدخال الذي يحتوي على أحرف غير آمنة للقشرة قبل حتى تكون المهمة في قائمة الانتظار، وينقسم الحقل. بسّط القيمة: اسم مستخدم عادي، كلمة مرور تم إنشاؤها، اسم قاعدة بيانات بأحرف وأرقام.
- **الموقع ليس نشطاً.** فقط المواقع ذات الحالة **ACTIVE** تظهر في القائمة المنسدلة للموقع. الموقع الذي لا يزال قيد الإنشاء لن يكون مدرجاً.

**نجح التثبيت لكن الموقع يعرض خطأ.** تحقق من سجل التثبيت للخطوة الفاشلة، ثم تحقق من توثيق التطبيق الخاص به للإعداد بعد التثبيت. التطبيقات المجتمعية بشكل خاص غالباً ما تحتاج إلى تشغيل معالج الإعداد النهائي في المتصفح. انظر [الموقع غير محمل](https://support.kapsulehost.com/ar-ae/website-not-loading).

**فقدت كلمة مرور المسؤول.** استخدم إعادة تعيين كلمة المرور الخاصة بالتطبيق نفسه مع بريد المسؤول الإلكتروني الذي عيّنته. خصيصاً لـ WordPress، انظر [إعادة تعيين كلمة مرور WordPress](https://support.kapsulehost.com/ar-ae/wordpress-reset-password).

**التثبيت عالق في قائمة الانتظار.** طابور المهام مشغول. سيبدأ. إذا كان لا يزال في قائمة الانتظار منذ فترة طويلة جداً بعد وقت التثبيت المتوقع، ألغه وحاول مرة أخرى، ثم [افتح تذكرة دعم](https://support.kapsulehost.com/ar-ae/opening-a-support-ticket) إذا كررت.

## مقالات ذات صلة

- [قائمة التطبيقات](https://support.kapsulehost.com/ar-ae/apps-overview)
- [تثبيت ووردبريس](https://support.kapsulehost.com/ar-ae/installing-wordpress)
- [أخذ نسخة احتياطية](https://support.kapsulehost.com/ar-ae/taking-a-backup)
- [موقعي الإلكتروني لا يتحمل: قائمة التحقق من التشخيص](https://support.kapsulehost.com/ar-ae/website-not-loading)