התאמות וקונפיגורציה

יתכן שתגלה כי הווידג'ט לתגובות ניתן לשימוש עם מזהה שוכר (Tenant ID) של "demo", למשל:

Demo Tenant ID

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo"

7}];

8</script>

9

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

Defining Your Tenant ID

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "aKa2Z4Q="

7}];

8</script>

9

מזהה השוכר שלך כבר מיושם על הווידג'ט לתגובות ב-קטע הקוד בחשבונך.

תוכל גם למצוא את מזהה השוכר שלך ולנהל את מפתחות ה-API שלך בעמוד האישורים של ה-API.

מרגע זה, אם אתה מחובר ל-FastComments, דוגמאות הקוד ישתמשו במזהה השוכר האמיתי שלך (אם אתה מחובר ב־https://fastcomments.com).

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

לצורך כך, אנו משתמשים במשהו שאנו קוראים לו "URL ID". זהו מזהה, כגון מחרוזת או מספר, או כתובת URL.

בברירת מחדל, אם אינך מציין את ה‑urlId, הוא יהפוך לכתובת ה‑URL של הדף. אנו ניקח את כתובת ה‑URL של הדף הנוכחי וננקה אותה כדי להסיר פרמטרים שיווקיים נפוצים או מזהי מעקב.

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

הגדרת מזהה URL מותאם

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "urlId": "https://example.com/page"

8}];

9</script>

10

דבר אחד שנזכיר לעיתים קרובות במסמך זה הוא Widget Customization UI.

ממשק משתמש זה ניתן להשתמש בו כדי לבצע שינויים רבים בווידג'ט התגובות ללא כתיבת קוד.

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

כל זה אפשרי באמצעות שדה הקלט של מזהה ה‑URL בעמוד זה, שנראה כך:

קלט מזהה URL בדף התאמת הווידג'ט

הערך בשדה זה צריך להתאים לפרמטר urlId שמועבר לווידג'ט התגובות. אם ברצונך שהכלל שלך יהיה בלתי תלוי ב‑urlId, השאר שדה זה ריק או הזן *.

מאז 2023 שדה URL ID בהתאמת הווידג'ט תומך גם בתבניות! לדוגמה, ניתן להשתמש ב‑*/blog/* כדי להוסיף עיצוב ספציפי לבלוג שלך וב‑*/store/* כדי להוסיף עיצוב ספציפי לחנות שלך, וכל זאת תוך שימוש באותו דומיין.

תופעות לוואי

1. אם לעמוד שלך יש פרמטרי hash (כגון example.com#page-1) – הם יהפכו לחלק ממזהה ה‑URL, כברירת מחדל.
2. במהלך העברות, לדוגמה מ‑WordPress ל‑Gatsby, ייתכן שתצטרך להעביר את ערכי תגובות ה‑URL ID לאחר ההעברה הראשונית. לשם כך, פנה אלינו.

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

הגישה הראשונה, הקלה ביותר והעדיפה על ידינו, היא להשתמש בדף התאמת הווידג'ט.

בדף התאמת הווידג'ט, ראה את סעיף "הצגת אפשרויות מתקדמות", מתחתיו יש אזור המסומן "CSS מותאם":

אזור קלט CSS מותאם

לגישה זו יש כמה יתרונות:

1. ה‑CSS שהוזן מצומצם לפני שנשלח למשתמש, והעיצוב נשמר עקבי בממשק העריכה.
2. אתה מקבל את כל היתרונות של ממשק התאמת הווידג'ט, למשל התאמה קלה של הווידג'ט למקומות שונים.
3. כאשר אנו מבצעים שינויים בווידג'ט ההערות, העיצוב המותאם שלך ייבדק כחלק מתהליך השחרור שלנו.

הגישה השנייה היא לציין את הפרמטר customCSS בתצורת הווידג'ט, כך:

העברת CSS מותאם

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "customCSS": "button { background: red; }"

8}];

9</script>

10

עם זאת, יש להגבלות:

1. יש מגבלה על כמות ה‑CSS המותאם שניתן להעביר לפני שהשרתים שלנו ידחו את הבקשה, עקב גודל הכותרות.
2. עליך לנהל את ה‑CSS המותאם בתשתית ובמערכת הבנייה שלך. זה עשוי להיות יתרון ולא חיסרון, גם כן.
3. יש עומס נוסף של שליחת ה‑CSS המותאם ברשת פעמיים במצב זה, שכן הוא נשלח לשרתים שלנו, ואז חוזר לתוכן ה‑iframe. עם זאת, עבור רוב גדלי המטען, זה אינו מורגש.
4. אופטימיזציה נפוצה היא צמצום ה‑CSS כדי להפחית את גודלו ברשת, אך בגישה זו תצטרך לטפל בכך בעצמך.
5. ה‑CSS המותאם שלך לא ייבדק כאשר אנו מבצעים שינויים.

קבצי CSS חיצוניים

אתה יכול לגרום לווידג'ט למשוך קובץ חיצוני באמצעות @import!

מומלץ למקם את @import בכלל התאמה. כך, אם נצטרך לשנות את הווידג'ט, נוכל להשתמש באוטומציה שלנו כדי לאמת את ההגדרה שלך. לדוגמה, תיצור כלל התאמה בממשק התאמת הווידג'ט, תלחץ על מתקדם, ותזין ב‑CSS מותאם:

@import url(https://example.com/styles.css);

בקוד - לא מומלץ

אתה יכול גם לטעון קובץ CSS חיצוני דרך המאפיין customCSS:

קובץ CSS חיצוני

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "customCSS": "@import url(https://example.com/styles.css);"

8}];

9</script>

10

עם זאת, זכור שה‑CSS שלך לא ייבדק על ידינו אם תעשה זאת.

עיצוב מודל פרופיל משתמש

מודלים של פרופיל משתמשים ניתנים גם הם לעיצוב עם CSS מותאם. עם זאת, כדי להבטיח שהעיצוב המותאם יוחל על פרופילי משתמשים, כל בוררי ה‑CSS חייבים להיות עם קידומת .user-profile. ללא קידומת זו, העיצוב המותאם יתעלם ממודלים של פרופיל משתמש.

לדוגמה:

CSS פרופיל משתמש

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "customCSS": ".user-profile .profile-name { color: blue; }"

8}];

9</script>

10

תאימות לאחור

ב‑FastComments, אנו יודעים שהלקוחות שלנו מתאימים את ווידג'ט ההערות. זה מתוכנן – הדבר האחרון שאנחנו רוצים הוא שהמוצר שלנו יגרום לחוסר התאמה בעיצוב במוצר שלך.

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

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

ללקוחות בעלי חשבונות Pro או Enterprise מותר מיתוג לבן. פשוט פנו אלינו ונשמח לעזור.

אם ברצונכם להסיר את הלוגו שלנו מהווידג'ט התגובות בלבד, אפשרות זו מופעלת אוטומטית בתכניות Flex ו-Pro.

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

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

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

עבור הווידג'ט של VanillaJS, נצטרך לבצע עוד עבודה. קודם כל, FastCommentsUI מחזירה אובייקט עם הפונקציות "destroy" ו-"update".

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

דוגמה מלאה להחלפת מצב כהה

Copy Run

1

2<script src="https://fastcomments.com/js/embed-v2.min.js"></script>

3<button id="toggle-dark-mode">Toggle Dark Mode</button>

4<div id="fastcomments-widget"></div>

5<script>

6 (function() {

7 const button = document.getElementById('toggle-dark-mode');

8 const config = {

9 tenantId: 'demo',

10 hasDarkBackground: false

11 };

12 const instance = window.FastCommentsUI(document.getElementById('fastcomments-widget'), config);

13 button.addEventListener('click', function() {

14 config.hasDarkBackground = !config.hasDarkBackground;

15 if (config.hasDarkBackground) {

16 document.body.classList.add('dark');

17 } else {

18 document.body.classList.remove('dark');

19 }

20 instance.update(config);

21 });

22 })();

23</script>

24<style>

25 body.dark {

26 background: #000;

27 color: #fff;

28 }

29</style>

30

עם FastComments, כל הטקסט בווידג'ט ההערות ניתן להתאמה.

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

בברירת מחדל, הטקסט בווידג'ט ההערות מתורגם בהתאם לשפת המשתמש. עם זאת, ניתן לשנות את הטקסט, אם אנחנו בטוחים שהקהל שלנו משתמש באותו אזור/שפה, לדוגמה:

טקסט מותאם

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "translations": {

8 "SUBMIT_REPLY": "Reply"

9 }

10}];

11</script>

12

כל התרגומים הניתנים להתאמה ניתן למצוא כאן תחת הלשונית "אפשרויות מתקדמות" tab.

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

טקסט מותאם

כל ההחלפות של תרגומים משפיעות כעת על כל האזורים.

זה מכסה את הטקסט של הווידג'ט עצמו. כדי לתרגם את ההערות שהמבקרים שלך כותבים, ראה Comment Translation.

כאשר משתמש מגיב עם FastComments בפעם הראשונה, אנו ננסה לאחזר את תמונת הפרופיל שלו מ-https://gravatar.com/.

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

כדי לציין תמונת פרופיל סטטית משלך, ניתן להשתמש בהגדרה defaultAvatarSrc.

Override The Default Avatar

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "defaultAvatarSrc": "https://example.com/some-image.png"

8}];

9</script>

10

זה גם ניתן לבצע ללא קוד. בעמוד התאמת הווידג'ט, ראו את הסעיף "Default Avatar".

התאמת Avatar ברירת המחדל

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

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

Hiding Avatars

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "hideAvatars": true

8}];

9</script>

10

ניתן להתאים זאת ללא קוד, בעמוד התאמת הווידג'ט:

הסתרת אווטארים

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

כל העיצוב ברירת המחדל ניתן להסרה על‑ידי הגדרת הפרמטר noStyles ל‑true, כך:

השבתת כל סגנונות ברירת המחדל

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "noStyles": true

8}];

9</script>

10

זה ניתן להתאמה ללא קוד, בעמוד התאמת הווידג'ט, תחת אפשרויות מתקדמות:

השבתת כל סגנונות ברירת המחדל

בברירת מחדל, תגובות לתגובות ברמה העליונה מוצגות.

ניתן להגדיר זאת כך שהמשתמש יצטרך ללחוץ על "Show Replies" בתגובות ברמה העליונה כדי לראות את התגובות המשניות.

Collapse Replies to Top Level Comments

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "collapseReplies": true

8}];

9</script>

10

ניתן להתאים זאת ללא קוד, בעמוד התאמת הווידג'ט:

Collapse Replies

הגדרה זו לא תשפיע על מספר תגובות ברמה העליונה שנטענות בתחילה. אם יש לך תגובה אחת ברמה העליונה, ו‑29 תגובות משניות, עם הגדרה זו פעילה, אתה ת:

• ראה את תגובת הרמה העליונה.
• ראה את "Show Replies" (29) מתחת לתגובה זו.

אם ברצונך להציג את כל תגובות הרמה העליונה בשילוב עם אפשרות זו, הגדר את דף התחלה ל‑-1.

בברירת מחדל, הפונקציות של עיצוב ב‑FastComments מתבצעות על‑ידי הוספת תגי עוגן גלויים כמו <b></b> סביב הטקסט שלך. לחיצה על סרגל הכלים או שימוש בקיצורים עושה זאת עבורך. עם זאת, קהילות מסוימות עשויות לרצות להשתמש בעיצוב ללא תגי עוגן. זה נקרא הפעלת WYSIWYG (what you see is what you get) editor. עורך זה נראה בדיוק כמו העורך ברירת המחדל, אלא שהוא טוען קוד נוסף המאפשר למשתמשים להדגיש, לקו תחתי, וכו' את הטקסט שלהם ללא תגי עוגן גלויים.

הפעלת עריכת WYSIWYG

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableWYSIWYG": true

8}];

9</script>

10

זה גם ניתן לבצע ללא קוד. בעמוד התאמה אישית של הווידג'ט, ראה את האפשרות "Enable Advanced Formatting".

הפעלת WYSIWYG

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

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

השבתת סרגל הכלים

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableToolbar": true

8}];

9</script>

10

זה גם ניתן לבצע ללא קוד. בעמוד התאמת הווידג'ט, ראו את האפשרות "Disable The Reply Toolbar".

השבתת סרגל הכלים

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

ייתכן ויהיה רצוי להשבית פונקציונליות זו. ניתן לעשות זאת כך:

Disable Blocking

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableBlocking": true

8}];

9</script>

10

ניתן גם לבצע זאת ללא קוד, מה שמאפשר גם אימות צד‑שרת תקין, דרך ממשק התאמה אישית של הווידג'ט:

השבתת חסימה

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

ייתכן שיהיה צורך או רצון להשתמש בתאריכים מוחלטים, ובמקרה זה אתה מגדיר את הפרמטר הזה ל true.

Use Absolute Dates

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "absoluteDates": true

8}];

9</script>

10

זה ניתן להתאמה ללא קוד, בדף התאמת הווידג'ט, תחת אפשרויות מתקדמות:

Use Absolute Dates

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

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

Use Both Absolute and Relative Dates

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "absoluteAndRelativeDates": true

8}];

9</script>

10

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

השתמש גם בתאריכים מוחלטים וגם בתאריכים יחסיים

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

אנו קוראים לזה הכותרת, ובברירת מחדל היא מוסתרת.

Specifying Header HTML

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "headerHTML": "<h1>Leave a Comment!</h1>"

8}];

9</script>

10

ניתן להתאים זאת ללא קוד, בדף התאמת הווידג'ט, תחת אפשרויות מתקדמות:

ציון HTML של הכותרת

בברירת מחדל, FastComments יציג קישורים כך: https://exmaple.com - כאשר כתובת הקישור הופכת לקישור שניתן ללחוץ עליו תג HTML של קישור.

אתרים מסוימים עשויים לרצות להשבית זאת, לדוגמה כדי למנוע הונאות. אנו מספקים זאת על‑ידי הגדרת Comment HTML Rendering Option ל‑Links as Text.

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

הצגת קישורים כטקסט

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

עם זאת, ניתן להסתיר את וידג'ט ההערות מאחורי כפתור, לדוגמה:

לחץ כדי להציג תגובות

הכפתור משתמש בטקסט מתורגם שונה בהתאם אם ההערות מוצגות כרגע או לא. אם ההערות מוסתרות, הוא משתמש ב-translations.SHOW_COMMENTS_BUTTON_TEXT. אם ההערות מוצגות, הוא משתמש ב-translations.HIDE_COMMENTS_BUTTON_TEXT. התרגומים יכולים להכיל את הטקסט [count] אשר יוחלף בספירה המתורגמת.

Click to Show or Hide Comments

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "useShowCommentsToggle": true

8}];

9</script>

10

זה נועד להחליף את תצורת hideCommentsUnderCountTextFormat.

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

זה ניתן להפעיל ללא קוד על ידי יצירת כלל התאמה והפעלת "לחץ כדי להציג תגובות":

הפעלת לחצן להצגת תגובות

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

ניתן להחליף זאת בכל מחרוזת, והערך [count] יוחלף בערך הספירה, המתורגם למשתמש.

Customizing The Comment Count Text

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "commentCountFormat": "There are [count] comments."

8}];

9</script>

10

ניתן להתאים זאת ללא קוד, בעמוד התאמת הווידג'ט:

Customizing The Comment Count Text

כאשר משתמשים מזינים האשטאגים, בצורה של #someexampletag, FastComments תיצור אוטומטית את ה-HashTag הזה ותדגיש אותו בתגובה שלהם.

במקרים מסוימים רצוי להשבית תכונה זו, או לשלוט באילו האשטאגים ניתן להשתמש דרך ה-API.

כדי לעשות זאת, פשוט אפשרו את Disable Automatic #hashtag Creation דרך ממשק התאמה אישית של הווידג'ט.

השבתת יצירת HashTag אוטומטית

בברירת מחדל, FastComments יציג פעמון התראות בפינה הימנית העליונה של אזור ההערות.

פעמון זה יהפוך לאדום ויציג ספירה של מספר ההתראות שיש למשתמש. כמה דוגמאות להתראות הן:

• המשתמש השיב לך.
• המשתמש השיב בשרשור שבו הגבת.
• המשתמש הצביע בעד ההערה שלך.
• המשתמש השיב לעמוד שאתה מנוי עליו.

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

עם זאת, ניתן להשבית את פעמון ההתראות לחלוטין:

Disable Notification Bell

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableNotificationBell": true

8}];

9</script>

10

זה גם ניתן לבצע ללא קוד. בעמוד התאמת הווידג'ט, ראה את הסעיף "Disable Notification Bell" section.

השבתת פעמון ההתראות

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

עם זאת, אנו יכולים להשבית פונקציונליות זו:

השבתת פרופילים

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableProfiles": true

8}];

9</script>

10

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

השבתת פרופילים

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

עם זאת, אנו יכולים להשבית לשונית זו:

Disable Profile Comments

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableProfileComments": true

8}];

9</script>

10

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

השבתת הערות פרופיל

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

עם זאת, אנו יכולים להשבית לשונית זו:

Disable Profile Direct Messages

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableProfileDirectMessages": true

8}];

9</script>

10

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

הפסק הודעות ישירות בפרופיל

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

השבתת הודעת הצלחה

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableSuccessMessage": true

8}];

9</script>

10

ניתן לבצע זאת גם ללא קוד. בדף התאמת הווידג'ט:

השבתת הודעת הצלחה

בברירת מחדל, וידג'ט ההערות של FastComments יגדיר gif rating של pg.

האפשרויות הזמינות הן g, pg, pg-13, ו-r.

ניתן להגדיר זאת בקוד או דרך הממשק. בקוד אפשר לעשות זאת כך:

Set Gif Rating

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "gifRating": "pg-13"

8}];

9</script>

10

בממשק, תמצאו זאת תחת Gif Picker Rating כל עוד Disable Image Uploads? אינו מסומן.

הגדרת דירוג ה‑Gif

בברירת מחדל, וידג'ט ההערות של FastComments מכבה את המודרציה של תוכן תמונות (off).

האפשרויות הזמינות הן off, low, medium ו-high.

בממשק התאמה אישית של הווידג'ט, תמצאו זאת תחת Image Content Moderation Level כל עוד Disable Image Uploads? אינו מסומן.

הגדרת רמת מודרציה של תוכן תמונות

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

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

אנו משתמשים בדגל voteStyle כך:

הפעלת כפתור לב

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "voteStyle": 1

8}];

9</script>

10

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

שינוי סגנון הצבעה

ניתן גם להשבית הצבעה, ראה Disable Voting מעל אפשרויות הסגנון.

בברירת מחדל, FastComments תאפשר למשתמשים למחוק את ההערות שלהם.

עם זאת, ניתן למנוע זאת.

בדף התאמת הווידג'ט, ראו את "Disable Deleting" אפשרות.

השבת מחיקת תגובות

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

בברירת מחדל, FastComments תאפשר למשתמשים לערוך את ההערות שלהם.

עם זאת, ניתן למנוע זאת.

בדף התאמת הווידג'ט, ראו את האפשרות "השבת עריכה".

השבת עריכת תגובות

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

בברירת מחדל, גודל העמוד של FastComments הוא 30. זה כולל תגובות בשרשורים.

ניתן להתאים את גודל העמוד בממשק תצורת הווידג'ט בגדלים שונים הנעים בין 10 ל‑200.

שימו לב ששינוי גודל העמוד דורש חישוב מחדש של כל שרשורי ההערות בחשבון שלכם. זה עשוי לקחת כמה דקות.

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

דוגמת תצורה מוצגת למטה:

גדלים מותאמים של דף

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

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

בברירת מחדל, FastComments יציג את שם המשתמש כפי שהוזן, או כפי שהועבר אלינו דרך SSO.

עם זאת, ייתכן ויהיה רצוי להסתיר או להציג את שם המשתמש בצורה שונה. לדוגמה, אם שם המשתמש הוא Allen Rex, אולי תרצה להציג רק "Allen R.".

זה ניתן לבצע ללא קוד בממשק התאמה אישית של הווידג'ט, תחת ההגדרה שנקראת Commenter Name Format:

שנה פורמט שם

הפורמטים הזמינים הם:

• Capitalize (הצגת משתמש לדוגמה כ-Example User)
• Last Initial (הצגת Example User כ-Example U.)
• All Initials (הצגת Example User כ-E. U.)
• הצג "Anonymous"

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

שמות המשתמשים מוסתרים בצד השרת כדי להגן על המשתמשים.

בברירת מחדל, FastComments מאפשר העלאת תמונות. ניתן להשבית זאת על‑ידי הגדרת הדגל noImageUploads ל‑true.

השבתת העלאת תמונות

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "noImageUploads": true

8}];

9</script>

10

ניתן להתאים זאת ללא קוד, בעמוד התאמת הווידג'ט:

השבתת העלאת תמונות

כברירת מחדל, FastComments אינו מאפשר iframes בתגובות. כאשר מפעילים הטמעות מדיה, מגיבים יכולים להדביק את קוד ההטמעה (קטע ה-<iframe>) מספקים מהימנים כמו YouTube, Vimeo, SoundCloud ו-Spotify, והוא יוצג בתוך התגובה.

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

זה נעשה ללא קוד, בדף התאמה אישית של הווידג'ט:

אפשר הטמעות מדיה

הוספת ספקים משלך

אם ברצונך לאפשר הטמעות מספק שאינו ברשימה המובנית של הספקים המהימנים, הוסף את שם המארח שלו בשדה "Additional Embed Domains" באותו דף. שמות מארחים אלה מותרים בנוסף לספקים המובנים. ההתאמה היא מדויקת, ולכן יש לכלול את שם המארח המלא (לדוגמה, player.example.com). כל דבר שלא תוסיף לרשימה יישאר חסום.

גם תיבת התגובות הרגילה וגם עורך ה-WYSIWYG תומכים בהדבקת הטמעה. בעורך ה-WYSIWYG ההטמעה מוכנסת כבלוק ניתן להסרה.

בברירת מחדל, אין תיבת חיפוש מוצגת בווידג'ט ההערות.

עם זאת, ניתן להפעיל זאת על ידי הגדרת הדגל enableSearch ל‑true:

הפעלת חיפוש

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableSearch": true

8}];

9</script>

10

זה גם ניתן לבצע ללא קוד. בעמוד התאמת הווידג'ט, ראו את האפשרות "Enable Search Box".

הפעלת תיבת חיפוש

אנו יכולים להפעיל תמיכת ספולרים על ידי הגדרת הדגל enableSpoilers ל‑true:

הפעלת ספולרים

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableSpoilers": true

8}];

9</script>

10

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

הפעלת ספולרים

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

זה גם תואם לעורך WYSIWYG.

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

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

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

אנו יכולים להפעיל זאת על ידי הגדרת הדגל enableViewCounts ל‑true:

Enabling Comment View Counts

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableViewCounts": true

8}];

9</script>

10

זה ניתן להתאמה ללא קוד, בעמוד התאמת הווידג'ט:

הפעלת ספירות צפייה בתגובות

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

• *הערה: או מזהה הסשן האנונימי, או כתובת ה‑IP של המשתמש כערך מוצפן.

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

עם זאת, בברירת מחדל התגובות החדשות יופיעו תחת כפתור שמוצג דינמית עם טקסט דומה ל-"Show 2 New Comments".

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

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

בחלק מהמקרים, כמו מכרזים חיים או אירועים מקוונים, זה אינו ההתנהגות הרצויה - ייתכן שתרצו שהווידג'ט של התגובות יהיה דומה יותר לתיבת "chat" שבה תגובות חדשות "show right away".

לכן, שם הדגל שמאפשר תכונה זו: showLiveRightAway.

ניתן להפעיל אותו כך:

Show Live Comments Right Away

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "showLiveRightAway": true

8}];

9</script>

10

ניתן להתאים זאת ללא קוד, בעמוד התאמה אישית של הווידג'ט:

הצג תגובות חיות מייד

בברירת מחדל, FastComments יפעיל תגובות בזמן אמת.

זה אומר שכל צופה בשרשרת ההערות צריך לראות את אותו תוכן.

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

עם זאת, ניתן להשבית זאת:

Disable Live Commenting

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableLiveCommenting": true

8}];

9</script>

10

זה גם ניתן לבצע ללא קוד. בעמוד התאמת הווידג'ט, ראו את המקטע "Disable Live Commenting".

השבתת תגובות בזמן אמת

בברירת מחדל, FastComments ימיין תגובות לפי כיוון המיון "הכי רלוונטי".

מיון הכי רלוונטי מתחשב בזמן שהתגובה נכתבה ובמספר הקולות לצורך המיון.

המשתמש יכול לאחר מכן לשנות את כיוון המיון ל"ישן ראשון" או "חדש ראשון" בממשק הווידג'ט של התגובות.

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

שינוי המיון ברירת המחדל לישן ראשון

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "defaultSortDirection": "OF"

8}];

9</script>

10

אנו מגדירים את ערך defaultSortDirection ל-"OF" כדי לקבוע את הכיוון ל-"OF".

לכיוון המיון "חדש ראשון", נבצע את הפעולה הבאה:

שינוי המיון ברירת המחדל לחדש ראשון

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "defaultSortDirection": "NF"

8}];

9</script>

10

הערכים החוקיים עבור defaultSortDirection הם:

• MR: "Most Recent"
• NF: "Newest First"
• OF: "Oldest First"

ניתן לבצע זאת גם ללא קוד. בעמוד התאמת הווידג'ט, ראה את הסעיף "Default Sort Direction".

שינוי כיוון המיון ברירת המחדל

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

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

Moving The Reply Box to The Bottom

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "inputAfterComments": true

8}];

9</script>

10

זה ניתן להתאמה אישית ללא קוד, בעמוד התאמת הווידג'ט:

הזזת תיבת התגובה לתחתית

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

ברירת המחדל היא 2000.

פריטים כגון כתובות URL של תמונות אינם נכללים בחישוב האורך.

הגבלת אורך תגובה

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "maxCommentCharacterLength": 500

8}];

9</script>

10

ניתן להתאים זאת ללא קוד, בדף התאמה אישית של הווידג'ט:

הגבלת אורך תגובה

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

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

אנו מפעילים את הדגל useSingleLineCommentInput כך:

הפעלת קלט תגובה בשורה אחת

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "useSingleLineCommentInput": true

8}];

9</script>

10

ניתן לבצע זאת גם ללא קוד. בדף התאמה אישית של הווידג'ט, ראו את הסעיף "Enable Single-Line Comment Input".

הפעלת קלט תגובה בשורה אחת

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

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

זה נרשם לפי מזהה משתמש, מזהה משתמש אנונימי, וכתובת IP (בצורת hash).

ניתן להתאים זאת ללא קוד, בעמוד התאמת הווידג'ט:

הגבלת נפח תגובות לכל משתמש

שימו לב שאם אתם משתמשים ב‑API ליצירת תגובות, ייתכן שתרצו להעביר את כתובת ה‑ip המקורית של המשתמש בבקשה אל ה‑backend שלנו כך שמגבלת הקצב תוחל על כל משתמש ולא באופן גלובלי על החשבון שלכם.

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

כאשר מופעל:

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

תצורה

נווט לדף התאמה אישית של הווידג'ט והפעל את תיבת הסימון "Require Terms of Service acceptance". לאחר ההפעלה, תראה את האפשרויות הבאות:

אפשרויות תנאי שירות

• מצב טקסט של תנאי השירות: כברירת מחדל, תיבת הסימון מציגה "I agree to the Terms of Service and Privacy Policy" עם קישורים לשני המסמכים. בחר "Customize text per locale" כדי לספק את הטקסט שלך לכל שפה.
• תאריך העדכון האחרון של תנאי השירות: כאשר אתה מעדכן את תנאי השירות שלך, הגדר תאריך זה. משתמשים שהסכימו לפני תאריך זה יידרשו להסכים שוב.

איך זה עובד

• חותמת הזמן של קבלת תנאי השירות נשמרת לכל משתמש ולכל תגובה
• כאשר משתמש מקבל את תנאי השירות, התאריך נרשם בפרופיל המשתמש שלו (לכל שוכר)
• אם אתה מגדיר תאריך "Last Updated" שהוא אחרי תאריך הקבלה של המשתמש, הוא יצטרך להסכים מחדש
• למשתמשים אנונימיים שלא ניתן לעקוב אחריהם, תיבת הסימון מופיעה בכל שליחת תגובה

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

סקרים כבויים כברירת מחדל. סמן Enable Polls בהגדרות התאמת הווידג'ט כדי להוסיף כפתור סקר לסרגל הכלים של התגובה. שני הגדרות נוספות יופיעו:

• Who Can Create Polls: רק מנהלים/מנחים (ברירת המחדל), או כולם.
• Allow Anonymous Poll Votes: כאשר לא מסומן (ברירת המחדל), רק משתמשים מחוברים יכולים להצביע.

הפעל סקרים

ראה את Polls guide לקבלת מידע על יצירה, הצבעה, פרטיות והודעות סקר.

FastComments Secure SSO משתמש בהצפנת HMAC-SHA256 כמנגנון למימוש SSO. ראשית נסקור את הארכיטקטורה הכללית, נספק דוגמאות, ושלבים מפורטים.

קיימת גם תיעוד בנוגע להגירה מספקים אחרים עם מנגנוני SSO דומים, וההבדלים ביניהם.

הזרימה נראית כך:

זרימת Secure SSO

מכיוון ש-Secure SSO כולל פיתוח full-stack, דוגמאות קוד עובדות מלאות ב-Java/Spring, NodeJS/Express ו-PHP רגיל זמינות כעת ב-GitHub.

למרות שאנו משתמשים ב-ExpressJS בדוגמת ה-NodeJS וב-Spring בדוגמת ה-Java, אין צורך בפריימוורקים/ספריות בסביבות ריצה אלו למימוש FastComments SSO - חבילות ה-crypto המובנות מספיקות.

אינכם צריכים לכתוב נקודות קצה (API endpoints) חדשות עם FastComments SSO. פשוט הצפינו את פרטי המשתמש באמצעות מפתח הסוד שלכם והעבירו את ה-payload לווידג'ט התגובות.

קבלת מפתח הסוד של ה-API

ניתן לאחזר את מפתח הסוד של ה-API מעמוד זה. ניתן למצוא עמוד זה גם על ידי כניסה ל-My Account, לחיצה על אריח ה-API/SSO, ולאחר מכן לחיצה על "Get API Secret Key".

פרמטרים של ווידג'ט התגובות

תיעוד API ברמה גבוהה עבור ווידג'ט התגובות זמין כאן.

בואו נצלול לפרטים נוספים לגבי משמעות הפרמטרים הללו.

ווידג'ט התגובות מקבל אובייקט קונפיגורציה - אתם כבר מעבירים אותו אם אתם משתמשים ב-FastComments להעברת מזהה הלקוח שלכם (הנקרא tenantId).

כדי להפעיל SSO, העבירו אובייקט "sso" חדש, שחייב לכלול את הפרמטרים הבאים. הערכים צריכים להיווצר בצד השרת.

• userDataJSONBase64: נתוני המשתמש בפורמט JSON, אשר מקודדים לאחר מכן ב-Base64.
• verificationHash: ה-hash של HMAC-SHA256 שנוצר מ-UNIX_TIME_MILLIS + userDataJSONBase64.
• timestamp: חותמת זמן Epoch, במילישניות. אסור שתהיה בעתיד, או יותר מיומיים בעבר.
• loginURL: כתובת URL שווידג'ט התגובות יכול להציג להתחברות המשתמש.
• logoutURL: כתובת URL שווידג'ט התגובות יכול להציג להתנתקות המשתמש.
• loginCallback: כאשר מסופק במקום כתובת ההתחברות, פונקציה שווידג'ט התגובות יפעיל בלחיצה על כפתור ההתחברות.
• logoutCallback: כאשר מסופק במקום כתובת ההתנתקות, פונקציה שווידג'ט התגובות יפעיל בלחיצה על כפתור ההתנתקות.

קוד צד הלקוח של Secure SSO

Copy

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "sso": {

8 "userDataJSONBase64": "...",

9 "verificationHash": "...",

10 "timestamp": 1794130022266.0,

11 "loginURL": "https://example.com/login",

12 "logoutURL": "https://example.com/logout",

13 "loginCallback": null,

14 "logoutCallback": null

15 }

16}];

17</script>

18

אובייקט המשתמש

אובייקט המשתמש מכיל את הסכמה הבאה:

אובייקט המשתמש

Copy

1

2interface SSOUser {

3 /** חובה. מקסימום 1k תווים. **/

4 id: string;

5 /** חובה. מקסימום 1k תווים. הערה: חייב להיות ייחודי. **/

6 email: string;

7 /** חובה. מקסימום 1k תווים. הערה: שם המשתמש לא יכול להיות כתובת אימייל. לא חייב להיות ייחודי. **/

8 username: string;

9 /** אופציונלי. מקסימום 3k תווים עבור כתובות URL. ברירת המחדל היא מ-gravatar לפי האימייל. תומך בתמונות מקודדות 64, ובמקרה זה המגבלה היא 50k תווים. **/

10 avatar?: string;

11 /** אופציונלי. ברירת מחדל false. **/

12 optedInNotifications?: boolean;

13 /** אופציונלי. ברירת מחדל false. **/

14 optedInSubscriptionNotifications?: boolean;

15 /** אופציונלי. מקסימום 100 תווים. תווית זו תוצג ליד שם המשתמש. ברירת המחדל היא Administrator/Moderator כשרלוונטי. **/

16 displayLabel?: string;

17 /** אופציונלי. מקסימום 500 תווים. יוצג במקום שם המשתמש. **/

18 displayName?: string;

19 /** אופציונלי. מקסימום 2k תווים. שם המשתמש יקושר לכתובת זו. **/

20 websiteUrl?: string;

21 /** אופציונלי. עד 100 קבוצות למשתמש. מזהה קבוצה לא יכול להיות ארוך מ-50 תווים. **/

22 groupIds?: string[];

23 /** אופציונלי. מסמן את המשתמש כמנהל מערכת. **/

24 isAdmin?: boolean;

25 /** אופציונלי. מסמן את המשתמש כמנחה (moderator). **/

26 isModerator?: boolean;

27 /** אופציונלי, ברירת מחדל true. הגדירו ל-false כדי להפעיל את טאב ה"פעילות" בפרופיל המשתמש. **/

28 isProfileActivityPrivate?: boolean;

29 /** אופציונלי, ברירת מחדל false. הגדירו ל-true כדי להשבית תגובות פרופיל. **/

30 isProfileCommentsPrivate?: boolean;

31 /** אופציונלי, ברירת מחדל false. הגדירו ל-true כדי להשבית שליחת הודעות ישירות למשתמש זה. **/

32 isProfileDMDisabled?: boolean;

33 /** הגדרות אופציונליות עבור תגי משתמש. **/

34 badgeConfig?: {

35 /** מערך של מזהי תגים גלובליים להקצאה. מוגבל ל-30 תגים. הסדר נשמר. **/

36 badgeIds: string[];

37 /** מערך של מזהי תגים המוגבלים לעמוד הנוכחי (urlId). מוצגים רק בעמוד שהוקצה להם. **/

38 pageBadgeIds?: string[];

39 /** אם true, מחליף תגים מוצגים קיימים. גלובליים ותגי עמוד מוחלפים באופן עצמאי. **/

40 override?: boolean;

41 /** אם true, מעדכן את מאפייני התצוגה של התגים מקונפיגורציית הטננט. **/

42 update?: boolean;

43 };

44}

45

מנחים ומנהלי מערכת

עבור מנהלי מערכת ומנחים, העבירו את הדגלים isAdmin או isModerator המתאימים באובייקט SSOUser.

התראות

כדי להפעיל או לכבות התראות, הגדירו את הערך של optedInNotifications ל-true או false בהתאמה. בפעם הראשונה שהמשתמש יטען את העמוד עם ערך זה ב-payload של ה-SSO, הגדרות ההתראות שלו יעודכנו.

בנוסף, אם ברצונכם שמשתמשים יקבלו אימיילי התראות עבור פעילות בעמודים שנרשמו אליהם (בניגוד להתראות בתוך האפליקציה בלבד), הגדירו את optedInSubscriptionNotifications ל-true.

משתמשי VIP ותוויות מיוחדות

ניתן להציג תווית מיוחדת ליד שם המשתמש באמצעות השדה האופציונלי "displayLabel".

משתמשים לא מאומתים

כדי לייצג משתמש לא מאומת, פשוט אל תאכלסו את userDataJSONBase64, verificationHash או timestamp. ספקו loginURL.

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

דוגמאות ישירות לסריאליזציה ו-hash של נתוני משתמש

פרטים נוספים כדוגמה כאן (js), כאן (java) ו-כאן (php).

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

עם Simple SSO, אנו יכולים לספק לוידג'ט ההערות מידע על המשתמש כך שהם לא יצטרכו להזין שם משתמש או דוא"ל כדי להגיב.

אנו יכולים להגדיר Simple SSO כך:

Simple SSO

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "simpleSSO": {

8 "username": "Bob",

9 "email": "bob@example.com",

10 "avatar": "https://example.com/bob.png",

11 "websiteUrl": "https://example.com/profiles/bob",

12 "displayName": "Bob's Name",

13 "displayLabel": "VIP User",

14 "loginURL": "https://example.com/login",

15 "logoutURL": "https://example.com/logout",

16 "badgeConfig": {

17 "badgeIds": [

18 "badge-id-1",

19 "badge-id-2"

20 ],

21 "pageBadgeIds": [

22 "badge-id-3"

23 ],

24 "override": false

25 }

26 }

27}];

28</script>

29

המשתמש ייכנס למערכת, ותיווצר עבורו משתמש SSO ברקע. למשתמש יוגדר createdFromSimpleSSO ל-true אם הוא נלקח מה-API.

הערות:

• דוא"ל הוא מזהה ייחודי עבור Simple SSO.
• מתן דוא"ל עם Simple SSO אינו נדרש, עם זאת כברירת מחדל ההערות שלהם יופיעו כ"לא מאומתות". אם לא נמסר דוא"ל, המשתמש לא יכול להיות מאומת במלואו.
• NEW מאז ינואר 2022: שמות משתמש אינם חייבים להיות ייחודיים בכל fastcomments.com
• Simple SSO יכול ליצור ולעדכן משתמשי SSO באופן אוטומטי, אם נמסר דוא"ל, והמשתמש לא נוצר במקור מ- Secure SSO. אם מטען Simple SSO מציין משתמש שנוצר על ידי Secure SSO או ה-API, משתמש זה נשאר ללא שינוי והמבקר מקבל משתמש נפרד.
• ניתן לציין תגיות (badges) עבור המשתמש באמצעות המאפיין badgeConfig. המערך badgeIds מכיל את המזהים של תגיות גלובליות שיש לשייך למשתמש. המערך pageBadgeIds מכיל מזהי תגיות המוגדרים לעמוד הנוכחי (urlId) — תגיות אלו מוצגות רק בעמוד שבו הוקצו. אם override מוגדר ל-true, הוא יחליף תגיות מוצגות קיימות (גלובליות ומוגדרות לעמוד מוחלפות באופן עצמאי); אם false הוא יוסיף לתגיות קיימות.

הגדרות Simple SSO

Simple SSO תמיד זמין. שני הגדרות קובעות עד כמה FastComments סומך עליו. ניתן למצוא אותן על ידי חיפוש SSO בכלל התאמה אישית. שני ההגדרות כבויות כברירת מחדל, והן חלות גם אם "Require SSO To View Comments" מופעל.

חשבונות שכבר השתמשו ב-Simple SSO כאשר נוספו הגדרות אלו, שני ההגדרות הופעלו עבורם, ולכן לא השתנה דבר עבורם.

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

אימות אוטומטי של תגובות באמצעות Simple SSO

כאשר אפשרות זו מופעלת, תגובות ממשתמשי Simple SSO מאומתות מייד.

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

הגדרה זו משפיעה רק על תגובות. הצבעות ממשתמשי Simple SSO תמיד נספרות מייד.

אפשר למנהלי Simple SSO

כאשר אפשרות זו מופעלת, משתמש Simple SSO יכול להיות מנהל או מודרטור של החשבון שלך:

• משתמש Simple SSO שיש לו הרשאות מנהל או מודרטור שומר עליהם.
• משתמש Simple SSO עם אותו דוא"ל כאחד מהמנהלים או המודרטורים שלך מקבל את ההרשאות שלהם.

כאשר אפשרות זו כבויה, Simple SSO אינו מעניק הרשאות אלו. מטען Simple SSO שמציין משתמש בעל ההרשאות הללו יוצר משתמש נפרד ללא הרשאות, והמשתמש המקורי נשאר ללא שינוי.

מטעני Simple SSO אינם חתומים, ולכן כאשר אפשרות זו מופעלת, כל מי שיודע את דוא"ל המנהל או מזהה המשתמש יכול לפעול במקומו. אם זה חשוב לאתר שלך, השאר אפשרות זו כבויה והשתמש ב- Secure SSO למנהלים שלך.

משתמשים שנוצרו על ידי Secure SSO או ה-API אינם נגישים באמצעות Simple SSO, בין אם אפשרות זו מופעלת או לא.

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

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

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

הגדרה ללא קוד

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

בעת ביצוע זאת, חפש את SSO, ותמצא את האפשרות הזו:

דרוש SSO לצפייה בהערות

הפעל זאת ושמור את כלל ההתאמה האישית.

הגנה רק על תחום או דף מסוים

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

בחלק העליון של ממשק ההתאמה האישית, נמצא שני קלטים, Domain ו-URL ID.

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

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

רמות אבטחה

כאשר דורשים SSO, תרצה להחליט אם אתה דורש Simple SSO או Secure SSO. אם אתה דורש Simple SSO, שני האפשרויות מותרות, אך אם אתה דורש Secure SSO אז התוכן חייב להישאב עם מטען Secure SSO שמחולץ עם מפתח ה-API שלך כדי שניתן יהיה לצפות בו.

אפשרות רמת האבטחה תופיע כאשר אתה בוחר "דרוש SSO לצפייה בהערות", והיא פועלת רק כאשר אפשרות זו מופעלת.

ההגדרות אימות אוטומטי של תגובות באמצעות Simple SSO והאפשרת מנהלי Simple SSO נפרדות, וחלות בין אם אפשרות זו מופעלת ובין אם לא.

הגנה מעבר לקריאה

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

בעיות נפוצות

כל משתמשים שיצרו תגובות לפני אינטגרציית ה-SSO שלך לא יוכלו לראות אותן, אלא אם הם נכנסים דרך אינטגרציית ה-SSO שלך.

בברירת מחדל, FastComments ידרוש כתובת אימייל כדי להגיב. הוא לא חייב להיות אימייל תקף, אך עד שהמשתמש ילחץ על הקישור שנשלח אליו, ההערה שלו תציג תווית "הערה לא מאומתת".

עם זאת, ניתן להסיר את דרישת האימייל. שדה הקלט של האימייל עדיין יופיע, אך הוא לא יהיה נדרש יותר.

ניתן להגדיר זאת דרך ממשק התאמה אישית של הווידג'ט:

הפעלת תגובות אנונימיות

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

FastComments ניתן להגדיר להסיר תגובות לא מאומתות לאחר מספר ימים רצוי. זה מסייע במאבק בספאם.

בברירת מחדל, הוא לא עושה זאת.

זה ניתן להגדיר, או לבטל, דרך דף הגדרות מודרציה.

הגדרות מודרציה

כאשר משתמשים מגיבים, ואם הם לא מחוברים, יתבקשו לספק את האימייל שלהם.

זה ייצור "מושב לא מאומת" עבור אותו משתמש, ונבקש מהם לאמת את המושב באמצעות אימייל.

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

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

השבתת שדות אימייל

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

שימו לב, עם תצורה זו, כל ההערות יהיו לא מאומתות אלא אם המשתמש יוצר חשבון ומתחבר ל-https://fastcomments.com.

ייתכן שתרצו לשקול השבתת תווית לא מאומתת.

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

Disable The Unverified Label

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableUnverifiedLabel": true

8}];

9</script>

10

בנוסף, ניתן להשתמש בתכונה זו, ללא כתיבת קוד, בממשק ההתאמה האישית:

Disable The Unverified Label

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

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

אפשר הצבעה אנונימית

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

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

הגדרת שם המשתמש ברירת המחדל

שיתוף שם המשתמש ברירת המחדל

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

שמות משתמש שהמבקר מקליד בעצמו עדיין חייבים להיות ייחודיים.

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

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

באתרים מסוימים, בקשת מבקר להמציא שם משתמש ייחודי היא מכשול, במיוחד במובייל. FastComments יכול ליצור שם משתמש ניטרלי לכל מבקר חדש ולמלא אותו מראש בשדה שם המשתמש, כמו BraveOtter4172.

המבקר יכול להשאיר אותו כפי שהוא, או להחליף אותו בשם לבחירתו.

ניתן להפעיל זאת מממשק ההתאמה האישית, תחת ההגדרה שנקראת Generate Usernames Automatically:

יצירת שמות משתמש אוטומטית

איך זה מתנהג

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

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

כאשר משתמש מגיב או נכנס למערכת, אנו מעדכנים את ה‑locale האחרון שבו השתמש ומשתמשים בו גם לשליחת אימיילים.

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

דרך הממשק

זה ניתן להגדיר באמצעות ממשק התאמת הווידג'ט. ראה את האפשרות "Locale / Language":

Changing The Locale / Language

דרך קוד

זה ניתן לעקוף עם locale רצוי.

Manually Defining the User's Locale

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "locale": "ru_ru"

8}];

9</script>

10

שפות נתמכות וקודי Locale

אתה יכול למצוא את הרשימה המלאה של השפות הנתמכות וקודי ה‑locale המתאימים כאן.

הערה על SSO

אם אתה משתמש ב‑SSO, ייתכן שתרצה להעביר את ה‑locale של המשתמש באובייקט המשתמש, כך שהאימיילים ודברים אחרים יתורגמו כראוי עבורו.

בברירת מחדל, FastComments אינו מגביל את השפות המשמשות לתגובה.

ייתכן ויהיה רצוי להגביל את השפות שהקהילה משתמשת בהן.

זה ניתן לקונפיגורציה ללא קוד, בעמוד התאמת הווידג'ט:

שפות מותרות

המערכת תנתח את ההערה שלהם ותזהה את שפתה, ולאחר מכן תתאים אותה לרשימת השפות המותרות.

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

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

תרגום תגובות (Comment Translation) מוסיף תרגום של התגובות עצמן, כך שקהילה שכותבת ביותר משפה אחת יכולה לקרוא כל תגובה בשפה שלה.

קיימים שני מצבים:

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

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

התכונה מופעלת עבור כל כלל התאמה אישית בנפרד, כך שניתן להחיל אותה על כל האתר, על דומיין אחד או על עמוד בודד. היא כבויה כברירת מחדל.

תרגום תגובות

התרגום הוא הגדרה בצד השרת. העברת commentTranslation בתצורת ה-JavaScript של הווידג'ט אינה מפעילה אותו; רק הכלל מפעיל.

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

השימוש מחויב כאסימוני LLM באותו תעריף כמו סוכני AI ומופיע באותו מקום בפרטי החיוב שלך.

ניתן לנעול את ההערות כך שלא יוכלו להישאר תגובות או הצבעות חדשות על‑ידי הגדרת הדגל readonly ל‑true.

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

Making The Comment Thread Readonly

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "readonly": true

8}];

9</script>

10

ניתן להתאים זאת ללא קוד, בעמוד התאמת הווידג'ט, עבור תחום שלם או דף:

Making The Comment Thread Readonly

Update!

מאז נובמבר 2022, ניתן לנעול או לשחרר שרשורים בזמן אמת על‑ידי מנהלים ומנהלים משניים דרך תפריט שלוש הנקודות מעל אזור התגובה.

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

זה תואם לשדה isClosed ב‑API של Page.

בברירת מחדל, FastComments מאפשר קישור לכל אתר חיצוני.

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

אימות זה חל רק על וידג'ט ההערות וה-API. ייבוא אינו מושפע.

זה נעשה ללא קוד, בדף התאמה אישית של הווידג'ט:

הגבל דומיינים של קישורים חיצוניים

בברירת מחדל, FastComments יבקש מהמשתמש רק את ההערה שלו, שם המשתמש שלו, ואת האימייל שלו.

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

אנו יכולים לאפשר הצגת שדה קלט נוסף כדי להוסיף את כתובת האתר של המשתמש על ידי הגדרת הדגל enableCommenterLinks ל‑true:

הפעלת קישורי מגיב

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableCommenterLinks": true

8}];

9</script>

10

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

זה ניתן להתאמה ללא קוד, בדף התאמת הווידג'ט:

הפעלת קישורי מגיב

רשימת מזהים שנוצרו מדף קבוצות פיקוח.

כאשר מצוין, תגובות שהושארו באמצעות התצורה המצוינת יכילו את אותו מערך של moderationGroupIds.

אם ל-Moderator יש אחת או יותר קבוצות פיקוח מוגדרות, הם יראו רק תגובות בדף Moderate Comments המשויכות לקבוצה(ות) שלהם.

Specify Moderation Groups

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "moderationGroupIds": [

8 "mxZAhjzdb",

9 "FT19nXbqA"

10 ]

11}];

12</script>

13

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

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

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

ניתן לבצע זאת בקוד על‑ידי הגדרת הדגל enableThirdPartyCookieBypass ל‑true:

הפעלת עקיפת קוביית צד שלישי

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableThirdPartyCookieBypass": true

8}];

9</script>

10

ניתן גם להגדיר זאת דרך ממשק התאמת הווידג'ט, תחת Enable Third-Party Cookie Popup:

הפעלת עקיפת קוביית צד שלישי

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

ניתן להגביל זאת בדרכים הבאות:

• במקום זאת, אנונימיזציה של ההערה המחוקה (הגדרת שם וטקסט ל-[deleted] או ערך מותאם).
• אל תאפשר מחיקת הערות כאשר יש תגובות. הודעת שגיאה שניתן להתאים מוצגת.
• הגבל מחיקה כאשר להערה יש תגובות רק למנהלים ולמפקחים.

ניתן להגדיר זאת דרך הסעיף Comment Thread Deletion בממשק התאמה אישית של הווידג'ט.

התאמת התנהגות מחיקה לתגובות

בברירת מחדל, FastComments יציג תגיות משתמש רק על ההערות שלהם בתוך שרשרת ההערות.

עם זאת, אנו יכולים להציג תגיות משתמש ליד שמם מעל טופס ההערה על ידי הפעלת תכונה זו בעמוד התאמת הווידג'ט:

אפשרות הצגת תגיות בסרגל העליון

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

שימו לב שהפונקציה הזו חייבת להיות מופעלת בממשק התאמת הווידג'ט כדי לעבוד. ניתן באופן אופציונלי להגדיר את הדגל showBadgesInTopBar ל‑false בתצורת הקוד שלכם כדי להשבית אותו באופן סלקטיבי גם כאשר הוא מופעל ברמת השרת:

Disable Show Badges in Top Bar

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "showBadgesInTopBar": false

8}];

9</script>

10

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

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

יש שלוש אפשרויות פריסה:

• 1 - למעלה: שורה אופקית של אווטארים חופפים המוצגים מעל ההערות.
• 2 - שמאל: סרגל צד עם שמות ונקודות מקוונות המוצגים משמאל לוידג'ט.
• 3 - ימין: אותו סרגל צד המוצג מימין לוידג'ט.

הגדר את הדגל usersListLocation כדי להפעיל את הפונקציה:

הצג רשימת משתמשים מימין

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "usersListLocation": 3

8}];

9</script>

10

בברירת מחדל, הרשימה מציגה רק משתמשים שמקוונים כרגע. כדי לכלול גם אנשים שהגיבו בעמוד בעבר (אך אינם מצפים בו כרגע), הגדר את usersListIncludeOffline ל‑true:

כלול מגיבים קודמים

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "usersListLocation": 3,

8 "usersListIncludeOffline": true

9}];

10</script>

11

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

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

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

הגדרות רשימת משתמשים

לאחר 500 משתמשים חיים, הרשימה יכולה להיות עד 30 שניות לא מעודכנת.