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, который контролирует высоту отрендеренного контейнера. В браузерах при длинных обсуждениях может появиться вертикальная полоса прокрутки.

Поэтому вам нужно настроить это по своему усмотрению.

Внести вклад в это руководство