Встраиваемые шаблоны тегов для древовидных комментариев, чата в реальном времени и подсчета комментариев. Безопасный единый вход (SSO), подписанный пользователями Django, полный REST-доступ через Python SDK и отсутствие этапов сборки фронтенда.
FastComments предоставляет полный набор функций для вашего приложения Django.
Выберите режим аутентификации, соответствующий потребностям вашего приложения.
Подписание токенов HMAC-SHA256 на стороне сервера от имени пользователя Django для обеспечения максимальной безопасности.
Единый вход на стороне клиента для быстрой настройки без аутентификации на сервере.
Предоставьте пользователям возможность самостоятельно создавать собственные учетные записи FastComments.
Три шага для добавления комментариев в реальном времени в ваше приложение Django.
Установите пакет из GitHub с помощью pip. Добавьте параметр `api extra`, если вам нужен доступ по REST-запросу на стороне сервера.
$pip install "git+https://github.com/fastcomments/fastcomments-django.git@v0.1.0"
Добавьте "fastcomments_django" в INSTALLED_APPS, затем установите словарь FASTCOMMENTS, указав свой TENANT_ID и API_KEY.
INSTALLED_APPS = [
# ...
"fastcomments_django",
]
FASTCOMMENTS = {
"TENANT_ID": "your-tenant-id",
"API_KEY": "your-api-key",
}
Загрузите библиотеку тегов в любой шаблон, а затем вставьте виджет комментариев в то место, где вы хотите разместить ветку обсуждения.
{% load fastcomments %}
{% fastcomments url_id=post.slug %}
Мы собрали ответы на самые распространенные вопросы, чтобы помочь вам начать.
Есть ли бесплатная пробная версия?
Да. FastComments предлагает 30-дневную бесплатную пробную версию с полным доступом ко всем функциям, включая единый вход (SSO), онлайн-чат и редактор форматированного текста. Для начала работы кредитная карта не требуется.
Как работает единый вход (SSO) с аутентификацией Django?
При включении Secure SSO пакет считывает данные аутентифицированного пользователя из запроса и подписывает токен HMAC-SHA256 на сервере. Это создает или обновляет учетную запись FastComments пользователя с его именем, адресом электронной почты и аватаром, поэтому пользователи входят в систему без дополнительной регистрации. Сопоставьте поля с USER_MAP, методом to_fastcomments_user_data() вашей модели пользователя или глобальным USER_MAPPER. Выбирайте идентификатор SSO обдуманно: это постоянный идентификатор истории комментариев пользователя, поэтому сопоставьте его со стабильным, непрозрачным значением, таким как UUID, а не с последовательным первичным ключом.
Какие версии Django и Python поддерживаются?
Пакет FastComments для Django поддерживает Django версий 4.2, 5.0, 5.1 и 5.2 и требует Python 3.10 или выше. Он устанавливается как стандартное приложение Django с одной записью в INSTALLED_APPS.
Соответствует ли FastComments требованиям GDPR?
Да. FastComments полностью соответствует требованиям GDPR и имеет опциональную CDN-сеть, расположенную в ЕС, которая хранит все данные в пределах Европы. Установите регион «eu» в настройках FASTCOMMENTS, и пакет будет направлять виджеты и вызовы API в регион ЕС. Мы поддерживаем запросы на экспорт данных, право на удаление и предоставляем соглашение об обработке данных (DPA) по запросу.
Можно ли настроить разметку виджета?
Да. Переопределите шаблон fastcomments/widget.html, разместив свою собственную копию выше в пути поиска шаблонов. Каждый тег также принимает стандартные параметры конфигурации FastComments в качестве аргументов ключевых слов, что дает вам полный контроль над внешним видом и поведением без редактирования пакета.
Можно ли получить доступ к API FastComments из Django?
Да. Установите api extra, и пакет предоставит доступ к Python SDK FastComments: admin() для аутентифицированных вызовов, public_api() для публичных вызовов и get_manager() для подписи токенов SSO. Используйте их для создания, обновления или удаления комментариев, управления пользователями, получения аналитики и многого другого из ваших представлений или фоновых задач.
Установите пакет, загрузите библиотеку тегов, добавьте шаблонный тег и запустите сайт за считанные минуты.