Files
ave-cms/help/modules/site-readiness.md
2026-07-27 12:58:44 +03:00

5.0 KiB
Raw Permalink Blame History

Готовность сайта

К модульной системе

Модуль Готовность сайта собирает единый отчёт перед публикацией проекта. Он не меняет документы, шаблоны и файлы: автоматические проверки только читают конфигурацию и указывают экран, где исправить проблему.

Установка

Откройте Модули → Управление, найдите «Готовность сайта» и нажмите Установить. После установки появятся:

  • пункт Модули → Готовность сайта;
  • виджет 6/12 на дашборде рядом с безопасностью файлов;
  • права просмотра, запуска и управления;
  • уведомление, если последний отчёт содержит критические ошибки.

При деинсталляции история, подтверждения и настройки модуля удаляются. Простое выключение сохраняет данные.

Профили

На вкладке Профиль выберите назначение проекта:

Профиль Когда использовать
Контентный сайт Страницы, статьи, новости, формы и личный кабинет.
Каталог Контентный сайт со структурированным каталогом.
Магазин Каталог, корзина, заказы и способы оплаты.
Собственный Только явно включённые группы проверок.

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

Отчёт

Кнопка Запустить проверку создаёт новый неизменяемый отчёт. Состояния:

  • Ошибка — критическое препятствие, сайт не считается готовым;
  • Внимание — настройка или ручное действие требуют проверки;
  • Совет — необязательное улучшение;
  • Пройдено — автоматическая проверка успешна;
  • Подтверждено — пункт ручного чек-листа принят администратором.

Оценка помогает сравнивать запуски, но не отменяет критические ошибки. Отчёт можно фильтровать, открыть из истории и скачать в JSON.

Ручной чек-лист

Ручные пункты подтверждают визуальную проверку, работу форм, резервную копию, аналитику и тестовый заказ. Кнопка с галочкой сохраняет пользователя и время. Повторное нажатие снимает подтверждение и создаёт обновлённый отчёт.

Проверки другого модуля

Пакет может добавить свои проверки через хук site_readiness.checks:

Hooks::add('site_readiness.checks', function ($payload) {
    $payload['checks'][] = array(
        'code' => 'reviews.configuration',
        'group' => 'modules',
        'title' => 'Модуль отзывов настроен',
        'description' => 'Проверяет обязательные параметры публикации.',
        'profiles' => array('content', 'catalog', 'commerce', 'custom'),
        'manual' => false,
        'fix_url' => '/modules/reviews',
        'handler' => function () {
            $ready = ReviewsSettings::isReady();
            return array(
                'status' => $ready ? 'passed' : 'warning',
                'message' => $ready ? 'Настройки заполнены' : 'Заполните получателя',
                'details' => array(),
            );
        },
    );

    return $payload;
});

Код проверки должен быть стабильным и уникальным. Допустимые состояния автоматического обработчика: passed, error, warning, recommendation. Исключение обработчика записывается как ошибка конкретной проверки и не ломает остальной отчёт.