▤ Руководства

Контекстная помощь у показателей

Содержание

Рядом с показателями стоит значок «?». Нажмите на него — появится короткое объяснение простыми словами, пример хорошего и пример плохого значения и ссылка на термин в справочнике (/help/terms).

Где есть подсказки

  • Отчёт: ранг, возраст домена, скорость, SSL и каждая проверка в таблице проверок (HTTPS, сертификат, заголовки, robots.txt, sitemap, title, description, H1, Open Graph, скорость, кэш, сжатие, редиректы и другие).
  • Проверка в браузере: LCP, CLS, INP, TBT.
  • История замеров скорости: LCP и CLS.
  • Анализ текста: академическая и классическая «тошнота», индекс читаемости.
  • Контроль доступности: процент доступности.

Как это устроено

Все тексты хранятся в одном каталоге Help\Hints: ключ совпадает с кодом проверки отчёта (или kpi_*, tx_*, cwv_*, up_sla для показателей инструментов). У каждой записи: объяснение, пример правильного значения, пример неправильного значения и слаг термина справочника. Поэтому один показатель объясняется одинаково везде, а английский текст лежит в обычном словаре интерфейса. Подсказка — стандартный элемент <details>, поэтому работает без JavaScript и с клавиатуры (Enter/Пробел открывает, Esc закрывает). Скрипт лишь закрывает её по нажатию вне подсказки и держит открытой только одну. На телефоне подсказка раскрывается панелью внизу экрана.

Как читать примеры

Пороги в примерах — ориентиры, а не требования поисковых систем: те же границы использует расчёт ранга. «Хорошо» не гарантирует позиций в выдаче, а «Плохо» — не приговор: смотрите на подсказку вместе со статусом проверки и инструкцией «Как исправить».

Как добавить подсказку

Добавьте запись в Help\Hints::ALL (русский текст), английский перевод — в resources/lang/en.php, вызовите hint('код') рядом с показателем. Тест Pack124 проверяет, что у записи есть все части, слаг термина существует в справочнике, а перевод присутствует.

Ограничения

Подсказки есть не у каждого показателя, а у наиболее частых и непонятных. Если для кода записи нет, значок не выводится.