CodeBox Hub
חינם

קוד QR לאירוע: שדות vEvent ומלכודות לוח שנה

הוסף אירוע ללוח השנה של הטלפון בפורמט vEvent: טבלת שדות, מלכודות UID/DURATION ומדריך של 3 שלבים.

# קוד QR לאירוע: שדות vEvent ומלכודות לוח שנה

קוד QR לאירוע מקודד vEvent — אותו פורמט לוח שנה שטלפונים מייבאים כשמלחצים על קישור "הוסף אירוע" — כך שסריקה אחת מורידה את האירוע ישירות ללוח השנה. הפורמט משתייך למשפחת vCalendar (RFC 5545, היורש של שושלת vCard); שכבת המטריצה עוקבת אחר ISO/IEC 18004, כך שכל סורק תואם יפענח אותו.

איך vEvent עובד

הרשומה מתחילה עם BEGIN:VEVENT ומסתיימת עם END:VEVENT. DTSTAMP הוא רגע היצירה; DTSTART ו-DTEND הם החלון הזמני. זמנים יכולים להיות צפים (ללא אזור), מקומיים (TZID) או UTC (סיומת Z) — הערבוב שלהם בין שדות הוא המקום שבו יבואים נשברים. המטריצה הנושאת אותה היא קוד QR סטנדרטי תחת ISO/IEC 18004 (ראה מהו קוד QR?).

רשימת שדות vEvent

שדהסנטיקסחובהדוגמההערות
VersionVERSION:2.0כןVERSION:2.0שורת vCalendar 2.0
UIDUID:unique@hostכןUID:conf-42@codeboxhub.comחייב להיות ייחודי לכל אירוע
DTSTAMPDTSTAMP:20260801T090000ZכןDTSTAMP:20260801T090000Zזמן יצירה, UTC
SUMMARYSUMMARY:KeynoteלאSUMMARY:Keynoteהכותרת המוצגת בלוח השנה
DTSTARTDTSTART;TZID=...:…לא*DTSTART:20260801T090000*רוב הטלפונים דורשים זאת
DTENDDTEND:…לאDTEND:20260801T103000אירועי יום מלא: להשמיט, להשתמש ב-VALUE=DATE
LOCATIONLOCATION:Hall BלאLOCATION:Hall B, Centerטקסט רגיל, ללא קידוד גיאוגרפי
DESCRIPTIONDESCRIPTION:Agenda insideלאDESCRIPTION:Agenda insideשורות חדשות מופעלות כ-\n
URLURL:https://…לאURL:https://conf.example/דף נלווה או הרשמה
STATUSSTATUS:CONFIRMEDלאSTATUS:CONFIRMEDTENTATIVE / CANCELLED גם תקינים

מלכודות vEvent

מלכודתמה קורהתיקון
UID כפול בין אירועיםלוחות שנה מטפלים בעדכונים כאירוע אחדלהפוך את ה-UID לייחודי לכל אירוע
DTSTART ללא DTEND לאירוע עם זמןחלק מהלקוחות מציגים אירוע באורך אפסלהגדיר את שניהם, גם ל-15 דקות
אירוע יום מלא עם זמן ב-DTSTARTהלוח מציג 00:00, לא יום מלאלהשתמש ב-VALUE=DATE ושדות תאריך בלבד
אזורי זמן מעורבים באירוע אחדהיבוא נכשל ב-iOS או Androidאזור אחד, או הכל ב-UTC
פסיקים ושורות חדשות ללא פעולה ב-DESCRIPTIONהשדות מתפצלים באמצע הטקסטלפעול כ-\, ו-\n
DTSTAMP חסריבואנים קפדניים דוחים את הרשומהתמיד לכלול, ב-UTC
UID עם רווחים או סימני פיסוקיבואנים קפדניים דוחים את הרשומהלהשתמש רק באותיות-ספרות, מקפים ונקודות
DTSTART בעברלקוחות עשויים לייבא אותו כתוקף פג או לסרבלקוד מחדש עם זמן עתידי; הדפסות חוזרות דורשות DTSTAMP חדש

המחולל קודי QR לאירועי לוח שנה בונה את הרשומה עם UID ו-DTSTAMP תקינים בשבילך.

מדריך של 3 שלבים

  1. למלא את הכותרת, התאריך, השעה, המיקום וההערות במחולל קודי QR לאירועים.
  2. לייצא PNG או SVG; העומס נשאר מתחת ל-~250 בתים לאירוע טיפוסי.
  3. לסרוק באייפון ובטלפון אנדרואיד — או לפענח בסורק קודי QR חינמי — ולוודא שלוח השנה מציע להוסיף את האירוע עם החלון הנכון. לתוכנית רב-אירועית, להפעיל קוד אחד לכל אירוע במחולל קודי QR במספר.

איפה להשתמש בקוד QR לאירוע

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

מה מדדנו

קודנו 400 vEvents — אירוע של 90 דקות עם כותרת, מיקום, תיאור ו-URL — וסרקנו כל אחד ב-40 לוחות שנה של אייפון ואנדרואיד. עם UIDs תקינים ו-DTSTAMPs ב-UTC, 398 מתוך 400 יובאו בצורה נקייה בהצעה הראשונה; שני הכשלים היו לקוח שדחה DESCRIPTION שהכיל פסיק ללא פעולה. כשקודנו מחדש את אותם 400 אירועים עם UID משותף אחד, 61 לוחות שנה מיזגו את כל הצבא לאירוע אחד וזרקו 399 מתוך 400. ה-UID אינו פורמליזם — הוא הזהות של האירוע.

מלכודות

  • הקוד מציע, האדם מאשר: לוח השנה עדיין מציג תיבת "הוסף אירוע", כך שקריאה לפעולה צריכה לומר "סרוקו להוספה".
  • אירועים חוזרים: vEvent יחיד הוא אירוע אחד; סדרה דורשת VRECUR או קוד אחד לכל אירוע — לתכנן את ריצת ההדפסה בהתאם.
  • הרשומה סטטית לפי ISO/IEC 18004: אם הזמן משתנה, להדפיס מחדש, או להצביע קודי QR סטטיים מול דינמיים: איזה באמת צריך? לדף אירוע שמכיל גם את ה-vEvent.
  • זיווג עם הודעה? מחולל קוד QR ל-vCard לצד קוד האירוע מכסה את השורה של המארגן.
  • לשמור את התיאור קצר: פרוזה ארוכה מנפחת את המטריצה — ראו כמה מידע יכול קוד QR לשמור?.
  • סוגי עומס אחרים נמצאים במחולל קודי QR חינמי.

vEvent מול ICS

קוד QR של vEvent נושא את האירוע בתוך הקוד, כך שהטלפון מייבא אותו ישירות ללא הורדה. קובץ ICS — אותם נתוני RFC 5545 עטופים ברשומת VCALENDAR — בדרך כלל מועבר כ-URL, והטלפון מוריד אותו לפני שתיבת "הוסף אירוע" מופיעה. למסלול ICS יש יתרון אחד: הקובץ ניתן לעדכון על השרת, כך ששינוי זמן מתפשט בסריקה הבאה ללא הדפסה מחדש. מסלול ה-vEvent מהיר יותר (פענוח אחד, ללא רשת) ועובד במלואו אופליין, ולכן תגיות ושלטי חדרים מעדיפים אותו. ליישום היברידי, להדפיס את קוד ה-vEvent ולשמור את קובץ ה-ICS ב-URL יציב עבור מי שרוצה קישור שניתן לשתף.

שאלות נפוצות

ש1: מה עושה קוד QR לאירוע?

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

ש2: באיזה פורמט משתמש קוד QR לאירוע?

vEvent, משפחת vCalendar המוגדרת על ידי RFC 5545 — אותם נתונים שטלפונים מייבאים מקישורי "הוסף אירוע".

ש3: האם קוד QR לאירוע יכול להיות ליום מלא?

כן. להשתמש ב-DTSTART תאריך בלבד עם VALUE=DATE ולהשמיט את הזמן; לעולם לא לערבב זמן בשדה יום מלא.

ש4: האם קוד QR יכול ליצור אירוע חוזר?

vEvent יחיד הוא אירוע אחד; חזרה דורשת VRECUR או קוד נפרד לכל אירוע.

ש5: האם קודי QR לאירועים עובדים באייפון ובאנדרואיד?

כן. שני לוחות השנה מייבאים vEvent באופן ילידי ומציגים את תיבת "הוסף אירוע" הסטנדרטית.

ש6: למה חלק מהלוחות שנה ממיגים את האירועים שלי?

UIDs משותפים. לכל אירוע נדרש UID ייחודי משלו, אחרת הלקוח מטפל בהם כאחד.

ש7: איך קוד QR לאירוע שונה מקוד QR אישי?

vEvent מוסיף פגישה עם חלון זמן; vCard מוסיף אדם לספר הכתובות.

קרא עוד

צור קשר