Od dłuższego czasu nosiłem się z zamiarem dodania możliwości komentowania pod moimi wpisami. Prowadzę aktywnie w tym momencie dwie strony; tę oraz KotlinTesting. W tym wpisie opowiem co nieco o systemach komentarzach i o tym jak użyć gi

  1. Po co dawać komentarze na blogu?
  2. Jakie są dostępne opcje?
  3. Czemu właśnie giscus?
  4. Jak wygląda integracja?
  5. Co dalej?

Po co dawać komentarze na blogu?

Po prostu można zadać pytanie dotyczące wpisu, a odpowiedź będzie widoczna dla wszystkich. Tylko tyle i aż tyle.

Czytelnik może się dopytać o coś, jeśli treść wpisu nie jest dla niego całkowicie zrozumiała. Może się też z czymś nie zgodzić, co stworzy pretekst do dyskusji.

Twórcom daje to feedback – po pierwsze, informację o tym, że dany wpis jest czytany, a po drugie czy jest zrozumiały.

Odbiorcy mają ułatwioną ścieżkę dotarcia do autorów – w przypadku jakichkolwiek uwag jest to prostsze rozwiązanie niż szukanie na całej stronie adresu kontaktowego i wysłanie maila.

Jakie są dostępne opcje?

Mamy wiele opcji na umieszczenie systemu komentarzy na swojej stronie / blogu. Oto kilka z nich, które rozważałem.

Komentarze wbudowane w WordPressa

Bardzo nie chciałem korzystać z tego rozwiazania. Wystarczająco się naczytałem o atakach SQL injection na WordPressa właśnie poprzez komentarze. Stanowcze nie. Prawodpodobnie istnieje jakaś wtyczka wordpressowa, która ogarnia temat security, niemniej nie chciałem robić dokładnego researchu.

Z komentarzy wordpressowych nie skorzystałbym w innych CMSach. Odpada.

Disqus

Najpopularniejszy „comments as a service”. Ma jednak kilka minusów.

  • komentujący muszą zakładać konto na Disqus
  • w wersji bezpłatnej pozostaje branding Disqusa i reklamy

Co ciekawe – w Ghost CMS (na którym rozwijam KotlinTesting) jest proponowany jako „domyślne” rozwiązanie.

Komentarze Facebookowe

Facebook dostarcza rozwiazanie dla komentarzy. Sporo osób ma już konto na Facebooku, zatem odpada kwestia zakładania dodatkowego konta przez użytkowników. No ale pojawia się pytanie – czy na pewno chcę korzystać tak bardzo z ekosystemu Meta?

giscus

Oto narzędzie do integracji komentarzy za pomocą Githuba. Rozwiązanie „pomiędzy”. Czytelnicy KotlinTesting i DevSpeaker to specjaliści z branży IT, a Github jest wiodącą platformą do hostingu kodu i współpracy nad open source. Właśnie na ten system się zdecydowałem.

Czemu właśnie giscus?

Giscus spina się z systemem „Discussions” na Githubie. Każdy, kto ma konto na tym portalu (a przypuszczam, że większość programistów ma, nawet jeśli nie wrzuca swojego kodziku publicznie), może coś od siebie dodać po konkretnym postem.

  • odbiorcy moich treści mają już konto na Githubie
  • integracja po stronie CMS (Ghost na KotlinTesting i WordPress na DevSpeaker) to dorzucenie jednego skryptu

Jak wygląda integracja?

Podążając za instrukcjami na stronie giscusa:

Stworzyłem nowe, puste repozytoria odpowiednie DevSpeaker i KotlinTesting:

Dodałem aplikację giscus do swojego konta i przydzieliłem jej uprawnienia do tych projektów:

Zaznaczyłem ptaszka „Discussions” w konfiguracji repozytorów:

Umieściłem skrypt ładujący iframe w szablonie blogposta:

I tyle. Komentarze działają na obu stronach. Są teraz widoczne zarówno pod konkretnymi wpisami jak i w dyskusjach na Githubie.

Co dalej?

Dodanie komentarzy na obie stronki zajęło mi poniżej godziny. Dobry wynik. Narzędzia „as a service” i „low-code / no-code” to istne zbawienie.

Teraz pozostaje tylko czekać na efekty. KotlinTesting ma sporo organicznego ruchu – liczę na to, że pierwsze komentarze się pojawią w najbliższym czasie. Tymczasem jeśli czytasz ten wpis, to możesz zostawić komentarz lub po prostu kliknąć wybraną reakcję!