סקירת תאימות 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 - חי ראשוני TOC עבור מדריך השורש; תוויות הניווט וכותרות המקטעים צריכות להתאים לכותרות הפרקים החדשות ולקטע ‘הערות שדרוג היסטורי’
• 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:
  • https://github.com/XOOPS/XoopsCore27/releases

1.2 רענון קישור

קבצי about-xoops-cms.md ו-10aboutxoops.md מקומיים עדיין מצביעים על מיקומים ישנים של 2.5.x ו-2.6.0 GitHub. יש לעדכן קישורים אלה למיקומי הפרויקט הנוכחיים של 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

• מושב

• PCRE

• מסנן

• file_uploads

• מידע על הקובץתוספים מומלצים:

• mbstring

• בינלאומי

• iconv

• xml

• זליב

• אלוקים

• exif

• תלתל

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 translation/download

הטקסט הנוכחי עדיין אומר לבקר ב-XOOPS ב-SourceForge עבור חבילות שפה אחרות. זה צריך להיות מוחלף בהנחיה הנוכחית להורדה project/community.

3. פרק 3: בדיקת תצורת שרת

קובץ:

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

שינויים נדרשים:

• כתוב מחדש את תיאור העמוד סביב הפריסה הנוכחית של שני בלוקים:
  • דרישות
  • הרחבות מומלצות
• החלף את צילום המסך הישן.
• תיעד במפורש את בדיקות הדרישות המפורטות לעיל.

4. פרק 4: קח את הנתיב הנכון

קובץ:

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

שינויים נדרשים:

• הוסף את השדה החדש Cookie Domain.
• עדכן את השמות והתיאורים של שדות הנתיב כך שיתאימו ל-2.7.0:
  • XOOPS נתיב שורש
  • XOOPS נתיב נתונים
  • XOOPS נתיב ספרייה
  • XOOPS URL
  • תחום עוגיות
• הוסף הערה ששינוי נתיב הספרייה דורש כעת טוען אוטומטי 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
• קבצי תצורה של textsanitizer

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, הגדרות ה-textsanitizer) אם היעד לא קיים כבר.

שכתוב הפרק חייב לשקף בבירור את שתי ההתנהגויות:- עבור 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 שלב קדם טיסה

זרימת השדרוג 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 עבור גיבוב סיסמא מודרני
• הוסף הגדרות העדפת קובצי Cookie של הפעלה
• הסר ספריות ארוזות מיושנות

המדריך לא צריך לחשוף כל פרט יישום, אבל הוא אמור להפסיק לרמוז שהשדרוג הוא רק העתקת קובץ פלוס עדכון מודול.

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: מנהל מערכת GUI

קובץ:

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

נספח זה קשור ל-Oxygen admin GUI וזקוק לשכתוב.

שינויים נדרשים:

• החלף את כל הפניות החמצן
• החלף צילומי מסך ישנים של icon/menu
• לתעד את נושאי הניהול הנוכחיים:
  • ברירת מחדל
  • חשוך
  • מודרני
  • מעבר
• ציין את יכולות הניהול הנוכחיות של 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. עדכן את הפניות repo/version ל-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 משוכפלים.