Installation | FastComments Docs

התקנה

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"

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

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

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

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

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

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

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

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

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

אם כל השאר נכשל, צור איתנו קשר.

ווידג'ט התגובות לא מוצג

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

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

הגדרות רצויות לא עובדות כצפוי

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

תגובות חסרות באותו URL עם hash bang שונה

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

דוגמה להתעלמות מ-hash bangs

Copy

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

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

פרמטרים של URL query משפיעים על הווידג'ט

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

התעלמות מפרמטרי query

Copy

<script src="https://cdn.fastcomments.com/js/embed-v2.min.js"></script>
<div id="fastcomments-widget"></div>
<script>
window.FastCommentsUI(document.getElementById('fastcomments-widget'), {
    tenantId: "demo",
    url: location.protocol + '//' + location.host + location.pathname,
    urlId: location.pathname
});
</script>

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

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

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

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

נושן וגוגל סייטס

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

Notion

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

Google Sites

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

המדריך הבא

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

התקנות מותאמות

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

התקנה

וורדפרס

ונילה JS / קוד HTML

אנגולר

שימוש

ריאקט

ריאקט נייטיב

וויו

טייפסקריפט

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

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

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

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

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

הודעת "This is a demo"

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

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

ווידג'ט התגובות לא מוצג

הגדרות רצויות לא עובדות כצפוי

תגובות חסרות באותו URL עם hash bang שונה

פרמטרים של URL query משפיעים על הווידג'ט

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

נושן וגוגל סייטס

Notion

Google Sites

שפה 🇮🇱 עברית

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

התקנות מותאמות

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

התקנה

וורדפרס

ונילה JS / קוד HTML

אנגולר

שימוש

ריאקט

ריאקט נייטיב

וויו

טייפסקריפט

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

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

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

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

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

הודעת "This is a demo"

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

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

ווידג'ט התגובות לא מוצג

הגדרות רצויות לא עובדות כצפוי

תגובות חסרות באותו URL עם hash bang שונה

פרמטרים של URL query משפיעים על הווידג'ט

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

נושן וגוגל סייטס

Notion

Google Sites