FastComments.com

Add Comments to Your Next.js App

To jest oficjalna biblioteka Next.js dla FastComments.

Osadź funkcje komentarzy na żywo, czat oraz widżety recenzji w swojej aplikacji Next.js.

Repozytorium

Zobacz na GitHub


Prezentacja na żywo Internal Link


Aby zobaczyć wszystkie komponenty i przepływy działające lokalnie wobec publicznego najemcy demo, sklonuj repozytorium i uruchom:

cd example
npm install
npm run dev

Każdy komponent ma własną trasę w example/app/, którą możesz skopiować bezpośrednio do swojej aplikacji Next.js.

Instalacja Internal Link

npm install fastcomments-nextjs

Szybki start Internal Link

// app/page.tsx
import { FastComments } from 'fastcomments-nextjs';

export default function Page() {
    return <FastComments tenantId="demo" />;
}

Zastąp "demo" identyfikatorem swojej instancji (tenant) FastComments. Komponent już deklaruje 'use client', więc możesz renderować go z komponentu serwerowego.

Komponenty Internal Link

Component Description
FastComments Widżet komentarzy z odpowiedziami, głosowaniem i innymi funkcjami
FastCommentsCommentCount Wyświetla liczbę komentarzy na stronie
FastCommentsImageChat Komentarze adnotujące obrazy
FastCommentsLiveChat Widżet czatu na żywo
FastCommentsCollabChat Wspólne komentowanie inline
FastCommentsReviewsSummary Podsumowanie recenzji z ocenami gwiazdkowymi
FastCommentsUserActivityFeed Kanał aktywności użytkownika

Wszystkie komponenty są eksportowane z głównego punktu wejścia pakietu:

import {
    FastComments,
    FastCommentsLiveChat,
    FastCommentsReviewsSummary,
} from 'fastcomments-nextjs';

Wdrażanie na Vercel Internal Link

Jeśli zainstalowano FastComments przez integrację Vercel Marketplace, identyfikator najemcy jest dostępny jako zmienna środowiskowa FASTCOMMENTS_TENANT_ID. Aby odczytać go po stronie klienta, udostępnij go przez next.config.js lub poprzedź go prefiksem NEXT_PUBLIC_:

<FastComments tenantId={process.env.NEXT_PUBLIC_FASTCOMMENTS_TENANT_ID!} />

Przykładowy projekt Internal Link

Działające demo znajduje się w katalogu example/:

cd example && npm install && npm run dev


Status konserwacji Internal Link

Te komponenty są wrapperami naszych podstawowych komponentów VanillaJS. Możemy automatycznie aktualizować te komponenty (naprawiać błędy, dodawać funkcje) bez publikowania tej biblioteki, więc choć może nie być ona publikowana przez jakiś czas, nie oznacza to, że FastComments nie jest aktywnie rozwijany! Zajrzyj śmiało na nasz blog po aktualizacje. Istotne zmiany API lub funkcje nigdy nie zostaną wprowadzone do leżącej u podstaw biblioteki core bez zwiększenia wersji w tej bibliotece.

Potrzebujesz pomocy?

Jeśli napotkasz jakiekolwiek problemy lub masz pytania dotyczące biblioteki Next.js, prosimy:

Wkład

Wkład mile widziany! Odwiedź repozytorium GitHub po wytyczne dotyczące kontrybucji.