FastComments.com

Dodajte komentare na svoju Eleventy (11ty) stranicu

Ovo je službena Eleventy (11ty) knjižnica za FastComments.

Ugradite widgete za komentiranje u stvarnom vremenu, chat i recenzije na svoju Eleventy (11ty) stranicu.

Repozitorij

Pogledajte na GitHubu


Prikaz uživo Internal Link

Da biste vidjeli svaki shortcode i flow koji se izvode lokalno protiv javnog demo tenant, klonirajte repozitorij i pokrenite:

cd example
npm install
npm start

Svaka komponenta ima svoju stranicu pod example/src/pages/ koju možete kopirati izravno u vlastiti Eleventy site.

Instalacija Internal Link

npm

npm install fastcomments-11ty

Brzi početak Internal Link

Registrirajte dodatak u svojoj Eleventy konfiguraciji (.eleventy.js ili eleventy.config.js):

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

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

Ili s ESM:

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

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

Zatim upotrijebite shortcode-ove u svojim predlošcima. U Nunjucks (.njk):

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

U Liquid (.liquid):

{% fastcomments tenantId: "demo" %}

Zamijenite "demo" svojim FastComments tenant ID-jem.

Shortcodeovi Internal Link


Kratki kodOpis
fastcommentsWidget za komentare s odgovorima, glasovanjem i ostalim značajkama
fastcommentsCommentCountPrikazuje broj komentara za stranicu
fastcommentsImageChatKomentari za označavanje slika
fastcommentsLiveChatWidget za razgovor uživo
fastcommentsCollabChatSurađivačko inline komentiranje
fastcommentsRecentCommentsNedavni komentari na cijelom web-mjestu
fastcommentsRecentDiscussionsNedavno aktivne niti rasprave
fastcommentsReviewsSummarySažetak recenzija s ocjenama u zvjezdicama
fastcommentsTopPagesNajviše raspravljane stranice
fastcommentsUserActivityFeedFeed aktivnosti korisnika

Primjeri

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

{# Razgovor uživo #}
{% fastcommentsLiveChat { tenantId: "demo" } %}

{# Surađivački chat — ciljate 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" } %}

{# Chat za slike — ciljanje elementa 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" } %}

Opcije dodatka Internal Link

eleventyConfig.addPlugin(fastcommentsPlugin, {
    // Registriraj samo podskup shortcode-ova:
    shortcodes: ['fastcomments', 'fastcommentsCommentCount'],
    // Dodaj prefiks svakom registriranom imenu shortcode-a (npr. "fc" -> "fcFastcomments"):
    prefix: 'fc'
});

Ručno korištenje (bez dodatka) Internal Link

Svaki shortcode je također izvezen kao samostalna funkcija koja vraća HTML string:

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

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

Primjer projekta Internal Link

U direktoriju example/ nalazi se funkcionalni demo:

cd example && npm install && npm start


Status održavanja Internal Link

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


Trebate pomoć?

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

Doprinosi

Doprinosi su dobrodošli! Posjetite GitHub repozitorij za smjernice o doprinosu.