Урок 22 / 22 · Commentail 1.3.2
Здесь собраны все технические параметры версии 1.3.2. Это справочник для точечной настройки, а не готовый словарь, который нужно целиком скопировать. Начните со штатных значений; меняйте только параметр, для которого есть понятная причина.
Как читать таблицу
Длительности указаны в целых секундах. None — значение Python, не строка "None". Callback задаётся строкой полного импорта. Обычные ограничения положительные; ноль допустим только у явно описанных отключаемых сигналов. Типы и ключи проверяются python manage.py check; ошибка commentail.E001 означает, что конфигурацию нужно исправить до запуска.
Порядок: встроенное значение → default → точный hostname Site. Сохраняйте один общий словарь COMMENTAIL, объединяя примеры уроков. Несколько присваиваний COMMENTAIL в одном файле не объединятся: последнее заменит предыдущие.
Формат вывода и регистрация объектов
| Настройка | По умолчанию | Что меняет |
|---|---|---|
STRUCTURED_DATA
|
"both"
|
Формат Schema.org: both, json_ld, microdata или off.
|
OBJECT_ADAPTERS
|
{}
|
Регистрация моделей и адаптеров; только default.
|
Импорт правил CSV
| Настройка | По умолчанию | Что меняет |
|---|---|---|
RULES_CSV_MAX_BYTES
|
5242880
|
Максимальный размер CSV в байтах; только default.
|
RULES_CSV_MAX_ROWS
|
20000
|
Максимальное число строк CSV; только default.
|
Формы, правки и подтверждение почты
| Настройка | По умолчанию | Что меняет |
|---|---|---|
FORM_TICKET_SECONDS
|
3600
|
Срок формы/восстановления и локальной привязки Google/Яндекс, секунды. |
FORM_IP_LIMIT_PER_MINUTE
|
120
|
Новые формы/восстановления на IP/Site за минуту.
|
FORM_IP_LIMIT_PER_HOUR
|
1200
|
Новые формы/восстановления на IP/Site за час.
|
EDIT_WINDOW_SECONDS
|
900
|
Окно правки после публикации; принятый ответ закрывает его раньше. |
EMAIL_CONFIRM_SECONDS
|
86400
|
Срок подтверждения почты от принятия отправки. |
GUEST_GRANT_SECONDS
|
2592000
|
Фиксированный срок подтверждения браузера от проверки почты. |
CAPTCHA и её лимиты
| Настройка | По умолчанию | Что меняет |
|---|---|---|
CAPTCHA_SECONDS
|
300
|
Срок арифметической/собственной CAPTCHA; не срок токена Google/Яндекс. |
CAPTCHA_ATTEMPTS
|
5
|
Число попыток одной задачи CAPTCHA. |
CAPTCHA_IP_LIMIT_PER_MINUTE
|
10
|
Создания CAPTCHA на IP/Site за минуту.
|
CAPTCHA_IP_LIMIT_PER_HOUR
|
100
|
Создания CAPTCHA на IP/Site за час.
|
CAPTCHA_BACKEND
|
None
|
Путь класса CAPTCHA; None выбирает арифметику.
|
CAPTCHA_OPTIONS
|
{}
|
Ключи/тайм-аут провайдера; словарь полностью заменяется по hostname. |
GUEST_CAPTCHA_MODE
|
'adaptive'
|
adaptive или always; влияет на требование CAPTCHA гостю.
|
Отправка комментариев и повторных писем
| Настройка | По умолчанию | Что меняет |
|---|---|---|
AUTHOR_MIN_INTERVAL
|
30
|
Минимальная пауза между принятыми отправками автора. |
AUTHOR_LIMIT_PER_HOUR
|
20
|
Принятые отправки автора на Site за час.
|
IP_LIMIT_PER_HOUR
|
100
|
Принятые отправки IP на Site за час.
|
RESEND_MIN_INTERVAL
|
60
|
Минимальная пауза между повторными письмами подтверждения. |
RESEND_LIMIT_PER_HOUR
|
5
|
Повторные подтверждения для автора/Site за час.
|
RESEND_IP_LIMIT_PER_HOUR
|
20
|
Повторные подтверждения для IP/Site за час.
|
Прокси и дополнительные сигналы спама
| Настройка | По умолчанию | Что меняет |
|---|---|---|
TRUSTED_PROXIES
|
[]
|
Доверенные сети прокси; пустой список игнорирует forwarded IP. |
GUEST_REQUEST_CHECKS
|
['missing_user_agent', 'cross_site']
|
Дополнительные сигналы заголовков гостя; [] отключает только их.
|
GUEST_FORM_MIN_SECONDS
|
2
|
Порог быстрой формы для модерации; 0 отключает сигнал.
|
GUEST_ATTEMPTS_PER_MINUTE
|
10
|
Попытки гостя по сессии/Site за минуту, включая неуспешные.
|
GUEST_IP_ATTEMPTS_PER_MINUTE
|
30
|
Попытки гостя по IP/Site за минуту.
|
GUEST_IP_ATTEMPTS_PER_HOUR
|
300
|
Попытки гостя по IP/Site за час.
|
GUEST_DUPLICATE_WINDOW_SECONDS
|
3600
|
Окно сравнения повторов; 0 отключает и новые fingerprints.
|
GUEST_DUPLICATE_MIN_LENGTH
|
80
|
Минимальная длина нормализованного текста для сравнения повторов. |
GUEST_LINK_REVIEW_THRESHOLD
|
3
|
Число явных ссылок для модерации; 0 отключает сигнал.
|
Очередь писем и ссылки действий
| Настройка | По умолчанию | Что меняет |
|---|---|---|
MAIL_RETENTION_SECONDS
|
604800
|
Срок хранения заданий доставки. |
MAIL_LEASE_SECONDS
|
300
|
Срок аренды задания обработчиком. |
MAIL_RETRY_SECONDS
|
[60, 300, 900]
|
Последовательность задержек повторов, секунды. |
ACTION_LINK_SECONDS
|
2592000
|
Срок обычной ссылки действия; не продлевает доступность правки. |
Функции проекта
| Настройка | По умолчанию | Что меняет |
|---|---|---|
CAN_SEND_GUEST_EMAIL
|
None
|
Путь функции проверки доступа гостя к письму без браузера. |
GET_COMMENT_TEMPLATES
|
None
|
Путь функции зависимостей динамических шаблонов Page.
|
GET_AVATAR
|
None
|
Путь функции URL аватара. |
GET_AUTHOR_NAME
|
None
|
Путь функции текущего имени зарегистрированного автора. |
Что сюда не входит
Open/Read only/Hidden, политика модерации, доступ, длина текста, кликабельность ссылок и письма о решениях настраиваются в Wagtail. Send emails и Highlight staff — только Site; остальные перечисленные редакторские поля допускают Page/object override. Транспорт почты выбирается EMAIL_BACKEND и настройками Django/провайдера, не ключом словаря COMMENTAIL.
Уже выданные токены сохраняют свои сроки после изменения длительности. Изменение лимита не должно служить обходом неверной сетевой настройки. Для CAPTCHA_OPTIONS переопределение hostname заменяет весь словарь; OBJECT_ADAPTERS и RULES_CSV_* допустимы только в default.
После изменения выполните check, перезапустите соответствующие процессы и повторите связанный пользовательский сценарий. Для почты проверяйте оба процесса — сайт и worker.
Другие уроки по этой задаче
3. Настройки сайта и путь читателя5. Переменные окружения без путаницы с ключами- 21. Что делать, если комментарии не работают
Выберите способ входа или оставьте комментарий как гость ниже.