הוספת תגובות חיות לאתרי דרופל
התחלה מהירה 
זו הגרסה המקוצרת (TL;DR) של ההוראות ל‑Drupal.
- התקן את המודול עם
composer require drupal/fcom, או הנח אותו ב־modules/custom/fastcomments/. - הפעל אותו באמצעות
drush en fastcomments, או דרך ממשק הניהול ב־/admin/modules. - גש אל
Administration > Configuration > Content > FastComments(/admin/config/content/fastcomments). - הזן את ה‑Tenant ID וה‑API Secret מתוך הגדרות > API/SSO (EU).
- הוסף את השדה
FastCommentsלכל סוג תוכן דרךStructure > Content types > [type] > Manage fields.
המודול פורסם ב־drupal.org/project/fcom.
התקנה
מודול ה-FastComments ל-Drupal מחליף את מערכת התגובות המובנית של Drupal במערכת תגובות מהירה ובזמן אמת. המודול מפורסם ב-drupal.org ועובד עם Drupal 10 ו-11.
ישנן שתי דרכים להתקין אותו.
התקנה עם Composer
composer require drupal/fcom
drush en fastcommentsהתקנה ידנית
הורידו את המודול מ-drupal.org/project/fcom ומקמו אותו בתיקיית modules/custom/fastcomments/ של האתר שלכם. לאחר מכן הפעילו אותו עם drush en fastcomments, או מממשק הניהול ב-Extend (/admin/modules).
שימו לב! המודול תלוי רק בליבת Drupal (user ו-field). אין צורך במודולים או ספריות Drupal אחרים.
לאחר הפעלת המודול, עברו לסעיף Configuration כדי להגדיר את ה-Tenant ID ואת ה-API Secret שלכם.
הגדרה
כל ההגדרות נמצאות תחת Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).
נדרש
- מזהה דייר (Tenant ID) - מזהה הדייר שלך ב-FastComments. ניתן למצוא אותו תחת Settings > API/SSO (EU).
- סוד API (API Secret) - נדרש עבור SSO מאובטח, אימות webhooks וסנכרון דפים. נמצא תחת Settings > API/SSO (EU).
אחסון סוד ה-API
המודול קורא את סוד ה-API מהמקור הראשון מבין אלה שיש לו ערך:
- מודול Key - התקן את Key, צור מפתח מסוג Authentication, ובחר אותו תחת API Secret key בטופס ההגדרות. המפתח יכול להתבסס על משתנה סביבה או קובץ מחוץ לשורש האתר.
- settings.php - הוסף
$config['fastcomments.settings']['api_secret'] = 'your-secret';ל-settings.phpאו ל-settings.local.php. הסוד לעולם לא נכנס לתצורה המיוצאת. - טופס ההגדרות - הזן אותו בשדה API Secret. פעולה זו שומרת את הערך ב-
fastcomments.settings, ולכן הוא יופיע בייצואי התצורה. דוח המצב של Drupal מציג אזהרה כאשר זהו המקור הפעיל.
הטופס מציג איזה מקור פעיל. השארת השדה ריק שומרת על הסוד הקיים. סמן את Remove the API Secret stored in configuration כדי למחוק אותו לאחר העברת הסוד למודול Key או ל-settings.php.
סגנון תגובות
בחר את הווידג'ט המתאים לאופן שבו אתה רוצה שאנשים ידברו באתר שלך.
- Live Comments - תגובות משורשרות בזמן אמת.
- Streaming Chat - ממשק צ'אט חי, מתאים לאירועים ולשידורים חיים.
- Collab Chat - הערות על בחירת טקסט באזור התוכן הראשי. מבקרים מסמנים טקסט ופותחים דיון בהקשר.
- Collab Chat + Comments - גם צ'אט שיתופי וגם תגובות רגילות באותו עמוד.
מצב SSO
- None - ללא SSO. משתמשים מגיבים כאורחים או יוצרים חשבון FastComments.
- Simple - מעביר מידע על משתמש Drupal (שם, אימייל, אווטאר) ל-FastComments ללא אימות בצד השרת.
- Secure - משתמש ב-HMAC-SHA256 לאימות משתמשי Drupal מול FastComments. מומלץ כאשר מוגדר אצלך סוד API.
ראה את הסעיף Single Sign-On (SSO) לפרטים נוספים.
הגדרות אחרות
- CDN URL - ברירת מחדל:
https://cdn.fastcomments.com. - Site URL - ברירת מחדל:
https://fastcomments.com. - התראות אימייל - שליחת אימייל למחבר התוכן כאשר מתפרסמת תגובה חדשה על התוכן שלו.
עבור אחסון נתונים ב-EU, ראה את הסעיף EU Data Residency.
בלוקים של וידג'ט
המודול מכיל כמה בלוקים שניתן למקם דרך Structure > Block layout (/admin/structure/block).
- FastComments Widget - רכיב ההערות הראשי. מזהה אוטומטית את היישות הנוכחית. הוא ידלג על ישויות שכבר מחובר אליהן השדה של FastComments, כך שלא תראו רכיבים כפולים באותו עמוד.
- FastComments Live Chat - צ'אט בשידור חי בזמן אמת. ניתן למקם לצד שדה ההערות באותו עמוד.
- FastComments Collab Chat - הערות ודיון על בחירת טקסט.
- FastComments Image Chat - הערות מבוססות קואורדינטות על תמונות. מבקרים לוחצים על תמונה כדי להשאיר תגובות הקשורות למיקומים ספציפיים.
- FastComments Recent Comments - מציג תגובות אחרונות בכל האתר. המספר ניתן להתאמה בבלוק.
- FastComments Top Pages - מציג את העמודים באתר שלך עם הכי הרבה תגובות.
הבלוקים שממוקדים בתוכן (Live Chat, Collab Chat, Image Chat) מזהים אוטומטית את הישות הנוכחית, ובדפים שאינם ישות הם חוזרים לזיהוי מבוסס-נתיב. משמעות הדבר היא שהם פועלים בדפי טקסונומיה, views ומסלולים מותאמים אישית ללא כל הגדרה נוספת.
שדות סוג תוכן
ברוב האתרים, הדרך הקלה ביותר להוסיף תגובות היא לצרף את השדה FastComments לסוגי התוכן שלך. עבור אל Structure > Content types > [type] > Manage fields והוסף את השדה.
לכל ישות שיש לה את השדה יתווספו:
- מתג סטטוס שמאפשר לעורכים להפעיל או לכבות תגובות עבור כל ישות.
- מזהה מותאם אישית אופציונלי, כדי שתוכלו להשתמש ב‑ID יציב שאינו קשור לנתיב הישות ב‑Drupal.
הבלוק הראשי FastComments Widget מודע לשדה זה, וידלג על ישויות שכבר מחוברות אליו. כך תוכלו לשלב תגובות לפי ישות יחד עם הבלוק מבלי שהווידג'ט יופיע פעמיים באותו עמוד.
כניסה יחידה (SSO)
FastComments משתלב עם מערכת המשתמשים של Drupal דרך SSO, או התחברות יחידה (single-sign-on). המשתמשים שלך נכנסים לאתר ה-Drupal שלך, והמודול מעביר את זהותם ל-FastComments אוטומטית. אין חשבונות נוספים ליצירה, ואין צורך בהרצת סנכרון ראשוני.
המודול תומך בשלוש מצבי SSO, הנקבעים תחת Administration > Configuration > Content > FastComments.
ללא SSO
אין SSO. משתמשים מתפרסמים כאורחים או יוצרים חשבון FastComments. השתמש בכך אם האתר שלך ציבורי ולא צריך לקשר תגובות למשתמשי Drupal.
פשוט
מעביר את השם, האימייל ותמונת הפרופיל של משתמש ה-Drupal ל-FastComments ללא אימות בצד השרת. אין צורך ב-API Secret. מתאים לאתרים פנימיים או בעלי סיכון נמוך.
מאובטח (מומלץ)
משתמש ב-HMAC-SHA256 כדי לאמת כל זהות משתמש מול FastComments. זה המצב הרצוי כשיש לך API Secret מוגדר, וזה המצב היחיד שמונע ממבקר להתחזות למשתמש אחר.
זהות המשתמש מועברת ל-FastComments בכל פעם שמשתמש צופה בנושא תגובות. אין סנכרון ראשוני או רציף שצריך לרוץ.
(אופציונלי) הוסף את המנהלים שלך ל-משתמשים ומנהלים ואת המנחים ל-מנחי תגובות כדי לשפר את חווייתם ולהפעיל מעקב סטטיסטי עבור המנחים.
למבט מעמיק יותר על איך SSO עובד, ראו את סעיף ה‑SSO במסמכי ההתאמות האישיות.
הרשאות
התוסף מוסיף שלוש הרשאות של Drupal שניתן להקצות לפי תפקיד תחת People > Permissions.
- Administer FastComments - גישה לטופס ההגדרות של FastComments ב־
/admin/config/content/fastcomments. - View FastComments - נדרש כדי לראות את ווידג'ט התגובות. ללא הרשאה זו הווידג'ט לא ייטען.
- Toggle FastComments - מאפשר למשתמשים להפעיל או לכבות תגובות עבור כל ישות בנפרד באמצעות ווידג'ט השדה.
כברירת מחדל, רק משתמשים שיש להם את ההרשאה administer site configuration יכולים לשנות את הגדרות FastComments. העניקו את View FastComments למשתמשים אנונימיים ומאומתים אם אתם רוצים שמבקרים יראו את הווידג'ט.
רב-לשוני
המודול מעביר אוטומטית את שפת האתר הנוכחית של Drupal לכל ווידג'ט של FastComments. אם אתר ה-Drupal שלך מוגדר למספר שפות, ממשק ההערות יוצג בשפה התואמת ללא צורך בהגדרה נוספת.
זה חל על כל סוגי הווידג'טים: Live Comments, Streaming Chat, Collab Chat, Image Chat, Recent Comments, ו-Top Pages.
מיקום נתוני האיחוד האירופי
אם חשבון FastComments שלך מאוחסן ב-EU, עדכן שתי הגדרות ב-Administration > Configuration > Content > FastComments:
- CDN URL -
https://cdn-eu.fastcomments.com - Site URL -
https://eu.fastcomments.com
כדאי גם לשלוף את ה-Tenant ID וה-API Secret מתוך לוח הבקרה של ה-EU ב-eu.fastcomments.com/auth/my-account/api במקום לוח הבקרה הסטנדרטי של ה-US. כל השאר במודול עובד באותו אופן.
התאמה אישית
FastComments תוכנן להיות מותאם אישית כך שיתאים לאתר שלך.
אם ברצונך להוסיף עיצוב מותאם אישית או לשנות הגדרות, עיין בתיעוד ההתאמות וההגדרות שלנו כדי ללמוד כיצד לעשות זאת.
דרישות
- Drupal 10 או 11
- PHP 8.1 או חדש יותר
- חשבון FastComments
המודול אינו דורש מודולים נוספים ל-Drupal או ספריות צד-שלישי. הוא תלוי רק בליבת Drupal (user, field).
מנגנון גיבוי <noscript> מספק תגובות המוצגות בצד השרת עבור מבקרים ללא JavaScript, כך ש-Live Comments ו-Streaming Chat עדיין פועלים בדפדפנים שבהם הסקריפטים מושבתים.
הוספת סקרים לאתר דרופל שלך
כאשר FastComments מותקן באתר Drupal שלך, אתה יכול גם להפעיל סקרים חיים ישירות בתגובות. הפעל את Enable Polls בהגדרות התאמה אישית של הווידג'ט שלך וכפתור הסקר יופיע בסרגל הכלים של התגובה. סקרים יכולים לכלול 2 עד 10 אפשרויות, התוצאות מתעדכנות בזמן אמת לכל המשתמשים בעמוד, ואתה בוחר מי יכול ליצור סקרים והאם ההצבעה דורשת התחברות. אין צורך להתקין דבר נוסף ב-Drupal.
נסה את הדגמת הסקרים החיים או קרא את תיעוד הסקרים כדי להגדיר אותם.