FastComments.com

Add Members-Only Live Commenting to ghost Sites


Dzięki FastComments możemy łatwo dodać komentowanie na żywo, dostępne tylko dla członków, do dowolnej witryny zbudowanej przy użyciu Ghost.

Będziemy mogli automatycznie zaimportować nazwy użytkowników członków, awatary oraz skonfigurować powiadomienia o odpowiedziach na komentarze.

Uwaga że ten samouczek wymaga konta FastComments. Zalecamy najpierw się zarejestrować, a następnie wrócić tutaj. Możesz utworzyć konto tutaj.

W tym samouczku skupimy się na blogu zbudowanym przy użyciu Ghost, ale przy odrobinie wiedzy te same instrukcje można zastosować do dowolnego rodzaju strony.

Ten samouczek zaczyna się z perspektywy użytkownika, który jest zupełnie nowy w Ghost. Użytkownicy doświadczeni w edycji swoich motywów mogą pominąć i przejść od razu do Step 4.

Jeśli masz problemy, możesz wysłać wyeksportowany szablon motywu do swojego przedstawiciela wsparcia (wciąż wymaga kroków 1 - 5).


Krok 1: Pobierz swój motyw Internal Link

Aby poprawnie dodać FastComments do Ghost, musimy edytować pliki motywu.

Zacznijmy więc od pobrania istniejącego lub wybranego motywu.

Przejdź do panelu administracyjnego swojej witryny i kliknij ikonę koła zębatego w lewym dolnym rogu:

Otwórz ustawienia
Otwórz ustawienia

Następnie wybierz opcję Design:

Wybierz Design
Wybierz Design

Chociaż technicznie nie zmieniamy motywu, kliknij Change Theme w lewym dolnym rogu:

Zmień motyw
Zmień motyw

W prawym górnym rogu wybierz Advanced:

Wybierz Zaawansowane
Wybierz Zaawansowane

...a następnie pobierz bieżący lub wybrany motyw:

Pobierz motyw
Pobierz motyw

Krok 2: Zainstaluj motyw lokalnie Internal Link

Teraz, gdy pobraliśmy plik zip, rozpakuj go do folderu. Pobrałem domyślny casper.zip i rozpakowałem go do Downloads\casper na systemie Windows.

Następnie upewnij się, że masz zainstalowaną wersję LTS lub nowszą NodeJS. Możesz ją pobrać tutaj: https://nodejs.org/en/download/

Po zainstalowaniu NodeJS zainstaluj edytor kodu.

Polecamy (i używamy) Webstorm, który możesz pobrać tutaj z 30-dniową wersją próbną (nie jest potrzebna karta kredytowa): https://www.jetbrains.com/webstorm/

Kolejną najlepszą darmową opcją prawdopodobnie jest Visual Studio Code: https://code.visualstudio.com/download

Gdy skonfigurujesz edytor i otworzysz folder motywu w edytorze, otwórz terminal w IDE i uruchom:

Zainstaluj motyw
Copy Copy
1
2npm install
3

Pomyślny wynik będzie wyglądać tak (możesz zignorować ostrzeżenia):

Pomyślny wynik npm install
Pomyślny wynik npm install

To skonfiguruje zależności motywu dla poleceń, które uruchomimy później. Eksport zależy również od zainstalowania zależności motywu; w przeciwnym razie ponowny import nie będzie działać prawidłowo.


Krok 3: Nazwij nowy motyw Internal Link


Teraz, gdy mamy motyw otwarty w edytorze, otwórz package.json i zmień pole name na coś innego. W naszym przypadku po prostu dodajemy -fastcomments na końcu:

Zmień nazwę motywu
Zmień nazwę motywu

Jeśli używasz IDE, plik zostanie automatycznie zapisany po wprowadzeniu tej zmiany.


Krok 4: Otwórz szablon wpisu Internal Link

Teraz otworzymy szablon używany w naszych wpisach na blogu. Nazywa się post.hbs:

Otwórz post.hbs
Otwórz post.hbs

Krok 5: Dodaj kod FastComments Internal Link


Następnie musimy określić, gdzie dodać kod widżetu FastComments.com.

Jeśli używasz domyślnego motywu casper, zobaczysz sekcję podobną do tej w linii 82:

Wyłączona sekcja komentarzy
Wyłączona sekcja komentarzy

Jeśli używasz innego motywu, nie zobaczysz tego i będziesz musiał dodać ten kod po ostatnim </section>:

Przykład sekcji
Copy Copy
1
2<section class="article-comments gh-canvas">
3</section>
4

Powinieneś mieć coś takiego gotowe:

Szablon gotowy na kod komentarzy
Szablon gotowy na kod komentarzy

Gdy będziesz gotowy, skopiuj kod widżetu FastComments.com:

Fragment kodu komentarzy FastComments.com dla Ghost
Copy Copy
1
2<script src="https://cdn.fastcomments.com/js/embed-v2.min.js"></script>
3<div id="fastcomments-widget"></div>
4<script>
5 (function () {
6 let simpleSSO = null;
7
8 {{#if access}}
9 {{#if @member}}
10 simpleSSO = {
11 id: '{{ @member.uuid }}',
12 email: '{{@member.email}}',
13 username: '{{@member.name}}',
14 avatar: '{{ @member.avatar_image }}',
15 optedInNotifications: true,
16 optedInSubscriptionNotifications: true,
17 displayLabel: '{{@member.labels}}'
18 }
19 {{/if}}
20 {{/if}}
21
22 FastCommentsUI(document.getElementById('fastcomments-widget'), {
23 tenantId: "demo",
24 urlId: window.location.pathname,
25 allowAnon: false,
26 simpleSSO: simpleSSO
27 });
28 })();
29</script>
30

...i powinno to wyglądać tak:

Dodaj kod komentarzy FastComments.com
Dodaj kod komentarzy FastComments.com

Kodowanie zakończone. Teraz trzeba tylko ponownie zaimportować nasz motyw!


Krok 6: Wyeksportuj motyw Internal Link

Teraz musimy spakować pliki motywu z powrotem do pliku zip. Aby to zrobić, użyj wbudowanych funkcji w Ghost.

Otwórz ponownie terminal swojego edytora i uruchom npm run zip.

Eksportuj motyw
Eksportuj motyw

This will package the theme into a zip file in dist/casper-fastcomments.zip (if that is what you've named the theme in Step Three).


Krok 7: Prześlij motyw do Ghost Internal Link

W panelu Ghost wgrajmy nasz motyw:

Wgraj swój motyw
Wgraj swój motyw

W moim przypadku plik ZIP znajduje się w następującej lokalizacji. Zwróć uwagę na folder dist:

Wybierz plik ZIP do wgrania
Wybierz plik ZIP do wgrania

Pamiętaj, aby aktywować właśnie wgrany motyw (Ghost powinien o to poprosić).

Sukces! Internal Link

Teraz powinniśmy mieć włączone komentowanie na żywo FastComments dla naszych członków!

Sukces!
Sukces!

Gratulacje z powodu skonfigurowania FastComments z Ghost! Jeśli napotkałeś błąd domeny (Domain Error), lub chcesz dowiedzieć się, jak dostosować obszar komentarzy, czytaj dalej!


Dostosowywanie Internal Link


FastComments został zaprojektowany tak, aby można go było dostosować do Twojej witryny.

Jeśli chcesz dodać niestandardowe style lub zmodyfikować konfigurację, Sprawdź naszą dokumentację dotyczącą dostosowywania, aby dowiedzieć się jak.