مراجعة توافق XOOPS 2.7.0 لهذا الدليل

تسرد هذه الوثيقة التغييرات المطلوبة في هذا الملف التخزيني بحيث يتطابق دليل التثبيت مع XOOPS 2.7.0.

أساس المراجعة:

• مستودع الدليل الحالي: L:\GitHub\XoopsDocs\xoops-installation-guide
• نواة XOOPS 2.7.0 التي تم مراجعتها في: L:\GitHub\MAMBAX7\CORE\XoopsCore27
• مصادر 2.7.0 الأساسية المدققة:
  • README.md
  • release_notes.txt
  • htdocs/install/language/english/welcome.php
  • htdocs/install/include/config.php
  • htdocs/install/include/page.php
  • htdocs/install/class/pathcontroller.php
  • htdocs/install/page_dbsettings.php
  • htdocs/install/page_configsave.php
  • htdocs/install/page_siteinit.php
  • htdocs/install/page_end.php
  • htdocs/mainfile.dist.php
  • upgrade/preflight.php
  • upgrade/README.md
  • upgrade/upd_2.5.11-to-2.7.0/index.php

النطاق

يحتوي هذا المستودع حاليا على:

• ملفات Markdown الإنجليزية على مستوى الجذر المستخدمة كدليل رئيسي.
• نسخة جزئية من en/.
• أشجار كتب كاملة de/ و fr/ مع أصولها الخاصة.

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

1. التغييرات العالمية للمستودع

1.1 إصدار البرنامج والبيانات الوصفية

قم بتحديث جميع مراجع مستوى الدليل من XOOPS 2.5.x إلى XOOPS 2.7.0.

الملفات المتأثرة:

• README.md
• SUMMARY.md — جدول المحتويات الحي الأساسي للدليل الجذر؛ تحتاج علامات التنقل والعناوين الرئيسية إلى مطابقة عناوين الفصول الجديدة وقسم ملاحظات الترقية المعاد تسميته
• en/README.md
• en/SUMMARY.md
• de/README.md
• de/SUMMARY.md
• fr/README.md
• fr/SUMMARY.md
• chapter-2-introduction.md
• about-xoops-cms.md
• appendix-1-working-with-the-new-admin-gui-our-dashboard.md
• appendix-5-increase-security-of-your-xoops-installation.md
• de/book/*.md و fr/book/*.md المحلية

التغييرات المطلوبة:

• غير for XOOPS 2.5.7.x إلى for XOOPS 2.7.0.
• قم بتحديث سنة حقوق النشر من 2018 إلى 2026.
• استبدل مراجع XOOPS 2.5.x و 2.6.0 القديمة حيث تصف الإصدار الحالي.
• استبدل التوجيه القديم لتنزيل SourceForge بـ GitHub Releases:
  • https://github.com/XOOPS/XoopsCore27/releases

1.2 تحديث الرابط

لا تزال ملفات about-xoops-cms.md و 10aboutxoops.md المحلية تشير إلى مواقع GitHub القديمة من 2.5.x و 2.6.0. يجب تحديث هذه الروابط إلى مواقع المشروع الحالية 2.7.x.

1.3 تحديث لقطات الشاشة

جميع لقطات الشاشة التي تعرض المثبت وواجهة الترقية لوحة المسؤول ومحدد المواضيع ومحدد الوحدات والشاشات ما بعد التثبيت قديمة.

أشجار الأصول المتأثرة:

• .gitbook/assets/
• en/assets/
• de/assets/
• fr/assets/

هذا تحديث كامل وليس جزئي. يستخدم المثبت 2.7.0 تخطيطا مختلفا قائما على Bootstrap وهيكل بصري مختلف.

2. الفصل 2: المقدمة

ملف:

• chapter-2-introduction.md

2.1 يجب إعادة كتابة متطلبات النظام

يقول الفصل الحالي فقط Apache و MySQL و PHP. XOOPS 2.7.0 له الحد الأدنى الصريح:

المكون	الحد الأدنى 2.7.0	توصية 2.7.0
PHP	8.2.0	8.4+
MySQL	5.7.8	8.4+
خادم الويب	أي خادم يدعم PHP المطلوب	Apache أو Nginx موصى به

الملاحظات المراد إضافتها:

• لا تزال IIS مدرجة في المثبت كخيار ممكن، لكن Apache و Nginx هما الأمثلة الموصى بها.
• تشير ملاحظات الإصدار أيضا إلى توافق MySQL 9.0.

2.2 إضافة قائمة فحص امتدادات PHP المطلوبة والموصى بها

يفصل المثبت 2.7.0 الآن المتطلبات الصعبة عن الامتدادات الموصى بها.

فحوصات مطلوبة يظهرها المثبت:

• MySQLi
• Session
• PCRE
• filter
• file_uploads
• fileinfo

الامتدادات الموصى بها:

• mbstring
• intl
• iconv
• xml
• zlib
• gd
• exif
• curl

2.3 إزالة تعليمات المجموع الاختباري

الخطوة 5 الحالية تصف checksum.php و checksum.mdi. هذه الملفات ليست جزءا من XOOPS 2.7.0.

الإجراء:

• قم بإزالة قسم التحقق من المجموع الاختباري بالكامل.

2.4 تحديث تعليمات الحزمة والتحميل

احتفظ بوصف تخطيط الحزمة docs/، extras/، htdocs/، upgrade/، لكن قم بتحديث النص الخاص بالتحميل والتحضير لعكس توقعات المسار القابلة للكتابة الحالية:

• mainfile.php
• uploads/
• uploads/avatars/
• uploads/files/
• uploads/images/
• uploads/ranks/
• uploads/smilies/
• xoops_data/caches/
• xoops_data/caches/xoops_cache/
• xoops_data/caches/smarty_cache/
• xoops_data/caches/smarty_compile/
• xoops_data/configs/
• xoops_data/configs/captcha/
• xoops_data/configs/textsanitizer/
• xoops_data/data/
• xoops_data/protector/

يقلل الدليل الحالي من هذا.

2.5 استبدل لغة ترجمة/تنزيل SourceForge

لا يزال النص الحالي يقول زيارة XOOPS على SourceForge للحصول على حزم اللغات الأخرى. يجب استبدال هذا بتوجيهات التنزيل الحالية للمشروع/المجتمع.

3. الفصل 3: فحص تكوين الخادم

ملف:

• chapter-3-server-configuration-check.md

التغييرات المطلوبة:

• أعد كتابة وصف الصفحة حول التخطيط الحالي المكون من كتلتين:
  • المتطلبات
  • الامتدادات الموصى بها
• استبدل لقطة الشاشة القديمة.
• وثّق بشكل صريح فحوصات المتطلبات المذكورة أعلاه.

4. الفصل 4: اختر المسار الصحيح

ملف:

• chapter-4-take-the-right-path.md

التغييرات المطلوبة:

• أضف حقل Cookie Domain الجديد.
• قم بتحديث أسماء ووصف حقول المسار لمطابقة 2.7.0:
  • XOOPS Root Path
  • XOOPS Data Path
  • XOOPS Library Path
  • XOOPS URL
  • Cookie Domain
• أضف ملاحظة حول أن تغيير مسار المكتبة يتطلب الآن محمل تحميل تلقائي Composer صحيح في vendor/autoload.php.

هذا فحص التوافق الحقيقي في 2.7.0 ويجب توثيقه بوضوح. الدليل الحالي لا يذكر Composer على الإطلاق.

5. الفصل 5: اتصالات قاعدة البيانات

ملف:

• chapter-5-database-connections.md

التغييرات المطلوبة:

• احتفظ بالبيان بأن MySQL فقط هو المدعوم.
• قم بتحديث قسم تكوين قاعدة البيانات ليعكس:
  • مجموعة الأحرف الافتراضية الآن utf8mb4
  • تحديثات اختيار التجميع ديناميكيا عند تغيير مجموعة الأحرف
• استبدل لقطات الشاشة لصفحات اتصال قاعدة البيانات والتكوين.

النص الحالي القائل بأن مجموعة الأحرف والتجميع لا يحتاج إلى الاهتمام ضعيف جدا لـ 2.7.0. يجب على الأقل أن يذكر الافتراضي utf8mb4 الجديد ومحدد التجميع الديناميكي.

6. الفصل 6: التكوين النهائي للنظام

ملف:

• chapter-6-final-system-configuration.md

6.1 تغيرت الملفات المكونة المنشأة

يقول الدليل الحالي إن المثبت يكتب mainfile.php و secure.php.

في 2.7.0 يثبت أيضا ملفات التكوين في xoops_data/configs/، بما في ذلك:

• xoopsconfig.php
• ملفات تكوين Captcha
• ملفات تكوين مجرد النص

6.2 ملفات التكوين الموجودة في xoops_data/configs/ لم يتم استبدالها

سلوك عدم الاستبدال مسموح وليس عالميا. يكتب مساران مختلفان للكود في page_configsave.php ملفات التكوين:

• writeConfigurationFile() (يُستدعى في السطور 59 و 66) دائما يعيد توليد xoops_data/data/secure.php و mainfile.php من إدخال المعالج. لا يوجد فحص الوجود؛ يتم استبدال نسخة موجودة.
• copyConfigDistFiles() (يُستدعى في السطر 62، معرّف في السطر 317) ينسخ فقط ملفات xoops_data/configs/ (xoopsconfig.php، تكوينات Captcha، تكوينات مجرد النص) إذا كان الوجهة غير موجودة بالفعل.

يجب أن يعكس إعادة الفصل كلا السلوكين بوضوح:

• لـ mainfile.php و secure.php: حذر بأن أي تحرير يدوي لهذه الملفات سيتم الكتابة فوقه عند إعادة تشغيل المثبت.
• لملفات xoops_data/configs/: اشرح أن التخصيصات المحلية محفوظة عبر إعادات التشغيل والترقيات، وأن استعادة الافتراضيات المشحونة تتطلب حذف الملف وإعادة التشغيل (أو نسخ ملف .dist.php المقابل يدويا).

لا تعمم “يتم الحفاظ على الملفات الموجودة” عبر جميع ملفات التكوين المكتوبة بواسطة المثبت — هذا غير صحيح وسيضلل المسؤولين الذين يحررون mainfile.php أو secure.php.

6.3 تغير معالجة HTTPS والوسيط العكسي

يدعم mainfile.php المُنشأ الآن كشف البروتوكول الأوسع، بما في ذلك رؤوس الوسيط العكسي. يجب أن يذكر الدليل هذا بدلا من الإشارة إلى كشف http أو https المباشر فقط.

6.4 عدد الجداول غير صحيح

يقول الفصل الحالي إن الموقع الجديد ينشئ 32 جدول.

يُنشئ XOOPS 2.7.0 جداول 33. الجدول المفقود هو:

• tokens

الإجراء:

• قم بتحديث العدد من 32 إلى 33.
• أضف tokens إلى قائمة الجداول.

7. الفصل 7: إعدادات الإدارة

ملف:

• chapter-7-administration-settings.md

7.1 وصف واجهة كلمة المرور قديم

لا يزال المثبت يتضمن توليد كلمات المرور، لكنه يتضمن الآن أيضا:

• مقياس قوة كلمة المرور القائم على zxcvbn
• تسميات قوة بصرية
• مولد نسخ 16 حرف وتدفق النسخ

قم بتحديث النص والصور لوصف لوحة كلمات المرور الحالية.

7.2 يتم فرض التحقق من صحة البريد الإلكتروني الآن

يتم التحقق من صحة بريد المسؤول باستخدام FILTER_VALIDATE_EMAIL. يجب أن يذكر الفصل أن قيم البريد الإلكتروني غير الصحيحة مرفوضة.

7.3 قسم مفتاح الترخيص خاطئ

هذا واحد من أهم الإصلاحات الواقعية.

يقول الدليل الحالي:

• هناك License System Key
• يتم تخزينها في /include/license.php
• /include/license.php يجب أن يكون قابلا للكتابة أثناء التثبيت

هذا لم يعد دقيقا.

ما يفعله 2.7.0 بالفعل:

• التثبيت يكتب بيانات الترخيص إلى xoops_data/data/license.php
• htdocs/include/license.php الآن مجرد غلاف مهمل يحمل الملف من XOOPS_VAR_PATH
• يجب إزالة النص القديم حول جعل /include/license.php قابلا للكتابة

الإجراء:

• أعد كتابة هذا القسم بدلا من حذفه.
• قم بتحديث المسار من /include/license.php إلى xoops_data/data/license.php.

7.4 قائمة المواضيع قديمة

لا يزال الدليل الحالي يشير إلى Zetagenesis ومجموعة المواضيع الأقدم من عصر 2.5.

المواضيع الموجودة في XOOPS 2.7.0:

• default
• xbootstrap
• xbootstrap5
• xswatch4
• xswatch5
• xtailwind
• xtailwind2

لاحظ أيضا:

• xswatch4 هو موضوع البيانات الحالي الافتراضي الذي يدرجه المثبت.
• لم يعد Zetagenesis جزءا من قائمة المواضيع المعبأة.

7.5 قائمة الوحدات قديمة

الوحدات الموجودة في حزمة 2.7.0:

• system — تُثبت تلقائيا أثناء خطوات ملء الجداول / إدراج البيانات. موجودة دائما، لم تُرها أبدا في محدد.
• debugbar — قابلة للاختيار في خطوة المثبت.
• pm — قابلة للاختيار في خطوة المثبت.
• profile — قابلة للاختيار في خطوة المثبت.
• protector — قابلة للاختيار في خطوة المثبت.

مهم: تبني صفحة مثبت الوحدة (htdocs/install/page_moduleinstaller.php) قائمة المرشحين الخاصة بها بتكرار XoopsLists::getModulesList() و تصفية أي شيء موجود بالفعل في جدول الوحدات (السطور 95-102 تجمع $listed_mods؛ يتخطى السطر 116 أي دليل موجود في تلك القائمة). لأن system مثبتة قبل تشغيل هذه الخطوة، فهي لا تظهر أبدا كخانة اختيار.

التغييرات المطلوبة بالدليل:

• توقف عن القول بأن هناك ثلاث وحدات معبأة فقط.
• صف خطوة المثبت كعرض أربع وحدات قابلة للاختيار (debugbar, pm, profile, protector)، وليس خمس.
• وثق system بشكل منفصل كوحدة نواة مثبتة دائما لا تظهر في محدد.
• أضف debugbar إلى وصف الوحدة المعبأة كجديد في 2.7.0.
• لاحظ أن الاختيار الافتراضي للوحدة في المثبت الآن فارغ؛ الوحدات متاحة للاختيار، لكنها غير مختارة مسبقا بواسطة تكوين المثبت.

8. الفصل 8: جاهز للذهاب

ملف:

• chapter-8-ready-to-go.md

8.1 يحتاج عملية تنظيف التثبيت إلى إعادة كتابة

يقول الدليل الحالي إن المثبت ينعيد تسمية مجلد التثبيت إلى اسم فريد.

هذا لا يزال صحيح في الواقع، لكن الآلية تغيرت:

• يتم إنشاء نص تنظيف خارجي في جذر الويب
• الصفحة النهائية تشغل التنظيف عبر AJAX
• يتم إعادة تسمية مجلد التثبيت إلى install_remove_<unique suffix>
• الاحتياطية إلى cleanup.php لا تزال موجودة

الإجراء:

• قم بتحديث الشرح.
• احتفظ بتعليمات المستخدم بسيطة: احذف مجلد التثبيت الذي تمت إعادة تسميته بعد التثبيت.

8.2 مراجع ملحق لوحة مسؤول قديمة

لا يزال الفصل 8 يوجه القراء نحو تجربة المسؤول القديمة من عصر الأكسجين. يجب أن تتماشى مع مواضيع المسؤول الحالية:

• default
• dark
• modern
• transition

8.3 تحتاج إرشادات تحرير المسار بعد التثبيت إلى التصحيح

يخبر النص الحالي القراء بتحديث secure.php مع تعريفات المسار. في 2.7.0، يتم تحديد ثوابت المسار هذه في mainfile.php، بينما يحتل secure.php البيانات الآمنة. يجب تصحيح كتلة المثال في هذا الفصل وفقا لذلك.

8.4 يجب إضافة إعدادات الإنتاج

يجب أن يذكر الدليل بشكل صريح إعدادات الإنتاج الموجودة الآن في mainfile.dist.php:

• XOOPS_DB_LEGACY_LOG يجب أن تبقى false
• XOOPS_DEBUG يجب أن تبقى false

9. الفصل 9: ترقية تثبيت XOOPS الموجودة

ملف:

• chapter-9-upgrade-existing-xoops-installation.md

يتطلب هذا الفصل أكبر إعادة كتابة.

9.1 أضف خطوة Smarty 4 Preflight الإجبارية

تدفق ترقية XOOPS 2.7.0 الآن يفرض عملية الفحص المسبق قبل اكتمال الترقية.

تدفق جديد مطلوب:

1. انسخ المجلد upgrade/ إلى جذر الموقع.
2. قم بتشغيل /upgrade/preflight.php.
3. امسح /themes/ و /modules/ عن بحث عن بناء جملة Smarty القديم.
4. استخدم وضع الإصلاح الاختياري حيث يكون مناسبا.
5. أعد التشغيل حتى صافية.
6. تابع إلى /upgrade/.

لا يذكر الفصل الحالي هذا على الإطلاق، مما يجعله غير متوافق مع إرشادات 2.7.0.

9.2 استبدل السرد الخطي لعصر 2.5.2

لا يزال الفصل الحالي يصف ترقية يدوية بأسلوب 2.5.2 مع دمج إطار العمل وملاحظات AltSys وإعادة هيكلة الملفات المدارة يدويا. يجب استبدال هذا بتسلسل الترقية الفعلي 2.7.x من release_notes.txt و upgrade/README.md.

مخطط الفصل الموصى به:

1. نسخ احتياطي من الملفات وقاعدة البيانات.
2. إيقاف الموقع.
3. انسخ htdocs/ فوق جذر النشر.
4. انسخ htdocs/xoops_lib إلى مسار المكتبة النشط.
5. انسخ htdocs/xoops_data إلى مسار البيانات النشط.
6. انسخ upgrade/ إلى جذر الويب.
7. قم بتشغيل preflight.php.
8. قم بتشغيل /upgrade/.
9. أكمل طلبات المحدث.
10. قم بتحديث وحدة system.
11. قم بتحديث pm, profile, و protector إذا تم التثبيت.
12. احذف upgrade/.
13. أعد تشغيل الموقع.

9.3 وثق تغييرات ترقية 2.7.0 الحقيقية

يتضمن محدث 2.7.0 على الأقل هذه التغييرات الملموسة:

• إنشاء جدول tokens
• توسيع bannerclient.passwd لهاشات كلمات المرور الحديثة
• إضافة إعدادات تفضيل ملف تعريف الجلسة
• إزالة الدلائل المدمجة المهجورة

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

10. صفحات الترقية التاريخية

الملفات:

• upgrading-from-xoops-2.4.5-easy-way.md
• upgrading-from-xoops-2.0.-above-2.0.14-and-2.2..md
• upgrading-from-any-xoops-2.0.7-to-2.0.13.2.md
• upgrading-a-non-utf-8-site.md
• upgrading-xoopseditor-package.md

الحالة: تم حل القرار الهيكلي بالفعل — يحرك SUMMARY.md الجذر هذه إلى قسم ملاحظات الترقية التاريخية مخصص، وتحمل كل ملف دعوة “مرجع تاريخي” توجه القراء إلى الفصل 9 لترقيات 2.7.0. لم تعد إرشادات ترقية من الدرجة الأولى.

العمل المتبقي (الاتساق فقط):

• تأكد من أن README.md (الجذر) يسرد هذه تحت نفس عنوان “ملاحظات الترقية التاريخية”، وليس تحت رأس “ترقيات” عام.
• اعكس نفس الفصل في de/README.md, de/SUMMARY.md, fr/README.md, fr/SUMMARY.md, و en/SUMMARY.md.
• تأكد من أن كل صفحة ترقية تاريخية (جذر والنسخ المحلية de/book/upg*.md / fr/book/upg*.md) تحمل دعوة محتوى مهجور يربط مرة أخرى إلى الفصل 9.

11. الملحق 1: واجهة المسؤول الرسومية

ملف:

• appendix-1-working-with-the-new-admin-gui-our-dashboard.md

يرتبط هذا الملحق بـ Oxygen Admin GUI ويحتاج إلى إعادة كتابة.

التغييرات المطلوبة:

• استبدل جميع مراجع Oxygen
• استبدل صور القائمة والرمز القديمة
• وثق مواضيع المسؤول الحالية:
  • default
  • dark
  • modern
  • transition
• اذكر قدرات المسؤول الحالية 2.7.0 المذكورة في ملاحظات الإصدار:
  • قدرة تحميل القالب في مواضيع المسؤول نظام
  • مجموعة مواضيع المسؤول المحدثة

12. الملحق 2: تحميل XOOPS عبر FTP

ملف:

• appendix-2-uploading-xoops-via-ftp.md

التغييرات المطلوبة:

• إزالة افتراضات HostGator محددة و cPanel محددة
• حداثة نص تحميل الملف
• لاحظ أن xoops_lib يتضمن الآن اعتماديات Composer، لذلك التحميلات أكبر ولا يجب أن تكون مشذوب بشكل انتقائي

13. الملحق 5: الأمان

ملف:

• appendix-5-increase-security-of-your-xoops-installation.md

التغييرات المطلوبة:

• إزالة نقاش register_globals بالكامل
• إزالة لغة تذكرة الضيف المهجورة
• تصحيح نص الأذونات من 404 إلى 0444 حيث يُقصد القراءة فقط
• تحديث المناقشة mainfile.php و secure.php لمطابقة تخطيط 2.7.0
• أضف سياق ثابت جديد متعلق بأمان المجال الذي:
  • XOOPS_COOKIE_DOMAIN_USE_PSL
  • XOOPS_COOKIE_DOMAIN
• أضف إرشادات الإنتاج لـ:
  • XOOPS_DB_LEGACY_LOG
  • XOOPS_DEBUG

14. تأثير الصيانة عبر اللغات

بعد إصلاح ملفات اللغة الإنجليزية على مستوى الجذر، يلزم تحديثات مكافئة في:

• de/book/
• fr/book/
• de/README.md
• fr/README.md
• de/SUMMARY.md
• fr/SUMMARY.md

تحتاج شجرة en/ أيضا إلى المراجعة لأنها تحتوي على README و مجموعة أصول منفصلة، لكنها تبدو أنها تحتوي فقط على شجرة جزئية book/.

15. ترتيب الأولويات

حرج قبل الإصدار

1. تحديث مراجع المستودع/الإصدار إلى 2.7.0.
2. أعد كتابة الفصل 9 حول تدفق ترقية 2.7.0 الحقيقي والفحص المسبق لـ Smarty 4.
3. قم بتحديث متطلبات النظام إلى PHP 8.2+ و MySQL 5.7.8+.
4. صحح مسار ملف مفتاح الترخيص بالفصل 7.
5. صحح مخزونات المواضيع والوحدات.
6. صحح عدد الجدول بالفصل 6 من 32 إلى 33.

مهم للدقة

7. أعد كتابة إرشادات المسار القابلة للكتابة.
8. أضف متطلب محمل Composer التلقائي إلى إعداد المسار.
9. قم بتحديث إرشادات مجموعة أحرف قاعدة البيانات إلى utf8mb4.
10. صحح إرشادات تحرير المسار بالفصل 8 بحيث يتم توثيق الثوابت في الملف الصحيح.
11. إزالة تعليمات المجموع الاختباري.
12. إزالة register_globals وإرشادات PHP الأخرى المحدودة.

تنظيف جودة الإصدار

13. استبدل جميع صور مثبت والمسؤول.
14. انقل صفحات ترقية تاريخية خارج التدفق الرئيسي.
15. قم بمزامنة نسخ ألمانية وفرنسية بعد تصحيح الإنجليزية.
16. قم بتنظيف الروابط المهجورة والخطوط المهجورة README المكررة.