
Решение проблем
Очередь растёт, ничего не уходит
- Проверьте
indexnow_enabled = Даи валидность ключа иindexnow_endpoint. При невалидных значениях worker молча пропускает проход: очередь растёт, история пустая, в логе MODX строкиWorker skipped. - Дождитесь queue tick (любой запрос фронта или перезагрузка страницы менеджера) или нажмите Обработать очередь.
- Если сайт долго без HTTP-трафика, установите Scheduler и задачу IndexNow: Process Queue.
- Откройте История: HTTP-код и текст ошибки.
Файл ключа не найден
Создайте {key}.txt в web root. В файле должен быть только ключ.
На мультидомене положите файл в каждый публичный корень. См. Ключ и key file.
HTTP 403
Частые причины: нет key file, неверный ключ, endpoint отверг запрос (в том числе локальный host вроде project.test).
Исправьте файл ключа, затем Повторить у строки failed: attempts обнуляется, worker снова проходит полный цикл попыток.
HTTP 429 или 5xx
Временная ошибка. Worker ставит паузу indexnow_retry_delay. При необходимости увеличьте задержку или уменьшите indexnow_batch_size.
HTTP 401, 404, 410 и другие 4xx
Считаются постоянной ошибкой: сразу failed, без цикла retry (кроме явно временных кодов в worker). Полная таблица кодов: Очередь и отправка → HTTP-коды.
Страница сохранилась, в логе ошибка IndexNow
Так и задумано. Плагин ловит исключения и пишет в лог MODX. Сохранение ресурса не откатывается.
Ручной URL отклонён
Разрешены только host ваших контекстов. Не проходят localhost, private/reserved IP и metadata.google.internal. Проверьте абсолютный URL и настройки site_url / http_host.
Manager / AJAX не отвечает
Проверьте, что assets/components/indexnow/connector.php находит config.core.php сайта. При нестандартной раскладке каталогов connector ищет файл вверх по дереву директорий.
