
Език 🇧🇬 Български
Първи стъпки
Конфигурация
Документация
Add Comments to Your Drupal Site
Това е официалният модул на FastComments за Drupal.
Модул за Drupal, който интегрира FastComments с Drupal 10/11, предоставяйки блокове за уиджети, интеграция с полета на ентитети, SSO и гранулирани разрешения.
Хранилище
Инсталиране 
- Поставете този модул в директорията
modules/custom/fastcomments/на вашия Drupal сайт (или инсталирайте чрез Composer:composer require drupal/fcom). - Активирайте модула:
Или го активирайте чрез административния интерфейс в Extend (drush en fastcomments/admin/modules).
Конфигурация 
Отидете до Администрация > Конфигурация > Съдържание > FastComments (/admin/config/content/fastcomments).
Настройки
- Tenant ID (задължително) - Вашият FastComments Tenant ID. Намерете го под Настройки > API/SSO (EU).
- API Secret - Изисква се за Secure SSO, потвърждение на webhook и синхронизация на страници. Намерява се под Настройки > API/SSO (EU).
- SSO Mode - Интеграция за Single Sign-On:
- None - Без SSO; потребителите коментират като гости или създават FastComments акаунти.
- Simple - Предава информация за потребителя от Drupal (име, имейл, аватар) на FastComments без верификация на сървъра.
- Secure - Използва HMAC-SHA256 верификация за сигурна автентикация на Drupal потребители с FastComments (препоръчително).
- Commenting Style - Типът на джаджата за показване:
- Live Comments - Нишкови коментари в реално време.
- Streaming Chat - Интерфейс за чат в реално време.
- Collab Chat - Съвместно анотиране чрез избор на текст върху основното съдържание.
- Collab Chat + Comments - Комбинация от Collab чат и стандартни коментари.
- CDN URL - FastComments CDN URL (по подразбиране:
https://cdn.fastcomments.com). - Site URL - FastComments site URL (по подразбиране:
https://fastcomments.com). - Email notifications - Изпраща имейл на авторите на съдържанието, когато бъде публикуван нов коментар в тяхното съдържание.
Adding Comments to Content Types
Добавете полето FastComments към вашите типове съдържание чрез Структура > Типове съдържание > [type] > Управление на полета. Полето има превключвател за статус и опционален персонализиран идентификатор за всеки ентитет.
EU Data Residency
За резиденция на данни в ЕС актуализирайте:
- CDN URL на
https://cdn-eu.fastcomments.com - Site URL на
https://eu.fastcomments.com
Уиджет блокове 
Налични са няколко блока през Структура > Оформление на блокове (/admin/structure/block):
- FastComments Widget - Основният коментарен уиджет. Автоматично разпознава текущия ентитет. Пропуска ентитети, които вече имат полето FastComments (за да се предотвратят дубликати).
- FastComments Live Chat - Чат в реално време. Може да бъде поставен до полето за коментари на същата страница.
- FastComments Collab Chat - Анотиране чрез селекция на текст и обсъждане.
- FastComments Image Chat - Анотации на изображения, базирани на координати.
- FastComments Recent Comments - Показва последните коментари в целия ви сайт. Настройваем брой коментари.
- FastComments Top Pages - Показва страниците с най-много коментари.
Блоковете, ориентирани към съдържанието (Live Chat, Collab Chat, Image Chat), автоматично откриват текущия ентитет и при страници без ентитет използват идентификатор, базиран на пътя.
Разрешения 
- Administer FastComments - Достъп до формуляра за настройки на FastComments.
- View FastComments - Необходимо за виждане на уиджета за коментари.
- Toggle FastComments - Позволява на потребителите да активират/деактивират коментарите за всяка същност чрез полето на уиджета.
Как работи 
Когато потребител посети entity, за която полето FastComments е активирано:
- JavaScript widget-ът на FastComments се зарежда от CDN.
- Ако SSO е конфигуриран, идентичността на потребителя в Drupal се предава на FastComments.
- Резервният вариант
Изисквания 
- Drupal 10 или 11
- PHP 8.1+
- Акаунт в FastComments
Нужна помощ?
Ако срещнете проблеми или имате въпроси относно модула за Drupal, моля:
Принос
Приноси са добре дошли! Моля, посетете хранилището в GitHub за указания относно приноса.