התאמות והגדרות

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

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

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

טקסט מותאם

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

כאשר משתמש מגיב עם 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

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

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

By default FastComments does not allow iframes in comments. When you enable media embeds, commenters can paste the embed code (the <iframe> snippet) from trusted providers like YouTube, Vimeo, SoundCloud, and Spotify, and it will render inline in the comment.

For security, this is not a client-side widget config flag. It is a server-side setting, validated when each comment is saved, so it cannot be turned on from the page. Only iframes pointing at a built-in list of trusted providers are allowed. Any other iframe is removed.

This is done without code, on the widget customization page:

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

Adding Your Own Providers

If you want to allow embeds from a provider that is not on the built-in trusted list, add its hostname in the "תחומי הטמעה נוספים" field on the same page. These hostnames are allowed in addition to the built-in providers. Matching is exact, so include the full hostname (for example, player.example.com). Anything you do not list stays blocked.

Both the plain comment box and the WYSIWYG editor support pasting an embed. In the WYSIWYG editor the embed is inserted as a removable block.

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

עם זאת, ניתן להפעיל זאת על ידי הגדרת הדגל 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:

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

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

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

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

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

13 "loginCallback": null,

14 "logoutCallback": null

15 }

16}];

17</script>

18

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

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 מוגדר, על ידי יצירת כלל התאמה אישית.

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

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

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

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

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

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

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

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

רמות אבטחה

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

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

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

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

בעיות נפוצות

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

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

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

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

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

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

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

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

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

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

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

שפות מותרות

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

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

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