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

Defining a Custom URL 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 "urlId": "https://example.com/page"

8}];

9</script>

10

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

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

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

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

URL ID Input in The Widget Customization Page

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

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

נקודות חשובות

1. If your page has hash parameters (like example.com#page-1) - this will become part of the URL ID, by default.
2. During migrations, for example from WordPress to Gatsby, you may have to migrate the URL ID comment values after the initial migration. For that, reach out to us.

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

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

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

Custom CSS Input Area

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

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

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

Passing Custom 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. אופטימיזציה נפוצה היא למזער (minify) את ה-CSS כדי להקטין את גודלו ברשת, אך בגישה זו תצטרכו לטפל בכך בעצמכם.
5. ה-CSS המותאם שלכם לא ייבדק כאשר אנו מבצעים שינויים.

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

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

מומלץ לשים את ה-@import בכלל התאמה. כך, אם נצטרך אי פעם לשנות את ווידג'ט התגובות, נוכל להשתמש בכלי האוטומציה שלנו כדי לאמת את ההגדרות שלכם. לדוגמה, תיצרו כלל התאמה בממשק התאמת הווידג'ט, תלחצו על Advanced, ותכניסו ב-Custom CSS:

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

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

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

External CSS File

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

לדוגמה:

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, כל הטקסט בווידג' התגובות ניתן להתאמה אישית.

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

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

Custom 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 "translations": {

8 "SUBMIT_REPLY": "Reply"

9 }

10}];

11</script>

12

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

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

Custom Text

כל ההחלפות של התרגומים כרגע חלות על כל ה-locales.

כאשר משתמש מגיב ב-FastComments בפעם הראשונה, ננסה לשלוף את תמונת הפרופיל שלו מ-http://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

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

Customizing The Default 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

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

Hiding Avatars

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

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

Disabling All Default Styles

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

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

Disabling All Default Styles

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

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

כווץ תגובות להערות ברמה העליונה

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

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

כווץ תגובות

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

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

אם ברצונך להציג את כל ההערות ברמה העליונה בשילוב עם אפשרות זו, קבע את starting page to -1.

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

Enabling WYSIWYG Editing

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 WYSIWYG

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

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

Disabling The Toolbar

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

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

Disabling The 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

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

Disable Blocking

בברירת מחדל, נעשה שימוש בתאריכים יחסיים מקומיים. לדוגמה, לצד תגובה שנכתבה לאחרונה תראה אולי "לפני 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

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

Use Both Absolute and Relative Dates

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

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

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

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

Specifying Header HTML

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

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

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

Render Links as Text

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

However, the comment widget can be hidden behind a button, for example:

Click to Show Comments

הכפתור משתמש בטקסטים מתורגמים שונים בהתאם לשאלה האם ההערות מוצגות כרגע או לא. אם ההערות מוסתרות, הוא משתמש בtranslations.SHOW_COMMENTS_BUTTON_TEXT. If the comments are shown, it uses translations.HIDE_COMMENTS_BUTTON_TEXT. התרגומים יכולים להכיל את הטקסט [count] which will be replaced by the localized 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.

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

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

Enable Click to Show Comments

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

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

Disabling Automatic HashTag Creation

כברירת מחדל, 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

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

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

Disable Profiles

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

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

Disable Profiles

בברירת מחדל, 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

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

Disable Profile Comments

בברירת מחדל, 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

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

Disable Profile Direct Messages

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

Disable Success Message

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

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

Disable Success Message

כברירת מחדל, ווידג' התגובות של 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? אינה מסומנת.

Setting The Gif Rating

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

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

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

Setting The Image Content Moderation Level

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

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

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

Enable Heart Button

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

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

Change Voting Style

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

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

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

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

Disable Comment Deleting

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

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

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

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

Disable Comment Editing

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

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

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

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

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

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

Custom Page Sizes

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

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

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

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

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

Change Name Format

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

• Capitalize (יציג Example User כ־Example User)
• Last Initial (יציג את Example User כ־Example U.)
• All Initials (יציג את Example User כ־E. U.)
• Show "Anonymous"

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

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

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

Disabling Image Uploads

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

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

Disabling Image Uploads

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

עם זאת, ניתן להפעיל זאת על ידי קביעת הדגל enableSearch ל-true:

Enabling Search

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".

Enable Search Box

ניתן להפעיל תמיכה בספוילרים על ידי הגדרת הדגל enableSpoilers ל-true:

Enabling Spoilers

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

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

Enable Spoilers

כאשר טקסט מסומן, וכפתור 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

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

Enabling Comment View Counts

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

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

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

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

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

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

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

ולכן, שם הדגל שמפעיל תכונה זו: 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

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

Show Live Comments Right Away

ברירת המחדל של 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 היא למיין את התגובות לפי כיוון המיון "הכי רלוונטי".

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

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

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

Changing The Default Sort To Oldest First

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".

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

Changing The Default Sort To Newest First

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: "העדכני ביותר"
• NF: "החדש ראשון"
• OF: "הישן ראשון"

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

Changing The 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

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

Moving The Reply Box to The Bottom

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

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

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

Limit Comment Length

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

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

Limit Comment Length

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

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

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

Enable Single-Line Comment Input

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 comments באותה דקה.

המעקב נעשה באמצעות user id, anon user id וip address (hashed).

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

Limiting Comment Volume Per User

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

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

When enabled:

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

תצורה

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

Terms of Service Options

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

כיצד זה עובד

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

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

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

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

זרימת SSO מאובטח

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

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

אין צורך לכתוב נקודות קצה API חדשות עם FastComments SSO. פשוט הצפן את המידע של המשתמש בעזרת המפתח הסודי שלך והעבר את המטען ל-comment widget.

Get Your API Secret Key

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

Comment Widget Parameters

תיעוד API ברמה גבוהה עבור ה-comment widget ניתן למצוא כאן.

נפרט כעת מה משמעות הפרמטרים הללו.

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

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

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

Secure SSO Client Code

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": 1774114163787,

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

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

13 }

14}];

15</script>

16

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

The User Object

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

Copy

1

2interface SSOUser {

3 /** דרוש. מקסימום 1k תווים. **/

4 id: string;

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

6 email: string;

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

8 username: string;

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

10 avatar?: string;

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

12 optedInNotifications?: boolean;

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

14 optedInSubscriptionNotifications?: boolean;

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

16 displayLabel?: string;

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

18 displayName?: string;

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

20 websiteUrl?: string;

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

22 groupIds?: string[];

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

24 isAdmin?: boolean;

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

26 isModerator?: boolean;

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

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, מעדכן את תכונות התצוגה של תגיות מתוך קונפיגורציית ה-tenant. **/

42 update?: boolean;

43 };

44}

45

Moderators and Administrators

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

Notifications

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

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

VIP Users & Special Labels

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

Unauthenticated users

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

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

Direct Examples for Serializing and Hashing User Data

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

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

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

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

התקנה ללא קוד

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

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

Require SSO To View Comments

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

הגנה רק על דומיין או עמוד מסוים

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

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

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

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

רמות אבטחה

כשאתם דורשים SSO, תצטרכו להחליט אם אתם דורשים Simple SSO או Secure SSO. אם אתם דורשים Simple SSO, שניהם מותרות, אבל אם אתם דורשים Secure SSO, התוכן חייב להיות נשלף עם Secure SSO payload שמוחשב (hashed) עם מפתח ה-API שלכם כדי שיוצג.

אופציית רמת האבטחה תופיע כאשר תבחרו "Require SSO To View Comments".

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

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

דברים שכדאי לדעת

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

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

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

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

Enabling Anonymous Comments

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

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

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

Moderation Settings

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

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

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

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

Disable Email Inputs

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

שים לב שלתצורה זו, כל התגובות יהיו לא מאומתות אלא אם המשתמש ייצור חשבון וייכנס ל- 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

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

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

Allow Anonymous Votes

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

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

Setting The Default Username

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

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

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

Via The UI

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

Changing The Locale / Language

Via Code

ניתן לעקוף זאת ולהגדיר 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

Supported Languages and Locale Codes

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

SSO Note

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

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

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

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

Allowed Languages

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

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

ניתן לנעול את יכולת ההערה כך שלא ניתן יהיה להשאיר תגובות או הצבעות חדשות על-ידי הגדרת הדגל 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

עדכון!

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

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

זה מקביל לשדה isClosed ב-API של Page.

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

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

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

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

Restrict External Link Domains

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

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

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

Enabling Commenter Links

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

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

Enabling Commenter Links

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

כאשר מצוין, תגובות שהושארו באמצעות התצורה המצוינת יכילו את אותו מערך של 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:

Enabling Third-Party Cookie Bypass

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:

Enabling Third-Party Cookie Bypass

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

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

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

ניתן להגדיר זאת דרך הסעיף Comment Thread Deletion ב-Widget Customization UI.

Customize Delete Behavior for Replies

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

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

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

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

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

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

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