FastComments.com

Menu Icon

Мова 🇺🇦 Українська
🇺🇸 English 🇧🇬 Български 🇨🇳 简体中文 🇹🇼 繁體中文 🇭🇷 Hrvatski 🇩🇰 Dansk 🇳🇱 Nederlands 🇺🇸 English (US) 🇨🇦 Français (Canada) 🇫🇷 Français (France) 🇩🇪 Deutsch 🇨🇾 Ελληνικά (Κύπρος) 🇬🇷 Ελληνικά 🇮🇱 עברית 🇮🇹 Italiano 🇯🇵 日本語 🇰🇷 한국어 🇵🇱 Polski 🇧🇷 Português (Brasil) 🇷🇺 Русский 🇺🇦 Русский (Украина) 🇧🇦 Српски (БиХ) 🇷🇸 Srpski (Latinica) 🇲🇪 Српски (Црна Гора) 🇷🇸 Српски 🇸🇮 Slovenščina 🇪🇸 Español 🇺🇦 Українська 🇹🇷 Türkçe

Загальні відомості

Що таке SSR?
Переваги SSR
Підтримувані функції SSR у FastComments

Використання SSR

Сценарії використання
Де FastComments використовує SSR
Використання SSR

Що таке SSR? Internal Link

SSR, або рендеринг на стороні сервера, — це механізм і набір конвенцій, де додаток або вміст відтворюється з мінімальною роботою з боку клієнта.

При SSR клієнт не виконує JavaScript. Натомість клієнт відображає HTML/CSS, який був "згенерований" сервером.

Переваги SSR Internal Link

Головна перевага SSR полягає в тому, що JavaScript не потрібен. Через це додатки в багатьох випадках можуть здаватися "легшими".

Крім того, SSR можна використовувати як резервний варіант на випадок, якщо у користувача вимкнено JavaScript. Таким чином потоки коментарів все ще можуть відображатися, а користувач все ще може відповідати на коментарі.

FastComments вже добре оптимізований, тож у більшості випадків SSR не є необхідним. Однак деякі онлайн-спільноти мають користувачів, які не використовують JavaScript, або вимкнення JavaScript є переважною практикою. Саме тут SSR від FastComments може бути корисним.

Однак суттєвим компромісом SSR є необхідність перезавантажувати сторінку заради невеликих змін стану.

Підтримувані функції SSR у FastComments Internal Link

FastComments підтримує такі функції з SSR:

  • Налаштовуваний віджет коментарів.
  • Анонімне коментування.
  • Коментування при вході в систему.
  • SSO.
  • Кореневі та вкладені відповіді.
  • Перегляд & пагінація гілок коментарів.
  • Голосування, включно з анонімним голосуванням.
  • Зміна напрямку сортування за замовчуванням.

Приклад

Приклад FastComments SSR доступний тут.

FastComments SSR
External Link

Сценарії використання Internal Link

Приклади використання SSR такі:

  • Резервний варіант на випадок, коли JavaScript вимкнено.
  • Щоб відобразити інтерфейс коментарів у середовищі, де JavaScript недоступний або небажаний.
  • Для сайтів або онлайн-спільнот, де небажано додавати більше JavaScript.

Де FastComments використовує SSR Internal Link

FastComments використовує SSR у таких місцях:

  • Наш плагін для WordPress за замовчуванням використовує SSR як запасний варіант. Якщо JavaScript вимкнено, користувачі все ще можуть залишати коментарі у вашому блозі.
  • Ми використовуємо його як запасний варіант на нашому власному блозі! https://blog.fastcomments.com

Використання SSR Internal Link

Щоб використовувати FastComments SSR, клієнт може отримати HTML із кінцевої точки https://fastcomments.com/ssr/comments.

Це можна зробити кількома способами.

У WordPress

SSR увімкнено за замовчуванням у плагіні WordPress як запасний варіант для користувачів без підтримки JS, починаючи з версії 3.10.2.

На веб-сторінці

У вже існуючому додатку SSR можна додати за допомогою наступного прикладу, якщо використовується мова PHP:

Приклад SSR на PHP
Copy Copy
1
2<?php
3$tenantId = rawurlencode("my-tenant-id");
4$urlId = rawurlencode("my-page-url-article-id");
5$url = rawurlencode("my-page-url");
6
7$fastcomments_url = "https://fastcomments.com/ssr/comments?tenantId=$tenantId&urlId=$urlId&url=$url";
8?>
9<iframe
10 src="<?php echo $fastcomments_url; ?>"
11 horizontalscrolling="no"
12 allowtransparency="true"
13 frameborder="0"
14 title="FastComments"
15 width="100%"
16 height="1500px"
17 style= "width: 1px !important; min-width: 100% !important; border: none !important; overflow: hidden !important;"
18></iframe>
19

Можна також показувати інтерфейс SSR лише коли у користувача вимкнено JS:

Приклад запасного варіанту SSR на PHP
Copy Copy
1
2<?php
3$tenantId = rawurlencode("my-tenant-id");
4$urlId = rawurlencode("my-page-url-article-id");
5$url = rawurlencode("my-page-url");
6
7$fastcomments_url = "https://fastcomments.com/ssr/comments?tenantId=$tenantId&urlId=$urlId&url=$url";
8?>
9<noscript>
10 <iframe
11 src="<?php echo $fastcomments_url; ?>"
12 horizontalscrolling="no"
13 allowtransparency="true"
14 frameborder="0"
15 title="FastComments"
16 width="100%"
17 height="1500px"
18 style= "width: 1px !important; min-width: 100% !important; border: none !important; overflow: hidden !important;"
19 ></iframe>
20</noscript>
21

Для прикладу з використанням SSO дивіться тут.

З попередньо згенерованим контентом

Наш блог генерується під час збірки і містить хороший приклад SSR з Handlebars.

Основні параметри

Основні параметри, які потрібно передати:

  • tenantId - Це ідентифікує вас як клієнта.
  • urlId - Ідентифікує сторінку або статтю, для якої потрібно завантажити коментарі, і визначає, де вони зберігаються.
  • url - Використовується для сповіщень та пов'язаних функцій, щоб створити посилання назад на потік коментарів.

Користувацьке стилювання

SSR-версія віджета коментарів використовує ту ж структуру та механізм рендерингу, що й JavaScript-версія.

Отже, усі користувацькі стилі, які працюють для JavaScript-віджета коментарів, працюватимуть і для SSR.

Примітки

У SSR немає JavaScript, що контролює висоту відображуваного контейнера. У браузерах може з'явитися вертикальна смужка прокрутки для довгих обговорень.

Тому потрібно налаштувати це за потреби.

Зробити внесок у цей посібник