Контекстная помощь у показателей
Рядом с показателями стоит значок «?». Нажмите на него — появится короткое объяснение простыми словами, пример хорошего и пример плохого значения и ссылка на термин в справочнике (/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 проверяет, что у записи есть все части, слаг термина существует в справочнике, а перевод присутствует.
Ограничения
Подсказки есть не у каждого показателя, а у наиболее частых и непонятных. Если для кода записи нет, значок не выводится.