WIZZO CMS היא ליבת PHP (גרסה 8.3) שמריצה מאות אתרים ומערכות בעברית. הליבה יושבת בתיקיית system/ של כל אתר, והאתר עצמו מוסיף עליה קונטרולרים, תבניות ופאנלים של ניהול בתיקיית application/. התיעוד הזה נכתב מתוך הקוד עצמו, ומתאר את מה שהמערכת באמת עושה, כולל המקומות שבהם כדאי להיזהר.
איפה להתחיל
חדשים במערכת? התחילו ב-מה זה WIZZO CMS, המשיכו ל-התקנת אתר חדש ובנו את העמוד הראשון שלכם בעשר דקות. מפתחים ותיקים ימצאו את תקן הקוד ואת רפרנס ה-API מעניינים במיוחד.
מסלולי קריאה#
01הקמת אתרCONFIG_USER, מבנה תיקיות, טבלאות בסיס, .htaccess והתחברות ראשונה לפאנל.
02איך בקשה רצהמ-core.php דרך ROUTER, MODULE ו-PAGE ועד המטמון. הדיאגרמה שכל מפתח צריך בראש.
03קונטרולרים ותבניותwz_controller, מודולים, תבניות Smarty, ערכות נושא ו-PAGE API.
04פאנל ניהול משלכםpanel_table לרשימות, Form ו-FormInput_* לטפסים, הרשאות ותפריט.
05עבודה עם ה-DBDB::sql, בוני השאילתות, טבלאות רב-לשוניות, קידומת CRM_ ודיבוג SQL.
06MCP וסוכני AIנקודת הקצה /system/mcp, טוקנים, קטלוג הכלים וכתיבת כלים לאתר.
07אבטחהמודל ההרשאות, CSRF, העלאות, הצפנה וצ'קליסט הקשחה לפני עלייה לאוויר.
08התקןכללי הקוד, השמות, ה-PR וה-Changelog שכל קוד חדש בליבה ובאתרים צריך לעמוד בהם.
מה יש בליבה#
| תחום | מה מקבלים | איפה בקוד |
|---|---|---|
| ניתוב | כתובות ידידותיות (רגילות ו-Regex), הפניות 301, קונטרולרי מערכת, 404/503 חכמים | collections/ROUTER.php, collections/MODULE.php |
| תצוגה | Smarty 5, ערכות נושא, ניהול נכסים (SCSS, Minify, async/defer), תגיות SEO ו-Schema | collections/PAGE.php, collections/FILES.php, collections/SEO.php |
| נתונים | שכבת DB עם PDO/MySQL, בוני שאילתות, טבלאות רב-לשוניות, לוג SQL | collections/DB.php |
| מטמון | מטמון קבצים לפי פלטפורמה, מטמון עמודים מלא עם gzip ונעילת בנייה, ניקוי אוטומטי | collections/cache_engine.php |
| פאנל ניהול | התחברות עם WIZZO ID, קבוצות והרשאות, תפריט דינמי, רשימות (panel_table), טפסים (Form) עם עשרות סוגי שדות | collections/ADMIN.php, libraries/panel_table.php, libraries/forms/ |
| מדיה | העלאות מאובטחות, תמונות ממוזערות, S3/FTP, ניקוי Cloudflare, עורך תמונה | collections/STORAGE.php |
| רקע | מנהל Cron עם לוגים, תור דואר ותבניות מייל, בריאות מערכת | admin/cron_manager.php, libraries/mail_tpl.php |
| AI | שרת MCP מובנה, קטלוג כלים, סוכנים עם אישורים וזיכרון, צ'אט AI באדמין | controllers/mcp.php, libraries/admin_mcp_tools.php, libraries/ai_agents_lib.php |
| SEO | חבילת SEOK: ממצאים, קניבליזציה, IndexNow, אימות, GEO | libraries/Seo*.php |
| שירותים | Wizzo Market: הפעלת שירותים, מפתחות API, פאנלים של מוצרים | libraries/market_service.php |
| עדכונים | עדכון ליבה עם בדיקות לפני ואחרי, חתימת sha256 וחזרה אחורה | controllers/check_version.php, admin/wizzo_update.php |
איך התיעוד בנוי#
- מדריכים (התחלה, ארכיטקטורה, ניתוב, תבניות וכו') מסבירים מושגים ומראים קוד עובד.
- רפרנס API מפרט כל מתודה ציבורית עם חתימה, פרמטרים וערך חוזר.
- קטעי "שימו לב" מסמנים התנהגות מפתיעה או מסוכנת שמצאנו בקוד. אל תדלגו עליהם.
- כל דף מצוין בגרסת הליבה שממנה נכתב. כשמשהו משתנה בקוד, הדף צריך להשתנות יחד איתו באותו PR.
מוסכמה בתיעוד
נתיבי קבצים מצוינים יחסית ל-api/core/ בריפו (שהוא system/ באתר פרוס). {admin} מסמן את ערך CONFIG::$admin_url של האתר, לדוגמה wizzocms. קוד PHP מוצג משמאל לימין גם בעמוד בעברית.