Add Comments To a Website

התקנה

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

וורדפרס

אתה יכול למצוא את תוסף ה-WordPress שלנו כאן.

מדריך התקנה מלא ותיעוד על התוסף נמצאים כאן.

תוסף זה תומך בתגובות בזמן אמת, SSO והתקנה ללא קוד.

ונילה JS / קטע HTML

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

פשוט הוסף את קטע הקוד הבא לכל דף:

קטע קוד פשוט

Copy

Run

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    "tenantId": "demo"
}];
</script>

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

תיעוד על הגדרת הווידג'ט נמצא כאן.

אנגולר

אתה יכול למצוא את ספריית ה-Angular שלנו ב-NPM כאן.

ווידג'ט התגובות של FastComments ל-Angular תומך בכל אותן התכונות של גרסת VanillaJS - תגובות בזמן אמת, SSO, ועוד.

תצטרך את fastcomments-typescript, שהיא peer dependency. אנא ודא שהיא כלולה בקומפילציית ה-TypeScript שלך. בעתיד, peer dependency זו תועבר ל-@types/fastcomments שיפשט את ההתקנה.

FastComments Angular דרך NPM

Copy

  npm install fastcomments-typescript --save
  npm install ngx-fastcomments --save

יש להוסיף את ה-peer dependency בקובץ tsconfig.json שלך, לדוגמה:

הוספת fastcomments-typescript peer dependency

Copy

"include": [
  "src/**/*.ts",
  "node_modules/fastcomments-typescript/src/index.ts"
],

לאחר מכן, הוסף את FastCommentsModule לאפליקציה שלך:

הוסף את המודול לאפליקציה שלך

Copy

import { BrowserModule } from '@angular/platform-browser';
import { NgModule } from '@angular/core';
import { AppComponent } from './app.component';
import { FastCommentsModule } from 'ngx-fastcomments';
@NgModule({
  declarations: [
    AppComponent
  ],
  imports: [
    BrowserModule,
    FastCommentsModule
  ],
  providers: [],
  bootstrap: [AppComponent]
})
export class AppModule { }

שימוש

כדי להתחיל, אנו מעבירים אובייקט הגדרות עבור הדייר הדמו:

שימוש - הגדרה Inline

Copy

<lib-fastcomments [config]="{ tenantId: 'demo' }"></lib-fastcomments>

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

שימוש - העברת אובייקט להגדרות

Copy

<lib-fastcomments [config]="fastcommentsConfig"></lib-fastcomments>

שימוש - EU

Copy

<lib-fastcomments [config]="{ tenantId: 'demo', region: 'eu' }"></lib-fastcomments>

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

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

ריאקט

אתה יכול למצוא את ספריית ה-React שלנו ב-NPM כאן.

ווידג'ט התגובות של FastComments ל-React תומך בכל אותן התכונות של גרסת VanillaJS - תגובות בזמן אמת, SSO, ועוד.

FastComments React דרך NPM

Copy

npm install --save fastcomments-react

FastComments React דרך Yarn

Copy

yarn add fastcomments-react

דוגמת React

Copy

import React, { Component } from 'react'
import {FastCommentsCommentWidget} from 'fastcomments-react'
class Example extends Component {
  render() {
    return <FastCommentsCommentWidget tenantId="demo" />
  }
}

אם אתה באיחוד האירופי, תרצה להגדיר את הפרמטר region כך:

דוגמת React - EU

Copy

    <FastCommentsCommentWidget tenantId="demo" region="eu" />

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

ריאקט נייטיב

אתה יכול למצוא את ספריית ה-React Native שלנו ב-NPM כאן.

ווידג'ט התגובות של FastComments ל-React Native תומך בכל אותן התכונות של גרסת VanillaJS - תגובות בזמן אמת, SSO, ועוד.

FastComments React Native דרך NPM

Copy

npm install --save fastcomments-react-native

FastComments React Native דרך Yarn

Copy

yarn add fastcomments-react-native

ההגדרות מוגדרות בצורה קצת שונה בהשוואה לספריית fastcomments-react:

דוגמת React Native

Copy

import { FastCommentsCommentWidget } from 'fastcomments-react-native';
// ...
  const tenantId = 'demo'; // ה-tenant id שלך. ניתן לקבל מ-https://fastcomments.com/auth/my-account/api-secret
  const pageId = 'native-test'; // ה-ID או URL של שרשור התגובות באפליקציה שלך.
  const config = {
    tenantId: tenantId,
    urlId: pageId
  };
  return (
      <FastCommentsCommentWidget config={config}/>
  );

אם אתה באיחוד האירופי, תרצה להגדיר את הפרמטר region:

React Native - EU

Copy

  // ...
  const config = {
    tenantId: tenantId,
    urlId: pageId,
    region: 'eu'
  };
  // ...

אתה יכול למצוא את ההגדרות שהקומפוננטה של React Native תומכת בהן כאן.

ויו

אתה יכול למצוא את ספריית ה-Vue שלנו ב-NPM כאן.

בנוסף, ספריית vue-next נמצאת ב-NPM כאן

קוד המקור ניתן למצוא ב-GitHub.

ווידג'ט התגובות של FastComments ל-Vue תומך בכל אותן התכונות של גרסת VanillaJS - תגובות בזמן אמת, SSO, ועוד.

ההוראות להלן הן עבור Vue 3 מכיוון שהוא יצא כבר זמן מה, עם זאת FastComments תומך גם ב-Vue 2 דרך ספריית fastcomments-vue.

FastComments Vue דרך NPM

Copy

npm install --save fastcomments-vue-next

FastComments Vue דרך Yarn

Copy

yarn add fastcomments-vue-next

דוגמת Vue

Copy

<template>
  <img alt="Vue logo" src="./assets/logo.png">
    <fast-comments v-bind:config="{tenantId: 'demo'}"/>
</template>
<script>
import {FastComments} from 'fastcomments-vue-next';
export default {
  name: 'App',
  components: {
    FastComments
  }
}
</script>

אם אתה באיחוד האירופי, תרצה להגדיר את region ל-EU:

FastComments Vue - EU

Copy

<fast-comments v-bind:config="{tenantId: 'demo', region: 'eu'}"/>

ספריות fastcomments-vue ו-fastcomments-vue-next תומכות באותן הגדרות כמו ווידג'ט התגובות של VanillaJS.

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

טייפסקריפט

הגדרות TypeScript עבור FastComments ניתן למצוא ב-NPM כאן.

אתה יכול למצוא אותן ב-GitHub כאן.

מופעים מרובים באותו עמוד

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

מקרי שימוש נפוצים

הצגת תגובות בזמן אמת מיד

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

אפשר תגובות אנונימיות

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

ניפוי בעיות נפוצות

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

הודעה "This is a demo"

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

שגיאה "FastComments cannot load on this domain"

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

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

תגובות שהועתקו לא מוצגות בהתקנות מותאמות

בדרך כלל זה קורה כאשר ההערות המיוצאות קשורות ל-Page ID, ואתה מעביר כתובת URL (או אין ערך, במקרה זה היא מייצרת כברירת מחדל את ה-URL של הדף).

תוכל לאבחן זאת על ידי ייצוא ההערות שלך וצפייה בעמודת URL ID (כעת עמודה B).

ודא שהערכים שאתה רואה בעמודת URL ID הם אותם הערכים שאתה מעביר לקונפיגורציית הווידג'ט כפרמטר urlId.

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

אם כל השאר נכשל, פנו אלינו.

הווידג'ט של ההערות לא מוצג

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

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

התצורה הרצויה לא פועלת כמצופה

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

חסרות תגובות באותו URL עם Hash Bang שונה

ברירת המחדל, FastComments ישתמש ב-URL של הדף כ"פתיחה" (bucket) לאחסון התגובות. אם ה-URLים שלך כוללים #hashbangs, ואלה לא אמורים להיות חלק מהמזהה שמזהה את שרשור התגובות, נוכל פשוט להתעלם מערך ה-hash bang, לדוגמה:

התעלמות מ־Hash Bangs — דוגמה

Copy

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    target: '#fastcomments-widget',
    tenantId: "demo",
    url: location.href.replace(location.hash, ''),
    urlId: location.href.replace(location.hash, '')
}];
</script>

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

פרמטרי שאילתה ב-URL שמשפיעים על הווידג'ט

ברירת המחדל, FastComments ישתמש ב-URL של הדף כ"פתיחה" (bucket) לאחסון התגובות. אם ה-URLים שלך כוללים פרמטרי שאילתה שאינם אמורים להיות חלק מהמזהה שמזהה את שרשור התגובות, נוכל פשוט להתעלם מהם, לדוגמה:

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

Copy

<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.fcConfigs = [{
    target: '#fastcomments-widget',
    tenantId: "demo",
    url: location.protocol + '//' + location.host + location.pathname,
    urlId: location.pathname
}];
</script>

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

לא מקבלים אימיילים

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

אם פניתם אלינו אנו בדרך כלל יכולים לספק תובנות נוספות מדוע ייתכן שאינכם רואים אימיילים מאיתנו.

Notion ו-Google Sites

רוצה להוסיף תגובות לדפי ה-Notion שלך? אנחנו כאן בשבילך.

Notion

להוספת תגובות למסמכי Notion, צפה בסרטון ההסבר כאן.

Google Sites

Google Sites נתמך גם כן, והתהליך דומה.

המדריך הבא

תוספי צד שלישי

התקנות מותאמות אישית

הטמעה במסמכים

Add Comments To a Website

התקנה

וורדפרס

ונילה JS / קטע HTML

אנגולר

שימוש

ריאקט

ריאקט נייטיב

ויו

טייפסקריפט

מופעים מרובים באותו עמוד

מקרי שימוש נפוצים

הצגת תגובות בזמן אמת מיד

אפשר תגובות אנונימיות

ניפוי בעיות נפוצות

הודעה "This is a demo"

שגיאה "FastComments cannot load on this domain"

תגובות שהועתקו לא מוצגות בהתקנות מותאמות

הווידג'ט של ההערות לא מוצג

התצורה הרצויה לא פועלת כמצופה

חסרות תגובות באותו URL עם Hash Bang שונה

פרמטרי שאילתה ב-URL שמשפיעים על הווידג'ט

לא מקבלים אימיילים

Notion ו-Google Sites

Notion

Google Sites

שפה 🇮🇱 עברית

תוספי צד שלישי

התקנות מותאמות אישית

הטמעה במסמכים

Add Comments To a Website

התקנה

וורדפרס

ונילה JS / קטע HTML

אנגולר

שימוש

ריאקט

ריאקט נייטיב

ויו

טייפסקריפט

מופעים מרובים באותו עמוד

מקרי שימוש נפוצים

הצגת תגובות בזמן אמת מיד

אפשר תגובות אנונימיות

ניפוי בעיות נפוצות

הודעה "This is a demo"

שגיאה "FastComments cannot load on this domain"

תגובות שהועתקו לא מוצגות בהתקנות מותאמות

הווידג'ט של ההערות לא מוצג

התצורה הרצויה לא פועלת כמצופה

חסרות תגובות באותו URL עם Hash Bang שונה

פרמטרי שאילתה ב-URL שמשפיעים על הווידג'ט

לא מקבלים אימיילים

Notion ו-Google Sites

Notion

Google Sites