תפריטים

התפריט הוא הדבר האחרון שבונים ומה שהמשתמש רואה ראשון. שלושה כלים מנהלים אותו — אחד מוצא את התפריט, אחד קורא את הפריטים, ואחד כותב.

שני סוגי מזהים — כאן זו טעות שמייצרת “לא נמצא” ריק

תפריטים ודפים אינם ב‑Parse. הם מסמכי MongoDB בצד ה‑Simbla, ולכן:

מה	סוג המזהה	הדוגמה
תפריט, פריט תפריט, דף	_id של MongoDB — 24 תווים הקסדצימליים	5a2ceaae377ac4001aeb002d
רשומת נתונים (לקוח, מכירה, משתמש)	objectId של Parse — 10 תווים	xK9mP2qRsT

ל‑Get-Menu-Items מעבירים מזהה, לא שם. "CRM-Menu" ייכשל. השדה page בפריט תפריט מקבל את ה‑_id של הדף מ‑Get-Site-Pages — לא את הנתיב.

Get-Menus

הפרמטר	טיפוס	חובה	המשמעות
siteId	String		האתר. בהשמטה — האתר של החיבור

מחזיר לכל תפריט: _id, name, originId, marketApp.

התפריטים המוכרים במערכת סטנדרטית: CRM-Menu (התפריט הצדדי הראשי), Settings (תפריט ההגדרות), Dashboard Menu (רשימת הדשבורדים).

שמות כפולים = גרסאות

Get-Menus עלול להחזיר שני תפריטים עם אותו name (לא נצפה במערכת vanilla, שם כל 21 השמות ייחודיים). אלה גרסאות של אותו תפריט, וה‑originId הוא מה שמקשר ביניהן. אל תבחרו לפי שם. אם יש כפילות, קראו את הפריטים של כל אחד וזהו לפי התוכן איזה מהם החי. אפשר גם לעבוד מול originMenuId במקום menuId — שני כלי הפריטים מקבלים את שניהם (מאומת: אותם 23 פריטים בשני המסלולים).

Get-Menu-Items

הפרמטר	טיפוס	חובה	המשמעות
menuId	String	*	מזהה התפריט
originMenuId	String	*	מזהה תפריט המקור
siteId	String		האתר

* אחד מהשניים.

לכל פריט חוזרים: _id, title, type, page או path, icon, order, newWin, parent, visibility.

זו קריאת החובה שלפני כל כתיבה — ראו למה בסעיף הבא.

Set-Menu-Items

הפרמטר	טיפוס	חובה	המשמעות
items	Array<Object>	✔	הפריטים לכתיבה
menuId	String	*	התפריט
originMenuId	String	*	חלופה ל‑menuId — כתיבה לפי מזהה המקור עובדת
siteId	String		האתר

* אחד מהשניים. בלי שניהם: Error: menuId or originMenuId is required — הכלי אינו יוצר תפריט חדש.

אובייקט הפריט:

המפתח	טיפוס	המשמעות
_id	String	מזהה פריט קיים. בהשמטה — נוצר פריט חדש
type	Enum	page או link. ברירת מחדל link
page	String	ה‑_id של הדף — לפריט מסוג page
path	String	כתובת — לפריט מסוג link
title	String	הכותרת. בהשמטה הפריט מקבל את ה‑_id של הדף ככותרת (לא את שמו) — תמיד שלחו title
icon	String	אייקון FontAwesome — ראו האזהרה
order	Number	מיקום בתפריט
parent	String	ה‑_id של פריט האב — יוצר היררכיה
newWin	Boolean	פתיחה בחלון חדש
visibility	Array<String>	תפקידים שרשאים לראות, או loggedIn
removeThisItem	Boolean	מוחק את הפריט

type נדרש בכל עדכון — לא רק ביצירה

עדכון של פריט קיים — למשל שינוי כותרת בלבד — חייב לכלול גם את type, וגם את page או path שמתאים לו. בלי type הקריאה נדחית: Error: Item type is required for item: <title>, והפריט נשאר כפי שהיה (לא הופך לקישור מת). הדפוס הבטוח: Get-Menu-Items, מעתיקים את אובייקט הפריט המלא, משנים בו רק את מה שצריך, ושולחים אותו כפי שהוא.

JSON

// הוספת פריט חדש
{ "menuId": "<menuId>", "items": [
  { "type": "page", "page": "<pageId>", "title": "ספקים",
    "icon": "fa fa-truck", "order": 7, "visibility": [] }
] }

// עדכון כותרת של פריט קיים — שימו לב שכל השדות חוזרים
{ "menuId": "<menuId>", "items": [
  { "_id": "<itemId>", "type": "page", "page": "<pageId>",
    "title": "ספקים וקבלנים", "icon": "fa fa-truck", "order": 7, "visibility": [] }
] }

// מחיקה
{ "menuId": "<menuId>", "items": [ { "_id": "<itemId>", "removeThisItem": true } ] }

מחיקה

אין כלי מחיקה נפרד. מוחקים בדגל removeThisItem: true על הפריט, בתוך אותה קריאת Set-Menu-Items — וזו הפעולה היחידה בכל חבילת הבנייה שבאמת מוחקת משהו. אין Delete-Page, אין מחיקת אלמנט, אין מחיקת שדה — אבל פריט תפריט כן נמחק.

היררכיה

תת‑תפריט נבנה בשדה parent, שמקבל את ה‑_id של פריט האב:

JSON

{ "menuId": "<menuId>", "items": [
  { "_id": "<childId>", "type": "page", "page": "<pageId>",
    "title": "ספקים", "parent": "<parentItemId>", "order": 2, "icon": "fa fa-truck" }
] }

ביטול הורות

להסיר parent עובד (מאומת): שולחים את הפריט המלא עם parent: "" או בלי המפתח — Get-Menu-Items מחזיר אותו בלי parent. parent: null נדחה בולידציה. אם בכל זאת הפריט לא יוצא: removeThisItem: true ויצירה מחדש בלי parent (ואז ה‑_id משתנה — עדכנו הפניות).

visibility — נראוּת לפי תפקיד

מערך של שמות תפקידים, או המילה loggedIn:

הערך	מי רואה
[]	כמו רוב הפריטים הקיימים — ללא סינון מפורש
["loggedIn"]	כל משתמש מחובר
["Admin", "Report Admin"]	חברי התפקידים האלה בלבד

שמות התפקידים הם בדיוק כפי שהם ב‑Get-Roles, כולל רישיות ורווחים.

נראוּת — מה אומת

[], ["loggedIn"] ו‑["Admin"] הוצגו למשתמש Admin; שם תפקיד שאינו קיים (["NoSuchRole"]) מסתיר את הפריט. שילובים אחרים (משתמש בכמה תפקידים, תפקיד מותאם) לא נבדקו — אם פריט נעלם, בדקו שהשם מדויק, והעתיקו את הצורה מפריט דומה שעובד. אם אין דרישת נראוּת אמיתית — []. ומעל הכול: תפריט אינו הרשאה. פריט מוסתר לא מונע מאף אחד להגיע לדף בכתובת ישירה. ההגנה היא allowedRoles בהגדרות הדף ומעליה CLP.

אייקונים

מגבלה ידועה — קידומת ה‑fa (mcp-d-10)

נבדק בדפדפן, שלוש הצורות:

• "fa-truck" (חשוף) — נשמר חשוף ומרונדר כ‑<span class="fa-truck"> בלי המחלקה הבסיסית fa: אין גליף (הגופן נשאר Assistant).
• "fa fa-truck" — נשמר כ‑"fa fa fa-truck" (הכלי מקדים fa נוסף), ומרונדר תקין — הכפילות אינה מזיקה.
• "fa-solid fa-truck" (הדוגמה שבתיאור הכלי) — תחביר FontAwesome 5; המערכת על 4.7.0, אין גליף.

המלצה מעשית: שלחו "fa fa-<name>" (fa fa-truck, fa fa-users, fa fa-file-text-o) — כמו פריטי המערכת — ובדקו בעין אחרי הכתיבה. Get-Menu-Items מראה את הצורה שעובדת אצל הלקוח.

המסלול המהיר — menuName

לרוב אין צורך לגעת בכלים האלה בכלל: ל‑Create-Table-View-Page יש פרמטר menuName, והוא מוסיף את פריט התפריט אוטומטית בעת יצירת דף הרשימה.

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

הוספת דשבורד לתפריט הדשבורדים

1. Get-Menus                      → מאתרים את "Dashboard Menu", לוקחים את ה-_id
2. Get-Menu-Items(menuId)         → רואים את ה-order ואת צורת ה-visibility הקיימת
3. Set-Menu-Items                 → מוסיפים פריט type:"page" עם ה-pageId של הדשבורד

JSON

{ "menuId": "<dashMenuId>", "items": [
  { "type": "page", "page": "<newDashboardPageId>", "title": "דשבורד שותפים",
    "icon": "fa fa-handshake-o", "order": 7, "visibility": [] }
] }

שינוי מינוח בתפריטים

כשמשנים שפה במערכת — “מכירה” ל“פרויקט” — התפריטים הם אחת מארבע השכבות שצריך לעבור. כאן זה נעשה כך:

Get-Menus  →  לכל תפריט: Get-Menu-Items  →  Set-Menu-Items עם אובייקטי הפריט המלאים,
              כשרק ה-title שונה

ושוב: אובייקט מלא, כולל _id, type, page/path, order ו‑icon. משלוח חלקי מאבד נתונים. התמונה המלאה: מינוח והתאמת שפה.

אימות

Get-Menu-Items(menuId) אחרי כל כתיבה — ובודקים שלושה דברים: הפריט קיים עם הכותרת הנכונה, מספר הפריטים הוא כמצופה (לא נמחק משהו בשוגג), ו‑type / page נשמרו.

ואז — רענון בדפדפן. התפריט נטען עם המסגרת, ולא יתעדכן במסך פתוח.

המשך

• אתרים ודפים — קריאה — מאיפה מגיע ה‑page שהפריט מצביע אליו
• טבלאות תצוגה ודפי רשימה — menuName שעושה את זה לבד
• הגדרות דף, קוד וגרסאות — שער הדף שמתחת לתפריט
• תפקידים, הרשאות טבלה וחבילות — שמות התפקידים ל‑visibility
• מינוח והתאמת שפה · אינדקס הכלים המלא