دليل التثبيت

ينطبق هذا الدليل على جميع مواقع Northbytra: موقع خدمات تقنية المعلومات والصيانة وجميع المواقع القطاعية. يستغرق التثبيت عادةً نحو 30 دقيقة، وتحتاج إلى برنامج FTP (مثل FileZilla) وبيانات الدخول إلى استضافتك.

1. اختر الباقة المناسبة

• الموقع: موقع خدمات تقنية المعلومات والصيانة (صيانة الحواسيب وخدمات تقنية المعلومات وكاميرات المراقبة — مع تتبّع الصيانة عبر الإنترنت) أو موقع قطاعي: مكتب هندسة معمارية، شركة مقاولات وإنشاءات، شركة هندسة ومقاولات كهربائية، استوديو تصميم داخلي، شركة تركيب أنظمة الطاقة الشمسية، مصنع ومعرض أثاث، ورشة صيانة وإصلاح السيارات، مركز الإطارات، خدمات السحب والمساعدة على الطريق، ورشة سمكرة ودهان السيارات، تأجير السيارات، معرض سيارات، أو موقع لنشاطك التجاري لأي قطاع آخر. قارن بينها في صفحة المنتجات والعروض التجريبية المباشرة.
• الإصدار: Standard — طلبات بالدفع عبر التحويل البنكي أو عند الاستلام أو في المتجر. Pro — إضافةً إلى ذلك الدفع بالبطاقة عبر الإنترنت من خلال PayTR أو Stripe. يُثبَّت الإصداران بالطريقة نفسها، ويمكنك الترقية لاحقًا من Standard إلى Pro مع بقاء مفتاح التفعيل كما هو.
• باقة واحدة = قطاع واحد: صُمّم التصميم والقائمة والوحدات والمحتوى التجريبي لكل باقة خصيصًا لقطاعها. يمكنك تغيير جميع النصوص والصور والوحدات من لوحة التحكم، لكن لا يمكن تحويل قطاع الباقة إلى قطاع آخر.
• بعد الدفع تتلقى رسالة بالبريد الإلكتروني فيها رابط صفحة طلبك: هناك تعرض مفتاح التفعيل وتستخدم رابط التنزيل الشخصي، ويمكن بعد انتهاء حق العدول إرسال نسخة من المفتاح إليك بالبريد الإلكتروني أيضًا. يحتوي ملف ZIP على المجلد upload والوثائق (INSTALL.md / KURULUM.md).

2. المتطلبات

• PHP 8.1 أو أحدث مع الإضافات pdo_mysql وsodium وmbstring وfileinfo (ويُنصح بـ gd وintl) — متوفرة افتراضيًا في معظم باقات الاستضافة
• MySQL 5.7+ أو MariaDB 10.3+
• Apache أو LiteSpeed مع mod_rewrite — أو Nginx مع القواعد الواردة في القسم 10
• شهادة SSL لنطاقك (مجانية مع Let's Encrypt لدى معظم شركات الاستضافة)

يتحقق معالج الإعداد من جميع المتطلبات قبل بدء التثبيت.

3. ارفع الملفات عبر FTP

1. فكّ ضغط ملف ZIP على حاسوبك.
2. اتصل باستضافتك عبر FTP — ويُفضَّل SFTP أو FTPS — وارفع محتويات المجلد upload بما فيها ملفات .htaccess المخفية إلى المجلد الجذر لنطاقك (غالبًا public_html أو httpdocs أو htdocs).
3. أنشئ من لوحة الاستضافة قاعدة بيانات MySQL فارغة ومستخدمًا يملك جميع الصلاحيات عليها، ودوّن اسم قاعدة البيانات واسم المستخدم وكلمة المرور.

4. شغّل معالج الإعداد

1. افتح نطاقك في المتصفح — يبدأ المعالج تلقائيًا، ويمكنك تغيير لغته من الأعلى.
2. أدخل بيانات قاعدة البيانات ومعلومات شركتك.
3. اختر اللغة الافتراضية للموقع ولوحة التحكم واللغات التي تريد تقديمها وبلدك / منطقتك — فتُضبط المنطقة الزمنية والعملة ورمز الهاتف وشركات الشحن تلقائيًا.
4. أنشئ حساب المدير وأدخل مفتاح التفعيل (راجع القسم 5).
5. المحتوى التجريبي: اترك الخانة محددة لتبدأ بموقع متكامل — شرائح العرض والخدمات والمشاريع والمنتجات والمدونة والأسئلة الشائعة بعشر لغات. تتضمن المواقع القطاعية صورًا حقيقية (ترخيص Pexels، يُسمح بالاستخدام التجاري)، ويتضمن موقع تقنية المعلومات رسومًا توضيحية أصلية. يمكنك لاحقًا الإبقاء على أي عنصر أو تعديله أو حذفه من لوحة التحكم — أو ألغِ تحديد الخانة لتبدأ بموقع فارغ.
6. بعد انتهاء المعالج احذف المجلد install من الخادم واحتفظ بنسخة احتياطية من app/config.php — ففيه المفتاح الذي يشفّر البيانات الشخصية.

5. فعّل ترخيصك

• التفعيل عبر الإنترنت: أثناء التثبيت يرسل المعالج مفتاحك ونطاقك وإصدار البرنامج إلى خادم التراخيص لدينا، فيرتبط المفتاح بالنطاق المثبَّت عليه الموقع (مع www أو بدونها؛ ويحتاج أي نطاق فرعي آخر إلى ترخيص خاص به).
• رمز التفعيل اليدوي: إذا كان خادمك لا يستطيع الاتصال بالإنترنت (مثلًا لأن جدار الحماية يمنع الاتصالات الصادرة)، يعرض المعالج حقل «رمز التفعيل اليدوي». أرسل إلينا رقم طلبك ونطاقك عبر نموذج التواصل، وستتلقى رمزًا صالحًا لهذا المفتاح وهذا النطاق فقط.
• نطاق واحد لكل ترخيص: يسري كل ترخيص على نطاق واحد فقط ولا يمكن نقله إلى نطاق آخر. ولموقع آخر تحتاج إلى ترخيص جديد.
• يُصدَر مفتاح التفعيل للنطاق الذي تحدده عند الطلب ويعمل عليه فقط (مع www أو بدونها). لا يمكن تثبيت الموقع على localhost أو عناوين محلية أخرى — ثبّته مباشرة على نطاقك.

6. الخطوات الأولى في لوحة التحكم

سجّل الدخول عبر نطاقك/admin وأكمل قائمة التحقق من الإعداد في الصفحة الرئيسية للوحة:

• بيانات الشركة (بيانات الناشر) والشعار ولون العلامة التجارية وقالب التصميم
• خيارات التوصيل وبياناتك البنكية للتحويلات
• قوالب الصفحات القانونية — راجعها وكيّفها مع نشاطك
• استبدل النصوص والصور التجريبية بمحتواك وأوقف الوحدات التي لا تحتاجها

7. البريد الإلكتروني (SMTP) والتحقق بخطوتين

1. افتح إعدادات الموقع ← البريد الإلكتروني، وأدخل خادم SMTP والمنفذ (587 مع STARTTLS أو 465 مع SSL) واسم المستخدم وكلمة المرور وعنوان المرسل لصندوق بريدك، ثم انقر إرسال اختبار إلى نفسي. يتطلب Gmail وMicrosoft 365 كلمة مرور للتطبيقات. تظهر عمليات الإرسال الفاشلة مع رسالة الخطأ في سجل الإرسال ضمن إشعارات البريد الإلكتروني.
2. بمجرد وصول رسائل الاختبار، فعّل التحقق بخطوتين من ملفي الشخصي: بعد كلمة المرور يُؤكَّد كل تسجيل دخول برمز من 6 أرقام يُرسَل إلى بريدك الإلكتروني. احفظ رموز الاسترداد العشرة التي تُعرض مرة واحدة فقط في مكان آمن.

8. لإصدار Pro فقط: الدفع بالبطاقة عبر الإنترنت

1. افتح لوحة التحكم ← الدفع الإلكتروني، واختر PayTR أو Stripe، وأدخل مفاتيح API من حسابك لدى المزوّد (تُحفظ مشفّرة). اترك وضع الاختبار مفعّلًا مؤقتًا.
2. PayTR: أدخل عنوان الإشعارات المعروض في تلك الصفحة في لوحة التاجر لدى PayTR. Stripe: أضف عنوان webhook المعروض هناك والصق مفتاح التوقيع (whsec_…).
3. في خيارات التوصيل حدّد «الدفع بالبطاقة عبر الإنترنت» للخيارات التي يمكن للعملاء فيها الدفع بالبطاقة.
4. نفّذ طلبًا تجريبيًا، ثم أوقف وضع الاختبار وأدخل المفاتيح الفعلية. تُدخَل بيانات البطاقة على صفحة المزوّد الآمنة فقط ولا تصل إلى موقعك أبدًا.

9. التحديث إلى إصدار جديد

يتم حفظ المحتوى والإعدادات والترجمات والطلبات ومفتاح التفعيل الخاص بك في قاعدة البيانات وفي الملف app/config.php — ولا يستبدل التحديث سوى ملفات البرنامج. يبقى ترخيصك كما هو ولا حاجة إلى تفعيل جديد.

قبل أن تبدأ

1. افتح الترخيص في لوحة الإدارة: يعرض السطر *إصدار البرنامج* الإصدار المثبّت حاليًا. اقرأ قسم «الجديد في هذا الإصدار» في INSTALL.md / KURULUM.md ضمن الحزمة الجديدة.
2. نزّل الحزمة الجديدة عبر رابط التنزيل الشخصي الخاص بك. إذا انتهت صلاحية الرابط، فأرسل إلينا رقم طلبك عبر نموذج الاتصال وستتلقى رابطًا جديدًا. استخدم دائمًا الموقع نفسه (القطاع نفسه) والإصدار نفسه (Standard أو Pro) — أو حزمة Pro عند الترقية من Standard إلى Pro.
3. أنشئ نسخة احتياطية: صدّر قاعدة البيانات (phpMyAdmin ← تصدير، أو وظيفة النسخ الاحتياطي في استضافتك) ونزّل الملف app/config.php والمجلد uploads عبر FTP. يحتوي app/config.php على المفتاح الذي يشفّر البيانات الشخصية — ومن دونه لا يمكن قراءة هذه البيانات مجددًا. والأفضل أن تحتفظ بنسخة كاملة من مجلد الموقع.
4. إذا عدّلت ملفات البرنامج بنفسك، فدوّن أسماء الملفات التي عدّلتها: ستستبدلها النسخة الجديدة، وعليك إعادة تطبيق تعديلاتك بعد ذلك.

التحديث

1. فك ضغط ملف ZIP الجديد على جهاز الكمبيوتر.
2. ارفع محتويات المجلد upload عبر FTP إلى المجلد نفسه كما في السابق، واسمح لبرنامج FTP بـالكتابة فوق الملفات الموجودة (بما في ذلك ملفات .htaccess المخفية). لا تحذف أي شيء على الخادم أولًا. لا تحتوي الحزمة على app/config.php ولا على أي من صورك، لذا تبقى إعداداتك والمجلد uploads كما هما.
3. احذف المجلد install من الخادم مرة أخرى.
4. افتح موقعك وسجّل الدخول إلى لوحة الإدارة: يتم تحديث قاعدة البيانات تلقائيًا عند أول زيارة (يستغرق ذلك بضع ثوانٍ). وتحت الترخيص يظهر الآن رقم الإصدار الجديد.

التحقق بعد التحديث

• افتح الصفحة الرئيسية وبعض الصفحات بكل لغة مفعّلة، وأرسل نموذج الاتصال مرة واحدة.
• Pro: أجرِ دفعة تجريبية في الوضع التجريبي لمزوّد الدفع لديك، أو تحقق من إعدادات الدفع.
• هل يبدو التصميم قديمًا أو معطوبًا؟ أعد تحميل الصفحة بالضغط على Ctrl + F5 وأفرغ ذاكرة التخزين المؤقت في استضافتك أو شبكة CDN (مثل LiteSpeed Cache وCloudflare).
• تُضاف اللغات الجديدة في التحديث وهي معطّلة — فعّلها في لوحة الإدارة ضمن اللغات إن أردت استخدامها.

إذا حدث خطأ ما

• صفحة بيضاء أو خطأ 500: انظر إلى أحدث ملف في storage/logs — فالخطأ موصوف فيه.
• للرجوع إلى الإصدار السابق، استعد الملفات وقاعدة البيانات معًا من نسختك الاحتياطية. لا تستخدم أبدًا ملفات برنامج قديمة مع قاعدة بيانات تم تحديثها بالفعل.

10. Nginx

يستخدم Apache وLiteSpeed ملفات .htaccess المرفقة. أما في Nginx فأضف القواعد التالية إلى كتلة server الخاصة بنطاقك (وعدّل مقبس PHP-FPM بما يناسب خادمك):

location / { try_files $uri $uri/ /index.php?$query_string; }
location ~ ^/(app|storage)(/|$) { deny all; }
location ~ ^/install/(?!index\.php$).+\.php$ { deny all; }
location ~ ^/uploads/.*\.(php|phtml|phar|pl|py|cgi|sh)$ { deny all; }
location ~ /\. { deny all; }
location ~* \.(sql|md|log|lock|ini|bak|old|orig|sh|dist|env|json|yml|yaml|key|pem|zip|tar|gz)$ { deny all; }
location ~ \.php$ { include fastcgi_params; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; fastcgi_pass unix:/run/php/php8.2-fpm.sock; }

11. الوضع التجريبي

لعرض الموقع على عملائك أو زملائك دون أي مخاطرة، اضبط 'demo' => true في app/config.php. عندها يستطيع الزوار استكشاف لوحة التحكم كاملة بحساب تجريبي، لكن لا يُحفظ أي تغيير، ويُخفى التحقق بخطوتين، ويعود المحتوى إلى حالته الأصلية تلقائيًا (الفاصل الزمني: demo_reset_minutes). تجد جميع إعدادات الوضع التجريبي في الوثائق المرفقة بالحزمة.

12. حل المشكلات

• جميع الصفحات عدا الرئيسية تعرض الخطأ 404: لم يُرفع ملف .htaccess أو أن mod_rewrite معطّل.
• يعيد الموقع التوجيه إلى عنوان آخر: صحّح base_url في app/config.php.
• لا تصل رسائل البريد: تحقق من إعدادات SMTP واقرأ رسالة الخطأ في سجل الإرسال.
• صفحة بيضاء أو خطأ 500: راجع الملفات في storage/logs.

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