Home ru

Документация Commentail

English · Русский

Комментарии для Wagtail CMS на вашем сервере. Подключите обсуждения с модерацией к страницам Wagtail и зарегистрированным Django-моделям, используя учётные записи, шаблоны и оформление своего сайта.

1.4.1 Stable: Wagtail 7.4.3+ с Django 5.2 или 6.0; Wagtail 8.0 с Django 5.2, 6.0 или 6.1; Python 3.12–3.14; файловая SQLite и PostgreSQL 16. Для опубликованной 0.1.0 сохраняется поддержка Wagtail >=7.4.3,<7.5 и Django 5.2.

Гостевые комментарии защищены скрытыми проверками формы, лимитами попыток и сигналами повторяющегося текста и большого числа ссылок. Google reCAPTCHA v2 и Яндекс SmartCaptcha подключаются по желанию; по умолчанию используется арифметическая проверка. Настройте отправку писем Django и одно расписание фоновой обработки — командой или через очередь задач проекта.

Версия 1.4.0 добавляет отдельную настройку почты и команду проверочного письма, а также ранний отказ гостю по жёстким правилам с причинами и поддержкой CSV. Патч 1.4.1 исправляет описание PyPI без изменения кода. См. текущий выпуск и обновление с прежних версий. При переходе с 1.3.0 и более ранних версий также нужна процедура необратимой миграции 1.3.1.

Пошаговый курс на русском

Курс по Commentail — 22 урока от установки до настройки разбирает установку, отправку писем, CAPTCHA, оформление и работу на реальном сайте. Начните с учебного проекта или выберите нужную тему. В уроках есть пошаговые инструкции и примеры кода.

Курс на русском · English course

Найдите нужное руководство

Подробные справочные страницы Wiki пока доступны на английском; ссылки в таблице ведут на них. Полный учебный курс выше доступен на русском и английском.

Задача	Руководство
Подключить библиотеку к Wagtail	Установка
Настроить сайт, страницы и параметры Python	Конфигурация
Проверять комментарии и делегировать доступ	Модерация
Управлять правилами слов через CSV	Правила и CSV
Разобраться с подтверждением гостей	Гостевые комментарии
Настроить ответы и ограничения правки	Ответы и редактирование
Отправлять письма и запускать фоновую обработку	Почта и обработчик
Выбрать отдельный backend или отправителя (1.4.0)	Настройка почты
Подстроить виджет под тему сайта	Оформление
Заменить разметку и шаблоны писем	Шаблоны
Вывести последние комментарии	Последние комментарии
Добавить структурированные данные	Структурированные данные
Настроить аватары, имена или CAPTCHA	Функции расширения
Подключить другие модели Django	Адаптеры объектов
Разобраться в доступе и хранении данных	Безопасность и приватность
Подготовить рабочий сайт	Развёртывание
Оценить запросы и проверить нагрузку	Производительность
Найти причину ошибки	Решение проблем
Запустить пример и тесты	Пример и проверки
Прочитать об изменениях и обновлении	Выпуск 1.4.0
Проверить гарантии совместимости	Стабильный контракт
Сравнить версии	История изменений
Узнать о планах	Планы
Прочитать об исходном выпуске	Выпуск 0.1.0
Поддержать разработку	Поддержка

Первый запуск

1. Пройдите установку на тестовом сайте.
2. Начните с политики Review all: по умолчанию все комментарии проверяются.
3. Настройте отправку писем и её расписание, прежде чем включать гостей. Выберите рабочий почтовый backend и одно расписание.
4. Проверьте публикацию, ответ и разрешённое редактирование.
5. Настройте оформление и права модераторов в пределах сайта.

Обычный текст, серверная разметка и необязательный JavaScript позволяют подключить виджет без фронтенд-фреймворка. Интерфейс, модерация и письма доступны на английском, русском, немецком, французском, испанском и бразильском португальском; см. настройку языков. Внешняя платформа комментариев, Redis, Celery и CDN не обязательны.

---

Главная документации · Установка →