panel_table (אפשרויות)

panel_table (api/core/libraries/panel_table.php, בפריסה system/libraries/panel_table.php) היא טבלת הניהול הסטנדרטית: רכיב Vue שמצויר מהשרת, עם עימוד, חיפוש, סינון לפי עמודה, עריכה בתוך השורה, מיון בגרירה, פעולות לשורה ולקבוצה וייצוא ל-Excel. הדף הזה הוא הרפרנס לכל אפשרות. מדריך בנייה של פאנל שלם נמצא במדריך panel_table ובבניית פאנל ניהול.

השימוש: יוצרים אובייקט, מגדירים מאפיינים, וקוראים ל-get_html(). כל פעולה בטבלה (עימוד, חיפוש, מחיקה, עריכה, מיון, ייצוא) היא POST JSON לאותה כתובת של הדף, ש-get_html() מזהה לפי tbl_action.

$lstListManager = new panel_table("pgs");
$lstListManager->title = "עמודי תוכן";

$lstListManager->titles = [
    ["title" => "id", "field" => "id", "type" => "number"],
    ["title" => "noDelete", "field" => "noDelete", "editable" => true, "type" => "boolean"],
    ["title" => "כותרת", "field" => "title", "editable" => true, "editable_table" => "content"],
    ["title" => "URL", "func" => function($row){
        $url = ROUTER::get_by_url("pages/" . $row["id"]);
        return "<a target=\"_blank\" href=\"$url\">$url</a>";
    }],
];

$lstListManager->query = DB::query("pages", null, "id DESC");
$lstListManager->btn_add_url = CONFIG::$admin_url . "/Pages/insert";
$lstListManager->order_manager = false;

$lstListManager->delete = function ($id) {
    DB::delete("pages", ["id" => $id]);
    ROUTER::remove_by_url("pages/" . $id);
};

$lstListManager->actions = function ($rows) {
    return [
        ["title" => LANGS::get_word('EDIT'), "link" => "EDIT", "perms" => "edit", "target" => "inner",
         "icon" => '<i class="fas fa-edit"></i>'],
    ];
};

return $lstListManager->get_html();

הבנאי#

הבנאי גם מחליט מראש על כמה דגלים:

• בנייד (PAGE::is_mobile()) actions_side הופך ל-"right".
• realtime_tracking דולק כששירות השוק wizzonow פעיל.
• radar_tracking דולק כשהשירות kama פעיל, ואז radar_api_key נלקח מהשירות.
• ai_insert_enabled דולק אם הוגדר ai_insert_default_prompt והשירות wizzoai פעיל.

מאפיינים#

נתונים ושאילתה#

כפתור הוספה ואלמנטים בראש הטבלה#

בתוך intro עם intro_card אפשר להשתמש במחלקות העזר .pt_intro__head, .pt_intro__icon, .pt_intro__title, .pt_intro__text, .pt_intro__code, .pt_intro__chips, .pt_intro__actions.

פעולות, הרשאות ומחיקה#

מיון בגרירה#

מעקב בזמן אמת ורדאר#

עמודות#

titles הוא מערך של מערכים. לכל עמודה:

עמודה שאינה מערך נזרקת. העמודות עוברות json_encode ללקוח, ולכן closures שבתוכן לא מגיעים אליו.

סוגי עמודה#

פרטים לפי סוג:

• image: אם הערך מספרי וגדול מ-0 הוא id בטבלת storage והתמונה נבנית ב-STORAGE::get_url; אחרת הערך נחשב כתובת. מוצגת כ-<img class="big_pic"> ב-70 על 70 פיקסלים עם object-fit: cover.
• list: הערך נשמר בפורמט הרשימה של הליבה (|1||2|) ומפורק עם MISC::bgl_explode, ואז ממופה דרך select_options. הערך המקורי (original_value) הוא מערך.
• date ו-datetime: ערך ריק או 0000-... מוצג כריק.
• select: ערך שאין לו מפתח ב-select_options מוצג כמו שהוא.

ערכי תא שהשרת מחזיר#

כל תא בתשובה הוא אובייקט {value, original_value, editable, link, select_options, class, style, field}. בכל שורה נוספים __actions_arr (הפעולות), __id, __class (מ-line_class) ו-__radar_url (כש-radar_tracking ו-radar_url_func). תווי בקרה מוסרים מערכי התאים, ונשארים רק התווים U+0020-U+007E ו-U+00A0-U+FFFF, כלומר ירידות שורה, טאבים ואימוג'י מחוץ ל-BMP נמחקים.

סינון וחיפוש#

הסינון מגיע ב-data.filters[field]. השדה חייב להתאים לעמודה בהגדרות, והערכים --all-- ו-"" מדלגים. הערך --none-- מסנן שורות ריקות: `field` IN ('', '0', NULL) (שים לב ש-NULL לעולם לא מתאים בתוך IN, כך שרק '' ו-'0' נמצאים בפועל).

חיפוש חופשי (data.q): אם הוגדר searchFunc, התנאי הוא searchFunc(DB::escape(q)). אחרת LIKE על כל עמודה שבשורה הראשונה של התוצאה (SELECT * FROM (...) LIMIT 0,1).

$lstListManager->searchFunc = function ($q) {
    // $q כבר עבר DB::escape
    return "(name LIKE '%" . $q . "%' OR email LIKE '%" . $q . "%')";
};

השאילתה הסופית שנבנית:

SELECT * [, ordtbl.item_ord AS tbl_ord]
FROM (<sql>) AS tbl
[LEFT JOIN CRM_panel_table_order ordtbl ON ordtbl.type = '<key>' AND ordtbl.item_id = tbl.id]
WHERE true <search> AND (<filters>)
ORDER BY ...
LIMIT (pgnm-1)*limit, limit

מיון#

סדר המקורות לקביעת ORDER BY, מהחזק לחלש:

1. data.ordBy ו-data.ordDir (המשתמש לחץ על כותרת עמודה). מכבה את order_manager לאותה בקשה. הערכים נכנסים ל-SQL ללא ולידציה.
2. order_manager: tbl_ord ASC עם טבלה חיצונית, אחרת ord ASC.
3. order_by של אובייקט ה-DB::query (הארגומנט השלישי של DB::query).
4. default_order.

סידור בגרירה#

• order (בקשה): OrderPage() ממספר מחדש את ord ל-1 עד n לכל השאילתה, ואז קובע את ord של העמוד הנוכחי לפי data.order_ids (הזזה של (pgnm-1)*limit). מחזיר false על שאילתת מחרוזת. התשובה {"success": true|false}, ואחריה נקרא order_success.
• עם order_manager_external_tbl: הסדר נשמר בטבלה panel_table_order (type, item_id, item_ord) עם INSERT ... ON DUPLICATE KEY UPDATE, כך שאפשר לסדר טבלה שאין לך שליטה בסכמה שלה.

פעולות שורה#

הערך המוחזר מ-actions הוא מערך של פעולות:

כללי הקישור:

• קישור יחסי (לא http, https, ftp) שאין בו id מקבל /<id> בסוף, או &id= או ?id= אם כבר יש בו ?.
• קישור שכבר מסתיים ב-/N או ?id=N מקבל את ה-id של השורה במקום.
• dblclick_url מוסיף פעולה {title: "כניסה", link, target: "inner", class: "btn_enter", action_type: "edit"}.
• לחיצה על func שולחת tbl_action: "action" עם id ו-token. השרת מחשב מחדש את פעולות השורה ומתאים לפי הטוקן וה-id לפני הפעלה, כך שלא ניתן להפעיל פעולה שלא הוצגה.
• תוצאת func (more_data.alert) מוצגת כ-HTML, ואם היא מתחילה ב-<script היא מורצת.
• לחיצת גלגלת על קישור פותחת לשונית חדשה.

מחיקה: כש-delete מוגדר וההרשאה delete קיימת, מתווספת אוטומטית פעולה עם func => fn($rows) => $del($rows["id"], $rows), alert של ARE_YOU_SURE, class: "delete_btn" ו-action_type: "delete".

פעולות קבוצה#

group_actions הן פעולות על שורות מסומנות. כל פעולה: title, icon, class, style, alert, ו-func שהחתימה שלה fn($row, $action) ומורצת פעם לכל שורה מסומנת (השרת שולף כל שורה עם WHERE id = N). הערך המוחזר נשלח ללקוח כ-more_data.alert. הפעולות מזוהות ב-token שנוצר כמו בפעולות שורה. כש-delete מוגדר ויש הרשאה, מתווספת פעולת קבוצה של מחיקה.

$lstListManager->group_actions[] = [
    "title" => "הפעל",
    "class" => "btn_activate",
    "func" => function ($row, $action) {
        DB::update("cron_tasks")->set_var("is_active", 1)->Update((int)$row["id"]);
    },
];

עריכה בתוך הטבלה#

עריכה היא POST עם tbl_action = "editable_field", id, editable_field_name, editable_value. השרת מוצא את השורה (מהשאילתה, או מ-rows_func כשאין שאילתה) ואם אינה קיימת מחזיר "row_not_in_list".

העמודה ניתנת לעריכה אם editable === true, או editable הוא callable שמחזיר true, או שהוגדר editable_field_table, או editable_field_func. אחרת התשובה false. ערך של עמודת list (מערך או אובייקט) מומר ל-|1||2| עם MISC::bgl_implode.

דרכי השמירה, לפי סדר העדיפות:

1. editable_field_table: DB::update(table)->set_var(field, value)->Update(id), ואז editable_success.
2. editable_field_func($row, $value, $title).
3. שאילתת DB::query: DB::update($query->table)->set_var(field, value, "conf"|"content"). טבלת היעד היא editable_table ("conf" או "content"), וכשהעמודה קיימת רק ב-<table>_content השרת עובר אוטומטית ל-content. אחר כך editable_success.
4. אחרת: false.

התשובה היא true או false.

["title" => "שפה", "field" => "lang_id", "type" => "select",
 "select_options" => [1 => "עברית", 2 => "English"],
 "editable_field_func" => function ($row, $value, $title) {
     DB::update("ui_langs")->set_var("lang_id", (int)$value)->Update((int)$row["id"]);
     return true;
 }],

ייצוא ל-Excel#

הבקשה tbl_action = "xls" קוראת ל-xls(): קובץ xlsx (PhpSpreadsheet), מימין לשמאל, שורת כותרות עם רקע FF0850a2 וגופן לבן, גליון בשם Simple, כל התאים מחרוזות והתגיות מוסרות. שם הקובץ <name>-d-m-Y-H-i.xlsx (עם filename*=UTF-8'' לפי RFC 5987), set_time_limit(0) ו-memory_limit -1, ואז exit. data.limit מספרי מגביל ל-LIMIT n, אחרת אין הגבלה.

פרוטוקול הבקשות#

get_html() קורא ל-init(), ואז:

• אם המשתמש מנהל והכותרת AI-Table-Discovery קיימת: מחזיר output_table_json() (תיאור הטבלה לסוכני AI) ויוצא.
• אם יש POST עם tbl_action ו-data["tblID"] == tblID: מטפל בפעולה ועונה Content-Type: application/json.
• אחרת מצייר את assets/panel_table_vue/index.tpl.

תשובת שורות:

{
  "more_data": {},
  "lines": [],
  "paging": {},
  "order_manager": true,
  "action_result": null,
  "additional_content": "..."
}

הקידוד: JSON_THROW_ON_ERROR | JSON_UNESCAPED_UNICODE | JSON_INVALID_UTF8_SUBSTITUTE. additional_content מופיע רק כש-additional_content מוגדר.

פלט הגילוי של AI#

output_table_json() מחזיר: tblID, title, table, base_query (עד 1000 תווים), columns (title, field, type, editable, ו-select_options או select_options_dynamic), limit, default_order, order_manager, btn_add_url, has_delete, group_actions (רק הכותרות).

מתודות ציבוריות#

מלכודות#

• שורות מ-rows_func מוצגות לפני תוצאות ה-DB ולא נספרות ב-paging().
• rows_func בלי query: אין DESCRIBE, אין מיון בגרירה, ואין עימוד אמיתי, וצריך select_options מפורשים.
• DELETE ועריכה שולפים את השורה בתת-שאילתה WHERE id = N, ולכן שאילתת מחרוזת חייבת להחזיר עמודה id.
• אין תמיכה בכמה טבלאות באותו דף בלי tblID שונה לכל אחת.

ראו גם#

• panel_table: מדריך שימוש
• בניית פאנל ניהול
• טפסים ו-FormInput_*: הטפסים שנפתחים מכפתורי ההוספה והעריכה
• ממשק JSON של הניהול
• רפרנס הניהול
• רפרנס DB