Додајте коментаре на ваш Jekyll сајт

Да бисте видели сваки таг који се покреће локално против јавног demo закупца, клонирајте репозиторијум и покрените:

cd example
bundle install
bundle exec jekyll serve

Сваки видгет има своју страницу под example/ коју можете директно копирати у свој Jekyll сајт.

Додајте гем у групу :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 %}

{# Фид активности корисника. Захтева user id #}
{% 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 %}

Config потиче из три места. Накнадни извори имају предност:

1. Глобалне подразумеване вредности у _config.yml под кључем fastcomments:.
2. Контекст странице, аутоматски изведен за виџете везане за страницу (погледајте у наставку).
3. Атрибути тега написани директно на самом тагу.

Дакле, url_id на тагу има предност над вредношћу изведеном са странице, која има предност над било којом глобалном подразумеваном вредношћу.

Attribute syntax

Атрибути су парови 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, итд.). Било која друга опција из widget configuration пролази на исти начин.

Page-derived values

За виџете везане за страницу (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

Виджети који покривају цео сајт (скори коментари/дискусије, најпопуларније странице, сажетак рецензија, фид активности корисника, bulk count) нису везани за страницу и не изводе ове вредности.

EU data residency

Корисници у ЕУ додају region: eu, или глобално:

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

или по тагу: {% raw %}{% fastcomments region="eu" %}{% endraw %}. Виџети затим учитавају са ЕУ CDN-а.

• FastComments Документација
• Прилагођавање & Конфигурација
• Jekyll Документација

Ове компоненте су омотачи око наших основних VanillaJS компонената. Можемо аутоматски ажурирати те компоненте (поправити грешке, додати функције) без објављивања ове библиотеке, тако да иако можда неће бити објављена неко вријеме, то не значи да FastComments није у активном развоју! Слободно погледајте наш блог за ажурирања. Промјене API-ја које крше уназадну компатибилност или нове функције никада неће бити прослијеђене у основну библиотеку без повећања верзије ове библиотеке.