FastComments.com


FastComments obsługuje wiele typów reakcji przypisanych do strony. Obsługujemy to, co nazywamy "Page Reacts" (zademonstrowane na dole tej strony) — są to konfigurowalne emotikony lub ikony, które mogą wyświetlać się nad obszarem komentarzy.

Mamy także widżet Floating Likes, który pojawia się w prawym dolnym rogu ekranu. Niniejsza dokumentacja obejmuje oba.


Reakcje strony Internal Link


Widżet Page Reacts wyświetla konfigurowalny zestaw ikon reakcji na widżecie komentarzy.

Użytkownicy mogą kliknąć obrazy, aby zareagować, a widżet zapamiętuje reakcje, które wybrali dla każdej strony. Jeśli są zalogowani na fastcomments.com, reakcje są powiązane z ich kontem.

Jeśli klikniesz Run w poniższym przykładzie, zobaczysz to w działaniu.


Instalacja - VanillaJS Internal Link

Dla Page Reacts musimy zdecydować o dwóch rzeczach:

  • Jakie obrazy reakcji zastosować.
  • Krótki id do nazwania każdej reakcji.

Opcjonalnie:

  • Możesz również określić opcjonalne osobne obrazy dla zaznaczonych/niezaznaczonych reakcji.
  • Możesz zdecydować, czy chcesz pokazywać listę użytkowników, którzy zareagowali, gdy najedziesz myszką na jedną z reakcji.
Przykład kodu Page Reacts
Copy CopyRun External Link
1
2<script src="https://cdn.fastcomments.com/js/embed-v2.min.js"></script>
3<div id="page-reacts-example"></div>
4<script>
5 window.FastCommentsUI(document.getElementById('page-reacts-example'), {
6 tenantId: 'demo',
7 pageReactConfig: {
8 showUsers: true,
9 reacts: [
10 {id: 'droll', src: 'https://docs.fastcomments.com/images/emojis/droll.png'},
11 {id: 'he', src: 'https://docs.fastcomments.com/images/emojis/heart-eyes.png'},
12 {id: 'laugh', src: 'https://docs.fastcomments.com/images/emojis/laugh.png'},
13 {id: 'puke', src: 'https://docs.fastcomments.com/images/emojis/puke.png', selectedSrc: 'https://docs.fastcomments.com/images/emojis/puke-bw.png' },
14 {id: 'rofl', src: 'https://docs.fastcomments.com/images/emojis/rofl.png' },
15 ]
16 }
17 });
18</script>
19

Konfiguracja dla bibliotek frontendowych takich jak React, Angular i inne jest taka sama.

Pływający widżet polubień Internal Link

Widget z pływającymi polubieniami wyświetla pływające pole w prawym dolnym rogu ekranu z liczbą polubień i komentarzy. Możesz zobaczyć go w akcji na tej stronie!

Użytkownicy mogą kliknąć serce, aby polubić stronę, a widżet zapamiętuje strony, które polubili. Jeśli są zalogowani na fastcomments.com, jest to powiązane z ich kontem, aby zapobiec wielokrotnemu polubieniu tej samej strony.

Automatycznie wykrywa też preferencje trybu ciemnego przeglądarki użytkownika i zmienia swoją skórkę na wersję ciemną, jeśli jest to pożądane.

Instalacja - VanillaJS Internal Link

Instalacja jest prosta:

Przykład kodu Floating Likes
Copy Copy
1
2<script src="https://cdn.fastcomments.com/js/embed-page-likes-floating.min.js"></script>
3<div id="fastcomments-page-likes-floating"></div>
4<script>
5 window.FastCommentsEmbedPageLikesFloating(document.getElementById('fastcomments-page-likes-floating'), {
6 tenantId: 'demo'
7 });
8</script>
9

Sygnatura konstruktora:

Konfiguracja
Copy Copy
1
2/**
3 *
4 * @param {HTMLElement} targetElement
5 * @param config
6 * @property {string} tenantId
7 * @property {string} urlId - Zmień to, aby ustawić identyfikator strony/artykułu. Domyślnie jest to adres URL strony.
8 * @property {() => void} [onOpenComments]
9 * @property {object} [sso]
10 * @constructor
11 */
12

Obsługuje sso, aby powiązać reakcje z kontem użytkownika w celu uwierzytelnienia.

Obecnie obsługiwany jest tylko VanillaJS. Jeśli chcesz, aby ten widżet został dodany do jednej z naszych bibliotek klienckich, daj nam znać!

Wersja asynchroniczna

Przykład asynchronicznego kodu Floating Likes
Copy Copy
1
2<script src="https://cdn.fastcomments.com/js/embed-page-likes-floating.min.js?v=2" async></script>
3<div id="fastcomments-page-likes-floating"></div>
4<script>
5 (function () {
6 function tryLoad() {
7 if (window.FastCommentsEmbedPageLikesFloating) {
8 window.FastCommentsEmbedPageLikesFloating(document.getElementById('fastcomments-page-likes-floating'), {
9 tenantId: 'demo'
10 });
11 } else {
12 setTimeout(tryLoad, 50);
13 }
14 }
15
16 tryLoad();
17 })();
18</script>
19

Z SSO

Możemy także przekazać dane Secure SSO lub Simple SSO:

Przykład kodu Floating Likes z Secure SSO
Copy Copy
1
2<script src="https://cdn.fastcomments.com/js/embed-page-likes-floating.min.js"></script>
3<div id="fastcomments-page-likes-floating"></div>
4<script>
5 window.FastCommentsEmbedPageLikesFloating(document.getElementById('fastcomments-page-likes-floating'), {
6 tenantId: 'demo',
7 sso // przekaż obiekt sso
8 });
9</script>
10
Przykład kodu Floating Likes z Simple SSO
Copy Copy
1
2<script src="https://cdn.fastcomments.com/js/embed-page-likes-floating.min.js"></script>
3<div id="fastcomments-page-likes-floating"></div>
4<script>
5 window.FastCommentsEmbedPageLikesFloating(document.getElementById('fastcomments-page-likes-floating'), {
6 tenantId: 'demo',
7 simpleSSO: {
8 id: 'some-user-id',
9 username: 'some username',
10 email: 'some@email.com',
11 }
12 });
13</script>
14

Instalacja - WordPress Internal Link


W przypadku WordPressa tę funkcję można włączyć, instalując wtyczkę taką jak WPCode i dodając następujący fragment HTML do stopki bloga:

Kod pływających polubień dla WordPress
Copy Copy
1
2<script src="https://cdn.fastcomments.com/js/embed-page-likes-floating.min.js" async></script>
3<div id="fastcomments-page-likes-floating"></div>
4<script>
5 (function () {
6 function tryLoad() {
7 if (window.FastCommentsEmbedPageLikesFloating) {
8 const articles = document.getElementsByTagName('article');
9 if (!articles.length) {
10 return console.warn('Article not found to show fastcomments likes.');
11 }
12 window.FastCommentsEmbedPageLikesFloating(document.getElementById('fastcomments-page-likes-floating'), {
13 tenantId: '-VuPDR12d-v_',
14 urlId: articles[0].id.replace('post-', '')
15 });
16 } else {
17 setTimeout(tryLoad, 50);
18 }
19 }
20
21 tryLoad();
22 })();
23</script>
24