FastComments.com

Додајте коментаре на ваш Eleventy (11ty) сајт


Ово је званична Eleventy (11ty) библиотека за FastComments.

Уграђујте видгете за коментаре уживо, чет и рецензије на вашем Eleventy (11ty) сајту.

Репозиторијум

Погледајте на GitHub


Уживо приказ Internal Link

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

cd example
npm install
npm start

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

Инсталација Internal Link


npm

npm install fastcomments-11ty

Брзи почетак Internal Link

Registrujte plugin u vašoj Eleventy konfiguraciji (.eleventy.js ili eleventy.config.js):

const { fastcommentsPlugin } = require('fastcomments-11ty');

module.exports = function(eleventyConfig) {
    eleventyConfig.addPlugin(fastcommentsPlugin);
};

Ili koristeći ESM:

import { fastcommentsPlugin } from 'fastcomments-11ty';

export default function(eleventyConfig) {
    eleventyConfig.addPlugin(fastcommentsPlugin);
}

Zatim koristite shortcodes u vašim predlošcima. U Nunjucks (.njk):

{% fastcomments { tenantId: "demo" } %}

U Liquid (.liquid):

{% fastcomments tenantId: "demo" %}

Zamijenite "demo" sa vašim FastComments tenant ID.

Шорткодови Internal Link

ShortcodeOpis
fastcommentsWidget za komentare sa odgovorima, glasovanjem i još mnogo toga
fastcommentsCommentCountPrikazuje broj komentara za stranicu
fastcommentsImageChatKomentari za anotiranje slika
fastcommentsLiveChatWidget za live chat
fastcommentsCollabChatKolaborativno inline komentarisanje
fastcommentsRecentCommentsNedavni komentari na sajtu
fastcommentsRecentDiscussionsNedavno aktivne teme diskusija
fastcommentsReviewsSummarySažetak recenzija sa ocjenama u zvjezdicama
fastcommentsTopPagesNajdiskutovanije stranice
fastcommentsUserActivityFeedFeed aktivnosti korisnika

Primjeri

{# Broj komentara u tekstu #}
This page has {% fastcommentsCommentCount { tenantId: "demo" } %} comments.

{# Live chat #}
{% fastcommentsLiveChat { tenantId: "demo" } %}

{# Collab chat — ciljajte element sadržaja pomoću CSS selektora #}
<article id="post-body">
  <p>Highlight me to leave a comment.</p>
</article>
{% fastcommentsCollabChat { tenantId: "demo", target: "#post-body" } %}

{# Image chat — ciljajte element slike pomoću CSS selektora #}
<img id="hero" src="/hero.jpg" alt="Hero image" />
{% fastcommentsImageChat { tenantId: "demo", target: "#hero" } %}

{# Sažetak recenzija #}
{% fastcommentsReviewsSummary { tenantId: "demo" } %}

{# Feed aktivnosti korisnika #}
{% fastcommentsUserActivityFeed { tenantId: "demo", userId: "demo:demo-user" } %}

Опције плагина Internal Link

eleventyConfig.addPlugin(fastcommentsPlugin, {
    // Региструј само подскуп shortcodes-а:
    shortcodes: ['fastcomments', 'fastcommentsCommentCount'],
    // Додај префикс сваком регистрованом имену shortcode-а (нпр. "fc" -> "fcFastcomments"):
    prefix: 'fc'
});

Ручна употреба (без плагина) Internal Link

Сваки shortcode је такође извезен као самостална функција која враћа HTML низ:

const { fastcomments, commentCount } = require('fastcomments-11ty');

eleventyConfig.addShortcode('comments', fastcomments);
eleventyConfig.addShortcode('commentCount', commentCount);

Пример пројекта Internal Link

Радна демонстрација је укључена у директоријум example/:

cd example && npm install && npm start


Статус одржавања Internal Link

Ove komponente su omotači oko naših osnovnih VanillaJS komponenti. Možemo automatski ažurirati ove komponente (ispraviti greške, dodati funkcionalnosti) bez objavljivanja ove biblioteke, pa iako možda neće biti objavljena neko vrijeme, to ne znači da FastComments nije pod aktivnim razvojem! Slobodno provjerite naš blog za ažuriranja. Promjene API-ja koje remete kompatibilnost ili nove funkcije nikada neće biti isporučene u osnovnu biblioteku bez povećanja verzije u ovoj biblioteci.

Trebate pomoć?

Ako naiđete na bilo kakve probleme ili imate pitanja u vezi Eleventy (11ty) biblioteke, molimo:

Doprinos

Doprinosi su dobrodošli! Molimo posjetite GitHub repozitorijum za smjernice o doprinosu.