הוספת תגובות לאתר Jekyll שלך

תן לסוכן הקידוד שלך את ההקשר של FastComments שהוא צריך – וידג׳טים, תצורה, Secure SSO, ה‑REST API וה‑SDKs:

npx skills add fastcomments/skills

עובד עם Claude Code, Codex, Cursor, Copilot, Gemini, ועם כל סוכן אחר שה‑skills CLI תומך בו.

כדי לראות כל תג שפועל מקומית מול ה-demo tenant הציבורי, שכפל את המאגר והפעל:

cd example
bundle install
bundle exec jekyll serve

לכל ווידג'ט יש דף משלו תחת example/ שאותו אתה יכול להעתיק ישירות לתוך אתר Jekyll שלך.

הוסף את ה-gem לקבוצת :jekyll_plugins בקובץ Gemfile של האתר שלך:

group :jekyll_plugins do
  gem "fastcomments-jekyll"
end

ואז:

bundle install

(תואם ל-Jekyll 3.7+ ו-4.x.)

דוגמאות

{% raw %}{# ספירת תגובות. הווידג'ט מציג את התווית שלו, לדוגמה "0 תגובות" #}
{% fastcomments_comment_count %}

{# צ'אט בזמן אמת #}
{% fastcomments_live_chat %}

{# צ'אט שיתופי. כוונו אותו לאלמנט תוכן באמצעות בוחר CSS #}
<article id="post-body">
  <p>Highlight me to leave a comment.</p>
</article>
{% fastcomments_collab_chat target="#post-body" %}

{# צ'אט תמונה. כוונו אותו לאלמנט תמונה באמצעות בוחר CSS #}
<img id="hero" src="/hero.jpg" alt="Hero image">
{% fastcomments_image_chat target="#hero" %}

{# סיכום ביקורות #}
{% fastcomments_reviews_summary %}

{# פיד פעילות משתמש. דורש מזהה משתמש #}
{% fastcomments_user_activity_feed user_id="demo:demo-user" %}

{# ספירות תגובות מרובות עבור אינדקס בלוג #}
{% for post in site.posts %}
  <a href="\{{ post.url }}">\{{ post.title }}</a>
  <span class="fast-comments-count" data-fast-comments-url-id="\{{ post.url }}"></span>
{% endfor %}
{% fastcomments_comment_count_bulk %}{% endraw %}

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

1. ברירות מחדל גלובליות ב-_config.yml תחת המפתח fastcomments:.
2. הקשר העמוד, שנגזר באופן אוטומטי עבור ווידג׳טים בהיקף עמוד (ראו להלן).
3. מאפייני תגית שנכתבים על התגית עצמה.

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

תחביר מאפיינים

מאפיינים הם זוגות key=value בפורמט snake_case:

{% raw %}{% fastcomments url_id="my-stable-id" readonly=true count=20 %}{% endraw %}

• ערכים מצוטטים ("..." או '...') הם מחרוזות ליטרליות.
• true/false ללא מירכאות הופכים לערכים בוליאניים, ומספרים הופכים למספרים.
• כל דבר אחר ללא מירכאות מפוענח כמשתנה Liquid מהקשר העמוד, למשל url_id=page.slug. (Liquid אינו מרחיב {% raw %}\{{ ... }}{% endraw %} בתוך מאפייני תגית, ולכן יש להשתמש בצורה החשופה page.slug ולא ב-"{% raw %}\{{ page.slug }}{% endraw %}".)

מפתחות מאפיינים וקונפיגורציה בפורמט snake_case ממופים באופן אוטומטי למפתחות camelCase ש-FastComments מצפה להם (tenant_id → tenantId, url_id → urlId, page_title → pageTitle, has_dark_background → hasDarkBackground וכן הלאה). כל אפשרות אחרת מתוך הגדרות הווידג׳ט מועברת ישירות באותו אופן.

ערכים הנגזרים מהעמוד

עבור הווידג׳טים בהיקף עמוד (fastcomments, fastcomments_comment_count, fastcomments_live_chat, fastcomments_collab_chat, fastcomments_image_chat) הערכים הללו ממולאים באופן אוטומטי מהעמוד הנוכחי, אלא אם הגדרתם אותם בעצמכם:

• url_id ← page.url (מזהה יציב שאינו תלוי בדומיין המבקר)
• url ← site.url + page.url (רק כאשר url מוגדר ב-_config.yml)
• page_title ← page.title

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

אחסון נתונים באיחוד האירופי

לקוחות באיחוד האירופי מוסיפים region: eu, באופן גלובלי:

fastcomments:
  tenant_id: your-tenant-id
  region: eu

או לכל תגית: {% raw %}{% fastcomments region="eu" %}{% endraw %}. הווידג׳טים נטענים אז מה-CDN של האיחוד האירופי.

• תיעוד FastComments
• התאמה אישית ותצורה
• תיעוד Jekyll

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