FastComments.com
Menu Icon

שפה 🇮🇱 עברית
🇺🇸 English 🇧🇬 Български 🇨🇳 简体中文 🇹🇼 繁體中文 🇭🇷 Hrvatski 🇩🇰 Dansk 🇳🇱 Nederlands 🇺🇸 English (US) 🇨🇦 Français (Canada) 🇫🇷 Français (France) 🇩🇪 Deutsch 🇨🇾 Ελληνικά (Κύπρος) 🇬🇷 Ελληνικά 🇮🇱 עברית 🇮🇹 Italiano 🇯🇵 日本語 🇰🇷 한국어 🇵🇱 Polski 🇧🇷 Português (Brasil) 🇷🇺 Русский 🇺🇦 Русский (Украина) 🇧🇦 Српски (БиХ) 🇷🇸 Srpski (Latinica) 🇲🇪 Српски (Црна Гора) 🇷🇸 Српски 🇸🇮 Slovenščina 🇪🇸 Español 🇺🇦 Українська 🇹🇷 Türkçe

תקציר

התחלה מהירה

התקנת דרופל

התקנה
תצורה
בלוקי ווידג'ט
שדות סוג תוכן
כניסה יחידה (SSO)
הרשאות
רב-לשוני
אחסון נתונים באיחוד האירופי
התאמה אישית
דרישות

הוספת תגובות חיות לאתרי דרופל

התחלה מהירה Internal Link

זו הגרסה המקוצרת (TL;DR) של ההוראות ל‑Drupal.

  1. התקן את המודול עם composer require drupal/fcom, או הנח אותו ב־modules/custom/fastcomments/.
  2. הפעל אותו באמצעות drush en fastcomments, או דרך ממשק הניהול ב־/admin/modules.
  3. גש אל Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).
  4. הזן את ה‑Tenant ID וה‑API Secret מתוך הגדרות > API/SSO (EU).
  5. הוסף את השדה FastComments לכל סוג תוכן דרך Structure > Content types > [type] > Manage fields.

המודול פורסם ב־drupal.org/project/fcom.

התקנה Internal Link

התוסף FastComments ל-Drupal מחליף את מערכת התגובות המובנית של Drupal במערכת תגובות מהירה ובזמן אמת. התוסף הוא פורסם ב-drupal.org ועובד עם Drupal 10 ו-11.

There are two ways to install it.

התקנה עם Composer

composer require drupal/fcom
drush en fastcomments

התקנה ידנית

הורד את התוסף מ-drupal.org/project/fcom והנח אותו בתיקיית האתר שלך modules/custom/fastcomments/. לאחר מכן הפעל אותו עם drush en fastcomments, או מה-UI הניהולי ב-Extend (/admin/modules).

שימו לב! התוסף תלוי רק ב-core של Drupal (user ו-field). אין מודולים או ספריות Drupal נוספות הנדרשות.

Once the module is enabled, head to the Configuration section to set up your Tenant ID and API Secret.

תצורה Internal Link

כל ההגדרות נמצאות תחת Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).

נדרש

  • Tenant ID - מזהה ה-Tenant של FastComments שלך. ניתן למצוא זאת תחת Settings > API/SSO (EU).
  • API Secret - נדרש ל-Secure SSO, אימות webhook, וסינכרון דפים. נמצא תחת Settings > API/SSO (EU).

סגנון תגובות

בחר את הווידג'ט שמתאים לאופן שבו ברצונך שאנשים ידברו באתר שלך.

  • Live Comments - תגובות מקוטלגות בחוטים בזמן אמת.
  • Streaming Chat - ממשק צ'אט חי, מתאים לאירועים והזרמות ישירות.
  • Collab Chat - הערות בהקשר באמצעות בחירת טקסט באזור התוכן הראשי. מבקרים מסמנים טקסט ומתחילים דיון בהקשר.
  • Collab Chat + Comments - גם Collab Chat וגם תגובות סטנדרטיות באותו עמוד.

מצב SSO

  • None - אין SSO. משתמשים מגיבים כאורחים או יוצרים חשבון FastComments.
  • Simple - מעביר מידע משתמש מחוץ ל-Drupal (שם, אימייל, אוואטר) ל-FastComments ללא אימות בצד השרת.
  • Secure - משתמש ב-HMAC-SHA256 כדי לאמת משתמשי Drupal מול FastComments. מומלץ כאשר יש לך API Secret מוגדר.

ראה את הסעיף Single Sign-On (SSO) לפרטים.

הגדרות נוספות

  • CDN URL - ברירת מחדל היא https://cdn.fastcomments.com.
  • Site URL - ברירת מחדל היא https://fastcomments.com.
  • Email notifications - שלח אימייל למחבר התוכן כאשר תגובה חדשה מתפרסמת על התוכן שלו.

לנושא שהות נתונים באיחוד האירופי, ראה את הסעיף EU Data Residency.

בלוקי ווידג'ט Internal Link

המודול מכיל כמה בלוקים שניתן למקם דרך 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 ומסלולים מותאמים אישית ללא כל הגדרה נוספת.

שדות סוג תוכן Internal Link

ברוב האתרים, הדרך הקלה ביותר להוסיף תגובות היא לצרף את השדה FastComments לסוגי התוכן שלך. עבור אל Structure > Content types > [type] > Manage fields והוסף את השדה.

לכל ישות שיש לה את השדה יתווספו:

  • מתג סטטוס שמאפשר לעורכים להפעיל או לכבות תגובות עבור כל ישות.
  • מזהה מותאם אישית אופציונלי, כדי שתוכלו להשתמש ב‑ID יציב שאינו קשור לנתיב הישות ב‑Drupal.

הבלוק הראשי FastComments Widget מודע לשדה זה, וידלג על ישויות שכבר מחוברות אליו. כך תוכלו לשלב תגובות לפי ישות יחד עם הבלוק מבלי שהווידג'ט יופיע פעמיים באותו עמוד.

כניסה יחידה (SSO) Internal Link

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 במסמכי ההתאמות האישיות.

הרשאות Internal Link

התוסף מוסיף שלוש הרשאות של Drupal שניתן להקצות לפי תפקיד תחת People > Permissions.

  • Administer FastComments - גישה לטופס ההגדרות של FastComments ב־/admin/config/content/fastcomments.
  • View FastComments - נדרש כדי לראות את ווידג'ט התגובות. ללא הרשאה זו הווידג'ט לא ייטען.
  • Toggle FastComments - מאפשר למשתמשים להפעיל או לכבות תגובות עבור כל ישות בנפרד באמצעות ווידג'ט השדה.

כברירת מחדל, רק משתמשים שיש להם את ההרשאה administer site configuration יכולים לשנות את הגדרות FastComments. העניקו את View FastComments למשתמשים אנונימיים ומאומתים אם אתם רוצים שמבקרים יראו את הווידג'ט.

רב-לשוני Internal Link

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

זה חל על כל סוגי הווידג'טים: Live Comments, Streaming Chat, Collab Chat, Image Chat, Recent Comments, ו-Top Pages.

אחסון נתונים באיחוד האירופי Internal Link

אם חשבון 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. כל השאר במודול עובד באותו אופן.

התאמה אישית Internal Link

FastComments תוכנן להיות מותאם אישית כך שיתאים לאתר שלך.

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

דרישות Internal Link

  • Drupal 10 או 11
  • PHP 8.1 או חדש יותר
  • חשבון FastComments

המודול אינו דורש מודולים נוספים ל-Drupal או ספריות צד-שלישי. הוא תלוי רק בליבת Drupal (user, field).

מנגנון גיבוי <noscript> מספק תגובות המוצגות בצד השרת עבור מבקרים ללא JavaScript, כך ש-Live Comments ו-Streaming Chat עדיין פועלים בדפדפנים שבהם הסקריפטים מושבתים.

תרום למדריך זה