מסמך ממשקים (API) - Pande Complete Task System

מסמך זה מתאר את השורטקודים, נקודות הקצה של AJAX, והפונקציות המרכזיות של הפלאגין.

ממשק תכנות היישומים (API)

סוג רכיב	שם / נקודת קצה	תיאור	פרמטרים / ארגומנטים	אופן שימוש / דוגמה	מה מוחזר / פלט
Shortcode	[pande_student_tasks_table]	מציג את טבלת המשימות האישית עבור התלמיד המחובר.	לא מקבל פרמטרים.	[pande_student_tasks_table]	קוד HTML של טבלת המשימות וה-JavaScript הנלווה.
Shortcode		מציג כפתור (למורים ומנהלים בלבד) שפותח פופאפ לשיוך משימה לשיעור הנוכחי.	text: הטקסט שיוצג על הכפתור. anchor: מזהה פנימי.		קוד HTML של תגית <a> מעוצבת.
Shortcode	אין לך הרשאה לצפות בדוח זה.	מציג דוח הגשות מפורט עבור משימה ספציפית.	דורש פרמטר task_id בכתובת ה-URL.	יש לגשת לעמוד עם כתובת כמו: .../report/?task_id=123	קוד HTML של טבלת הדוח.
AJAX Action	pande_hw_student_upload_final	מטפל בהעלאת קובץ הגשה של תלמיד מהטבלה. מופעל אוטומטית בעת בחירת קובץ.	POST: nonce, submission_id FILES: hw_file	נקרא אוטומטית על ידי ה-JavaScript בטבלת התלמיד.	JSON עם success: true וכתובת url, או success: false עם הודעת שגיאה.
AJAX Action	pande_load_teacher_form	טוען את תוכן ה-HTML של טופס יצירת המשימה אל תוך הפופאפ של המורה.	POST: lesson_id, lesson_title, lesson_link	נקרא אוטומטית על ידי ה-JavaScript של כפתור המורה.	קוד HTML של הטופס.
AJAX Action	pande_submit_teacher_form	שומר את המשימה החדשה שהמורה יצר, ומשייך אותה לכל התלמידים בקבוצות שנבחרו.	POST: nonce, assignment_name, teacher_notes, task_due_date, notice_groups[]	נקרא אוטומטית בעת שליחת טופס המורה מהפופאפ.	JSON עם success: true והודעת הצלחה, או success: false עם הודעת שגיאה.
PHP Function	pande_next_task_uid()	מחולל ומחזיר מזהה ייחודי חדש וסדרתי עבור משימה.	prefix (אופציונלי), pad (אופציונלי)	$new_id = pande_next_task_uid();	string המכילה את המזהה החדש.
PHP Function	pande_put_to_bunny()	מעלה קובץ מקומי לשרת האחסון של BunnyCDN.	$local_path, $remote_name	$result = pande_put_to_bunny( $path, 'file.pdf' );	array עם המפתחות ok (true/false) ו-url או msg.

מבנה טבלת מסד הנתונים

שם הטבלה: wp_pande_hw_submissions (הקידומת wp_ עשויה להשתנות)

שם עמודה	סוג נתונים	תיאור
id	BIGINT	מזהה ייחודי רץ של השורה.
user_id	BIGINT	מזהה המשתמש של התלמיד (מטבלת wp_users).
student_mail	VARCHAR(190)	כתובת המייל של התלמיד.
teacher_mail	VARCHAR(190)	כתובת המייל של המורה ששייך את המשימה.
task_uid	VARCHAR(100)	מזהה ייחודי של המשימה עצמה (מקשר בין כל התלמידים לאותה משימה).
assignment_name	VARCHAR(255)	שם המשימה כפי שמוצג לתלמיד.
bunny_url	TEXT	הקישור לקובץ שהוגש בשרת של Bunny. ריק (NULL) אם טרם הוגש.
submitted_at	DATETIME	חותמת הזמן המדויקת של ההגשה.
due_date	DATE	תאריך היעד להגשת המשימה.
created_at	DATETIME	חותמת הזמן שבה המשימה שויכה לתלמיד.