בקרי מערכת (system/)

מלבד הבקרים של האתר (בקרים), הליבה מגיעה עם בקרים משלה בתיקייה api/core/controllers/ (באתר חי: system/controllers/). הם נגישים בכתובת /system/<controller>/<method>. בעמוד הזה: איך הניתוב אליהם עובד, רשימת כל הבקרים עם התפקיד והאימות של כל אחד, ומה צריך לדעת לפני שמוסיפים בקר ליבה.

איך הניתוב עובד#

כשהכתובת מתחילה ב-system/ (ואחרי שהכללים הקודמים לא התאימו, ראו ניתוב), ROUTER::parse_friendly_url בודק ארבע תבניות לפי הסדר הזה, והראשונה שמתאימה קובעת $_GET["sys_controller"], $_GET["pname"] (המתודה) ו-$_GET["id"]:

שימו לב: system/minify/12 קורא ל-minify::index עם id=12, ולא למתודה בשם 12. עם ?__router_trace=1 אפשר לראות איזו תבנית נבחרה (מעקב ניתוב). אחר כך הבקר נטען דרך MODULE::get_html($controller, $method, true), והפרמטר השלישי ($is_system = true) הוא מה שגורם ל-MODULE::get לחפש את הקובץ ב-CONFIG::$core_path/controllers/<name>.php במקום ב-application/controllers/.

שלושה דברים שונים מבקר אתר:

• אין צורך בשורה ב-CRM_modules. הקובץ מספיק, ולכן אין "הפעלה" ואין מטמון modules שצריך לנקות.
• בדיקת הדומיין (die("URL ERROR") כשהדומיין לא תואם לדומיין של הלקוח) לא חלה על minify ו-Tools, כדי שאפשר יהיה לטעון נכסים וכלי עזר גם מדומיין אחר.
• אותו כלל של is_callable: כל מתודה ציבורית היא endpoint, כולל wrapper, view ו-system_view שהבקר יורש מ-wz_controller. מתודה שאסור להפעיל מבחוץ צריכה להיות private או protected.

רשימת הבקרים#

הטבלה מסודרת לפי נושא. "ציבורי" בעמודת האימות פירושו שלא נמצאה בקוד של הבקר בדיקת הרשאה.

נכסים וצד לקוח#

אדמין וניהול#

Cron ותחזוקה#

Wizzo Market, סוכנים ו-MCP#

בקרים שמחזירים JSON או טקסט#

רוב הבקרים כאן מחזירים נתונים ולא עמוד. הדפוס הוא לקבוע $_GET["pmode"] = "empg" בבנאי (או במתודה), כדי ש-PAGE::output ידלג על ה-theme ועל מעטפת ה-HTML, ואז להחזיר מחרוזת או לעשות echo ו-die. לדוגמה, core_ping:

class core_ping extends bgl_controller
{
	function __construct()
	{
		parent::__construct();
		$_GET["pmode"] = "empg";
		header("Content-Type: application/json; charset=utf-8");
		header("Cache-Control: no-store, no-cache, must-revalidate, max-age=0");
	}

	function index()
	{
		echo json_encode(["ok" => true]);
		die;
	}
}

(זו גרסה מקוצרת של הקוד האמיתי, שמוסיף גם גרסה, בדיקת DB וגרסת PHP.)

כתיבת בקר ליבה משלכם#

בקר ליבה הוא קובץ PHP ב-CONFIG::$core_path/controllers/ שמגדיר מחלקה בשם הקובץ ויורשת מ-bgl_controller:

<?php
// system/controllers/hello.php  (בריפו: api/core/controllers/hello.php)
class hello extends bgl_controller
{
	public function index()
	{
		$_GET["pmode"] = "empg";
		if (!ADMIN::is_admin()) {          // האימות הוא באחריותכם
			http_response_code(403);
			return "forbidden";
		}
		return "hello";
	}
}

אחרי העלאה, /system/hello מחזיר את התוכן. שימו לב:

• api/core הוא הליבה המשותפת לכל האתרים. עדכון גרסה מחליף אותו, וקובץ שהוספתם שם לא יישמר. בקר שהוא חלק מהאתר שלכם שייך ל-application/controllers/ עם שורה ב-CRM_modules (בקרים). בקר ב-api/core/controllers/ מתאים רק לתרומה לליבה עצמה (תרומה לליבה).
• בקר מערכת מקבל את $this->load ואת view() כמו כל בקר, אבל system_view($tpl, $vars) קורא תבניות מ-core_path/views/.
• שם הקובץ הוא שם המחלקה, והשם הוא מה שמופיע בכתובת. אותיות גדולות נשמרות (/system/Tools/..., /system/CropManager/...).

ראו גם#

• ניתוב: הסדר המלא שבו הכתובת מותאמת.
• בקרים: בקרי אתר ורישום ב-CRM_modules.
• מעקב ניתוב: איך לראות איזה בקר נבחר.
• מודל האבטחה ו-הקשחה.