תפריטים

שלושה כלים: איתור התפריט, קריאת הפריטים, כתיבה.

שני סוגי מזהים

תפריטים ודפים אינם ב‑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. אלה גרסאות של אותו תפריט, וה‑originId מקשר ביניהן. אל תבחרו לפי שם: קראו את הפריטים של כל אחד וזהו לפי התוכן איזה מהם החי. אפשר גם לעבוד מול originMenuId במקום menuId — שני כלי הפריטים מקבלים את שניהם ומחזירים את אותה רשימה.

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: "" או בלי המפתח — 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

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

• "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
• מינוח והתאמת שפה · אינדקס הכלים המלא