Add Live Commenting to Drupal Sites

התוסף 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.

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

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

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