Урок 21 / 22 · Commentail 1.3.2
Начните с признака, а не с переустановки. Одна команда не исправит отсутствующий виджет, неправильный Site и недоставленное письмо одновременно.
Соберём базовые сведения
В окружении, которое запускает сайт:
python --version
python -m pip show commentail Django wagtail
python manage.py check
python manage.py showmigrations commentail
Сохраните версии и точный текст ошибки. В сообщении поддержки укажите воспроизведение, ожидаемое действие, фактический результат, тип базы и схему прокси. Удалите адреса пользователей, cookie, ключи, полные письма и защищённые ссылки. Для примера достаточно YOUR_API_KEY и названий переменных.
Виджет и формы
| Признак | Что проверить первым |
|---|---|
| Нет вкладки Comments |
Реальный шаблон Page содержит widget tag; вычисляемый include объявлен callback
|
| Нет виджета на странице |
Page опубликована, правильный Site/root, режим не Hidden, доступ посетителя
|
| Ошибка неизвестного тега |
load commentail_tags в текущем шаблоне и commentail в INSTALLED_APPS
|
| CSS/JS дают 404 |
collectstatic, STATIC_URL/STATIC_ROOT и раздача файлов сервером
|
| 403 после отправки | CSRF token, cookie, origin/HTTPS/proxy и middleware; не отключать CSRF |
| Гостевая форма недоступна |
EMAIL_BACKEND, параметры доставки, Send emails и политика доступа
|
| CAPTCHA не появляется | Новый гость или remembered proof, JS, домен ключей, CSP/блокировщик |
| Сразу срабатывает лимит | Реальный peer прокси и общий IP, form issuance quotas, частота повторов |
| Исчезла правка | Прошло 15 минут, принят ответ, есть ожидающая правка или обсуждение закрыто |
Письма
| Статус | Что означает | Что проверить |
|---|---|---|
| Queued | Задание ждёт обработчика | Расписание запуска, окружение и базу |
| Failed | Отправка завершилась ошибкой |
Категорию ошибки, транспорт, шаблон, адрес Site и журнал провайдера
|
| Sent | Backend принял письмо | Доставку и папку Входящие: статус сам по себе их не подтверждает |
Console backend печатает письмо в терминале worker, не обязательно веб-сервера. Неверный домен ссылки исправляется настройкой Site/HTTPS, а не заменой текста письма вручную.
Производительность
Не кешируйте персональные формы для всех. При медленной странице сначала проверьте свои callbacks: запрос к удалённому аватару и запрос профиля на каждой карточке могут быть дороже штатной выборки. Измеряйте SQL, время ответа и backlog на копии с похожими данными. Глобальный recent-список может просматривать больше кандидатов, чем limit, если многие недоступны. Синтетический benchmark не является обещанием скорости вашего сайта.
Проверим исправление глазами читателя
Повторите тот же шаг из другого браузера, затем проверьте близкий сценарий: ответ после исправления основной формы, русский текст после изменения почтового шаблона, закрытую страницу после изменения адаптера. Автотесты пакета не проверяют вашу DNS-зону, внешний кабинет и CSS сайта.
В Commentail нет отдельного REST API, загрузок файлов, лайков, жалоб, rich text или live updates. Если ищете такую настройку, её отсутствие не является сбоем установки. Другие случаи и команды разработки приведены в диагностике и проверках примера.
Другие уроки по этой задаче
- 2. Подключаем Commentail к существующему Wagtail
- 8. Настраиваем обработчик писем и очистки
- 22. Справочник всех технических настроек
Выберите способ входа или оставьте комментарий как гость ниже.