סקרים חיים בתגובות

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

• השאלה, עד 200 תווים.
• האפשרויות, בין 2 ל‑10, כל אחת עד 100 תווים. השתמש ב‑Add option כדי להוסיף עוד.
• מתי הסקר נסגר: ללא תאריך סיום, יום אחד, שלושה ימים, או שבוע אחד. סקר סגור מציג את תוצאותיו הסופיות ולא מקבל עוד הצבעות.
• פרטיות: האם המצביעים נשארים אנונימיים, נראים למנהלים, או ציבוריים. ראה Voter Privacy.
• דרוש הצבעה לצפייה בתוצאות: כאשר מסומן, התוצאות נשארות מוסתרות מכל צופה עד שהוא מצביע או עד שהסקר נסגר.

כתוב את ההערה שלך כרגיל ופרסם אותה. הסקר מתפרסם יחד עם ההערה. ניתן להוסיף סקרים להערות חדשות ולתגובות.

כדי לבטל סקר לפני הפרסום, לחץ על Remove poll.

כדי להצביע, לחץ על אפשרות. התוצאות מוצגות מייד, והסקר מציג כמה תגובות יש לו עד כה.

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

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

אלא אם הסקר דורש הצבעה כדי לראות את התוצאות, הצופים יכולים ללחוץ על הצג תוצאות כדי לראות את הספירות הנוכחיות לפני ההצבעה.

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

• Anonymous (ברירת המחדל): רק הסכומים מוצגים. אף אחד, כולל מנהלים, לא יכול לראות מי הצביע על מה.
• Admins can see who voted: רק מנהלים ומפקחים יכולים לפתוח את See who voted, שמציג את רשימת כל המצביעים ואת בחירתם.
• Public: כל צופה יכול ללחוץ על See who voted ולראות מי הצביע על מה.

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

המחבר של סקר מקבל התראה כאשר תגובות מתקבלות:

• In-app: התראה מתחת לאייקון הפעמון כאשר הסקר מקבל תגובה חדשה. כאשר הרבה אנשים מצביעים, הן מקובצות להתראה אחת.
• Email: אימייל יומי למחבר הסקר כאשר הסקר שלו קיבל תגובות חדשות באותו היום.

רק ההצבעה הראשונה של אדם נחשבת כתגובה חדשה. שינוי הצבעה אינו שולח התראה, והמחברים אינם מקבלים התראה על ההצבעות שלהם.

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

האימייל כולל קישור להפסקת ההתראות עבור סקר זה. תוכנו ניתן לשינוי באמצעות תבנית Poll Response Notification, ראה Email Templates.

ניתן לנהל סקרים גם מקוד שלכם באמצעות ה‑REST API, לדוגמה כדי להוסיף סקר לתגובה מה‑backend שלכם, לסגור סקר, או לייצא את ההצבעות:

• Poll Structure מתאר את אובייקט הסקר ואת המגבלות שלו.
• GET, PUT, PATCH, ו-DELETE /api/v1/polls/:commentId קוראים, מחליפים, עורכים ומסירים את הסקר בתגובה.
• PollVote Structure מתאר הצבעה בודדת.
• GET, POST, ו-DELETE /api/v1/poll-votes מציגים, מבצעים ומסירים הצבעות.

ניתן גם ליצור סקר יחד עם התגובה שלו על‑ידי העברת poll ל‑POST /api/v1/comments.

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