Skip to content
Back to search

wp-block-site

SkillWorks with Claude CodeGitHub

Методика и каркас сайта на WordPress: блочная тема без сборки (Gutenberg/FSE) + плагин данных, удобный редактор, читаемый код с линтерами и пределами размера, SEO с первого дня (Rank Math кодом, JSON-LD, llms.txt, SEO-гейт в CI), безопасность, деплой по SSH через GitHub Actions с откатом. Используй, когда нужно: сделать сайт на WordPress по макету или прототипу; перенести старый сайт на новую тему с 301; настроить CI/CD на виртуальный хостинг; сделать блоки, которые удобно править в редакторе; настроить SEO/GEO, скорость, Polylang, Contact Form 7 + Telegram, аналитику с согласием на cookie; провести аудит такого сайта; навести порядок в коде темы или плагина. Triggers: блочная тема, block theme, FSE, Gutenberg, theme.json, block.json, render.php, сайт на WordPress, деплой WordPress, wp-cli импорт, перенос сайта, Rank Math, kalaganov5.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/kalaganov5--wp-block-site/badge.svg)](/listings/kalaganov5--wp-block-site)

HTML

<a href="/listings/kalaganov5--wp-block-site"><img src="/api/listings/kalaganov5--wp-block-site/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Скилл — это папка. Склонируйте репозиторий в папку скиллов Claude Code:

# для всех проектов
git clone https://github.com/kalaganov5/wp-block-site ~/.claude/skills/wp-block-site

# или только для одного проекта
git clone https://github.com/kalaganov5/wp-block-site .claude/skills/wp-block-site

Claude подхватит скилл по описанию («сделай сайт на WordPress по макету», «блочная тема», «перенеси сайт») или по команде `/wp-block-site`. В claude.ai скилл загружается архивом папки (Settings → Capabilities → Skills).

Без Claude: начните с [`SKILL.md`](SKILL.md) — это методика, а каркас разворачивается одной командой.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 206 lines
  1. ---
  2. name: wp-block-site
  3. description: >-
  4. Методика и каркас сайта на WordPress: блочная тема без сборки (Gutenberg/FSE) + плагин данных,
  5. удобный редактор, читаемый код с линтерами и пределами размера, SEO с первого дня (Rank Math кодом,
  6. JSON-LD, llms.txt, SEO-гейт в CI), безопасность, деплой по SSH через GitHub Actions с откатом.
  7. Используй, когда нужно: сделать сайт на WordPress по макету или прототипу; перенести старый сайт на
  8. новую тему с 301; настроить CI/CD на виртуальный хостинг; сделать блоки, которые удобно править в
  9. редакторе; настроить SEO/GEO, скорость, Polylang, Contact Form 7 + Telegram, аналитику с согласием
  10. на cookie; провести аудит такого сайта; навести порядок в коде темы или плагина. Triggers: блочная
  11. тема, block theme, FSE, Gutenberg, theme.json, block.json, render.php, сайт на WordPress, деплой
  12. WordPress, wp-cli импорт, перенос сайта, Rank Math, kalaganov5.
  13. ---
  14. # Сайт на WordPress: блочная тема + плагин данных + автоматизация
  15. Версия 2.0 (история — `CHANGELOG.md`). Комплект описывает подход, на котором сделан kalaganov5.com, и даёт
  16. каркас, чтобы повторить его на любом проекте. Всё ниже — правила, проверенные на живом сайте; причина каждого
  17. правила записана в `references/`.
  18. ## Что получается на выходе
  19. - **Тема** `wordpress/<slug>/` — блочная тема без сборки: `theme.json`, шаблоны `templates/*.html`,
  20. динамические блоки `blocks/<имя>/{block.json,render.php,style.css}`, стили на CSS-переменных, один `site.js`.
  21. - **Плагин данных** `wordpress/<slug>-core/` — типы записей и поля, настройки сайта, импорт контента,
  22. SEO, формы, аналитика, безопасность, редиректы, команды `wp <prefix> …`. Тема вызывает только его публичный
  23. интерфейс `inc/api.php` и работает без плагина (пустые блоки, не ошибки).
  24. - **Деплой** `wordpress/deploy/remote.sh` — один повторяемый скрипт: ставит сайт с нуля или обновляет
  25. тему и плагин. Его же запускают CI, локальный Docker, тестовый и боевой сервер.
  26. - **Проверки** — одна команда `npm run check`: синтаксис, оформление, пределы размера, безопасность PHP,
  27. граница темы и плагина, тесты бизнес-правил, бюджет веса. Её запускают хук перед коммитом, CI и ручной деплой.
  28. - **GitHub Actions** — `ci.yml` (`npm run check` + установка с нуля + SEO-гейт), `deploy.yml` (test/production по
  29. SSH, откат при сбое), `sync.yml` (копия боевого на тестовый), `health.yml` (дежурная проверка),
  30. `seo-audit.yml` (обход сайта + Lighthouse → ветка отчётов, раз в месяц).
  31. - **Сборщики** `wordpress/tools/` — контент из прототипа в разметку Gutenberg, обложки, QA-скрипты.
  32. - **Документация** — `wordpress/README.md` (для владельца сайта и разработчика), `CLAUDE.md` (для ИИ-агента), `TODO.md`,
  33. `docs/glossary.md` (словарь имён), `docs/decisions.md` (принятые решения).
  34. ## Главные правила (не нарушать)
  35. 1. **Код — только через git, контент — только в админке боевого сайта.** Деплой обновляет файлы темы и
  36. плагина и не трогает записи, меню, настройки. Копия данных идёт только боевой → тестовый.
  37. 2. **Редактор удобен владельцу.** Запись открывается без шаблона: поле заголовка (это H1) и текст, клик в любой
  38. абзац работает. На холсте те же стили, что на сайте, но ничто не плавает и не прилипает; шаблон — по кнопке
  39. «Показать шаблон». В блоках нет образцов-заглушек: пустой блок — подсказка в редакторе и пустота на сайте.
  40. 3. **Блоки темы — динамические, без сборки.** `block.json` + `render.php` + `style.css` в папке блока; панель
  41. настроек строит один общий `editor.js` из атрибутов `block.json`. Тексты страниц — core-блоки (абзац,
  42. заголовок, список, кнопки) со стилями дизайн-системы (`is-style-*`). Один H1 на странице — из шаблона.
  43. 4. **Один источник дизайна.** Цвета, шрифты, отступы — `assets/css/tokens.css` (светлая и тёмная тема);
  44. палитра `theme.json` совпадает с ним; свои цвета и размеры в редакторе выключены.
  45. 5. **Поля записей — без ACF.** Схема полей в PHP → `register_post_meta(show_in_rest)` → панель в
  46. редакторе строится по схеме.
  47. 6. **Всё повторяемо и идемпотентно.** Импорт, деплой, команды `wp <prefix> …` создают только то, чего
  48. нет; «перезаписать» — только явным флагом `--force`. Настройки сторонних плагинов ставятся «один раз на
  49. версию»: дальше главная — админка.
  50. 7. **Сгенерированное коммитится и сверяется в CI.** Если файл собирается скриптом, руками его не правят.
  51. 8. **Тестовый сайт закрыт от поисковиков и счётчиков; боевой открыт.** Это решает окружение, а не человек.
  52. 9. **Минимум плагинов.** Polylang (если языков больше одного), Contact Form 7, Rank Math, кеш страниц.
  53. Слайдеры, меню, cookie, калькуляторы — в теме. Никаких конструкторов страниц.
  54. 10. **Каждое правило — с причиной в комментарии.** Код и документы пишутся так, чтобы следующий
  55. разработчик (или ИИ) понял, почему сделано именно так.
  56. 11. **Код читается за пару минут, и это проверяет машина.** Строка ≤ 120, функция ≤ 40 строк, файл ≤ 250,
  57. вложенность ≤ 3; один файл — одна задача; говорящие имена по словарю; бизнес-правило — чистая функция с
  58. тестом. `npm run check` красный — изменение не принимается (`references/15-code-style.md`).
  59. 12. **SEO — с брифа, а не в конце.** У каждой страницы запрос, адрес, title и description в исходнике контента;
  60. сборщик не пропускает пустые, длинные и повторяющиеся поля; Rank Math настраивается кодом; SEO-гейт в CI
  61. не даёт слить страницу без title или с двумя H1.
  62. 13. **Безопасно по умолчанию.** Заголовки безопасности, закрытые XML-RPC и перечисление пользователей, запрет
  63. PHP в uploads, правка файлов из админки выключена, секреты не попадают в git (поиск перед коммитом и в CI),
  64. деплой делает бэкап базы и откатывает файлы, если сайт после выкладки не открылся.
  65. ## Порядок работы над новым проектом
  66. | Шаг | Что делаем | Читать |
  67. |---|---|---|
  68. | 0 | Бриф: страницы, запросы и SEO-поля, типы контента, языки, формы, интеграции, хостинг, домены test/prod | `references/12-checklists.md` (бриф), `07-seo-geo.md` |
  69. | 1 | Каркас: `node scripts/scaffold.js <папка> --slug=… --name="…" --domain=…`, затем `npm install && composer install` | `references/01-architecture.md`, `15-code-style.md` |
  70. | 2 | Дизайн → токены, `theme.json`, шрифты локально, базовый CSS | `references/02-design-system.md` |
  71. | 3 | Типы записей и поля (схема), настройки сайта | `references/04-content-model.md` |
  72. | 4 | Блоки темы и шаблоны; паттерны для редактора | `references/03-blocks-and-editor.md` |
  73. | 5 | Контент из прототипа → `content.json` → `wp <prefix> import` | `references/05-content-pipeline.md` |
  74. | 6 | Многоязычность, строки интерфейса, адреса | `references/06-i18n.md` |
  75. | 7 | SEO и GEO, перенос старого сайта и 301 | `references/07-seo-geo.md` |
  76. | 8 | Скорость и доступность | `references/08-performance-a11y.md` |
  77. | 9 | Формы, заявки, аналитика, cookie | `references/09-forms-analytics.md` |
  78. | 10 | Локальный Docker, CI, деплой, синхронизация | `references/10-ci-cd.md` |
  79. | 11 | Проверки и аудиты | `references/11-qa-audits.md` |
  80. | 12 | Git, ветки, коммиты, документация, передача владельцу | `references/13-workflow.md` |
  81. | — | Есть готовая чужая вёрстка (шаблон, лендинг, экспорт из Figma/конструктора) | `references/14-legacy-markup.md` |
  82. Шаги 2–9 делаются итерациями: блок за блоком, каждый раз — локальный сайт, `npm run check`, коммит.
  83. ## Как пользоваться каркасом
  84. ```bash
  85. node ~/.claude/skills/wp-block-site/scripts/scaffold.js ../new-site \
  86. --slug=studio --name="Studio Pro" --domain=studio.pro
  87. cd ../new-site && git init && npm install && composer install # инструменты проверки и хук перед коммитом
  88. docker compose up -d && docker compose logs -f setup # http://localhost:8080, admin / admin
  89. npm run check
  90. ```
  91. `templates/project/` — рабочий проект с именем-заглушкой `acme` (тема `acme`, плагин `acme-core`,
  92. функции `acme_*`, блоки `acme/*`, классы `acme-*`). Скрипт копирует его и заменяет имена. Без скрипта:
  93. скопировать папку (без `node_modules` и `vendor`) и заменить `acme`/`ACME`/`Acme Site`/`acme.example` поиском по проекту.
  94. `--force` пишет поверх, но не удаляет файлы, которых больше нет в каркасе.
  95. Что внутри каркаса — `references/01-architecture.md`, раздел «Карта файлов».
  96. В архиве скилла для claude.ai папки `templates/project/` нет: там не больше 200 файлов, поэтому каркас упакован в
  97. один файл `templates/project.bundle.json` (`node scripts/bundle-template.js --zip`). `scaffold.js` разворачивает
  98. проект и из папки, и из этого файла — результат одинаковый. Чтобы прочитать файл каркаса, разверните проект во
  99. временную папку.
  100. Каркас проверен (версия 2.0, WordPress 7.1.5, Rank Math 1.0.282, PHP 8.3 и 8.4): развёрнут scaffold-ом и
  101. установлен с нуля в Docker; `npm run check` зелёный, тестов правил — 39 на PHP и 27 на JS; повторный деплой
  102. ничего не меняет. Все типы страниц на двух языках отвечают 200, ровно один H1, 404 и 301 работают; JSON-LD по
  103. типам страниц, карта сайта, robots.txt с ботами ИИ, llms.txt; SEO-гейт проходит и ловит удалённое описание и
  104. второй H1. Обход 360/1280 — 0 проблем; сценарии интерфейса и редактора — PASS; блоков в редакторе — 0
  105. недействительных; журнал PHP пуст. Защита проверена снаружи: заголовки, закрытые xmlrpc и `wp-config.php`, PHP
  106. в uploads не выполняется, `/wp/v2/users` без входа — 401, форма работает. Откат проверен: выкладка темы с
  107. фатальной ошибкой → страницы 500 → автоматический откат → страницы 200. shellcheck и actionlint — без замечаний.
  108. Не проверено: запуск workflow на самом GitHub (SSH, Telegram, ветка отчётов), HSTS на живом https-сайте.
  109. ### Модули: что в каркасе, что описано для реализации по месту
  110. | Модуль | В каркасе | Где описан |
  111. |---|---|---|
  112. | Тема, блоки, общий редактор блоков, шаблоны, паттерн | да | 03 |
  113. | Типы записей, схема полей и панель, настройки, роли страниц | да | 04 |
  114. | Цены-переменные `{{price:key}}` | да | 04 |
  115. | Сборщик контента, импорт, меню, формы | да | 05 |
  116. | Polylang, строки интерфейса, noindex непереведённого | да | 06 |
  117. | Rank Math кодом, JSON-LD, robots, llms.txt, 301 | да | 07 |
  118. | Заявки CF7 + Telegram + антиспам, GTM + Consent Mode, cookie | да | 09 |
  119. | Деплой, CI, синхронизация, Docker | да | 10, 11 |
  120. | QA: обход, сценарии, блоки в редакторе, удобство редактора, SEO-обход | да | 11 |
  121. | `npm run check`: линтеры, пределы размера, граница темы и плагина, тесты, бюджет веса; хук перед коммитом | да | 15, 11 |
  122. | Удобный редактор, CSS по блокам, `acme_image()`, WebP | да | 03, 02, 08 |
  123. | SEO-поля в контенте, Rank Math кодом, LocalBusiness, коды вебмастеров, IndexNow, SEO-гейт | да | 07 |
  124. | Защита: `inc/security.php`, заголовки, запрет PHP в uploads, константы wp-config | да | 10 |
  125. | Ручной деплой, откат, кеш страниц (Cache Enabler), дежурная проверка, ежемесячный SEO-аудит | да | 10, 11 |
  126. | Генератор блока `node wordpress/tools/new-block.js`, сниппеты и задачи VS Code | да | 03, 13 |
  127. | Локально: phpMyAdmin (`--profile tools`), сайт на телефоне по IP + QR (`phone.js`) | да | 10 |
  128. | Перенос старого сайта из WXR (`wp acme legacy`) | нет | 05, 07 |
  129. | Обложки записей (Playwright + генератор в админке) | нет | 04 |
  130. | Статьи пакетом с отложенной публикацией | нет | 05 |
  131. | Перелинковка («Услуга по теме», «Читайте также») | нет | 07 |
  132. | «Обновлено» у статей, история изменений, dateModified | нет | 07 |
  133. | Брендбук, Style Guide, Компоненты | нет | 02 |
  134. Модули «нет» нужны не каждому сайту; эталонная реализация — в репозитории kalaganov5 (`wordpress/kalaganov5-core/inc/`).
  135. ## Как передать комплект
  136. - **Claude Code**: скопировать папку `wp-block-site` в `~/.claude/skills/` (для всех проектов) или в
  137. `.claude/skills/` проекта — скилл подхватится по описанию или вызовом `/wp-block-site`.
  138. - **Другая нейросеть или разработчик**: передать папку целиком и начать с `SKILL.md`; каркас разворачивается
  139. `node scripts/scaffold.js` (нужен Node 22+; для проверок — Composer и Docker).
  140. - **Публичный репозиторий**: https://github.com/kalaganov5/wp-block-site — `git clone` прямо в папку скиллов.
  141. ## Определение «готово» для любой доработки
  142. - `npm run check` зелёный: оформление, пределы размера, PHPCS, граница темы и плагина, тесты, бюджет веса;
  143. сгенерированные файлы пересобраны. Новое бизнес-правило — с тестом.
  144. - CI зелёный: установка с нуля дважды подряд (вторая — без изменений и ошибок), страницы отвечают 200, SEO-гейт пройден.
  145. - В редакторе: запись открывается без шаблона, клик в абзац работает, на холсте ничего не плавает; блоки не
  146. «недействительны» (`editor-usability.js`, `editor-validity.js`).
  147. - На 360 и 1280 px нет горизонтальной прокрутки и ошибок JS; тёмная тема не сломана.
  148. - Тексты интерфейса — через строки (`<prefix>_t`), а не зашиты в разметку; работают на всех языках.
  149. - README обновлён (раздел «где что править»), если поменялось, как владелец работает с сайтом.
  150. - Нет ответа в брифе — вопрос владельцу «вопрос · варианты · влияние · рекомендация», решение — в `docs/decisions.md`.
  151. - Коммит: Conventional Commits, тело — что и почему (см. `references/13-workflow.md`).
  152. ## Чего не делать
  153. - Не править файлы темы и плагина на сервере (SFTP): следующий деплой их перезапишет.
  154. - Не менять шаблоны в «Внешний вид → Редактор»: шаблон из базы перекрывает файл из git.
  155. - Не запускать перезапись контента (`--force`) на боевом после запуска сайта.
  156. - Не класть в репозиторий пароли, ключи, экспорт старого сайта, личные данные.
  157. - Не тянуть шрифты с Google Fonts, не грузить счётчики до согласия, не ставить плагины ради одной функции.
  158. - Не класть образцы текста в `default` атрибутов блока и не ставить H1 в текст или паттерн.
  159. - Не обходить пределы размера комментариями `phpcs:ignore`/`eslint-disable` и не заводить файлы `helpers`/`utils`.
  160. - Не включать принудительный показ шаблона в редакторе для всех записей и не делать липких элементов мимо `.acme-is-sticky`.
  161. - Не делать статические (save) блоки для разметки, которая может меняться: старая разметка в базе станет
  162. «недействительной». Динамический блок перерисовывается сервером всегда.
  163. ## Справочник
  164. - `references/01-architecture.md` — слои, ответственность, карта файлов, имена и префиксы.
  165. - `references/02-design-system.md` — токены, тёмная тема, `theme.json`, шрифты, CSS по блокам.
  166. - `references/03-blocks-and-editor.md` — блоки, общий `editor.js`, серверное превью, стили core-блоков, шаблоны, паттерны, удобный редактор.
  167. - `references/04-content-model.md` — типы записей, схема полей и панель, настройки, роли страниц, переменные в тексте.
  168. - `references/05-content-pipeline.md` — сборщики, `content.json`, импорт, версии контента, обложки, статьи пакетом.
  169. - `references/06-i18n.md` — Polylang, строки интерфейса, адреса на разных языках, непереведённое.
  170. - `references/07-seo-geo.md` — SEO-поля, Rank Math кодом, JSON-LD, llms.txt, robots, canonical, SEO-гейт, перенос и 301.
  171. - `references/08-performance-a11y.md` — что держит PageSpeed 90+ и доступность AA.
  172. - `references/09-forms-analytics.md` — CF7, заявки, Telegram, антиспам, GTM + Consent Mode v2, cookie.
  173. - `references/10-ci-cd.md` — версии, Docker, CI, деплой и откат, защита сервера, окружения и секреты, синхронизация, кеш.
  174. - `references/11-qa-audits.md` — все автоматические проверки и как их читать.
  175. - `references/12-checklists.md` — бриф, чек-листы запуска, приёмки и аудита.
  176. - `references/13-workflow.md` — git-процесс, коммиты, документация, VS Code, работа ИИ-агента в проекте.
  177. - `references/14-legacy-markup.md` — перенос чужой вёрстки: таблица «чужой паттерн → core-блок или блок темы», порядок, пример.
  178. - `references/15-code-style.md` — читаемый код: одна команда проверки, пределы, структура, имена, комментарии, тесты.
  179. - `CHANGELOG.md` — история версий.
  180. - `evals/evals.json` — 13 типовых задач с критериями: проверка, что агент со скиллом следует правилам (прогон — skill-creator или вручную).
README.md · README · 106 lines
  1. # wp-block-site
  2. Скилл для [Claude Code](https://claude.com/claude-code) и готовый каркас проекта: сайт на WordPress с блочной
  3. темой без сборки и плагином данных, где редактор удобен владельцу, код читается за пару минут, SEO настроено
  4. с первого дня, а проверки и деплой делает GitHub Actions.
  5. Подход проверен на живом сайте [kalaganov5.com](https://kalaganov5.com): каждое правило записано вместе с
  6. причиной — обычно это ошибка, на которую уже наступили.
  7. > A Claude Code skill and a project scaffold for WordPress sites built on a block theme (no build step) and a
  8. > data plugin: readable code enforced by linters, Rank Math configured by code, an editor that does not get
  9. > in the way, security headers, and CI/CD over SSH to shared hosting. Docs are in Russian.
  10. ## Что получается
  11. | Часть | Что внутри |
  12. |---|---|
  13. | **Тема** | `theme.json` на токенах дизайна, шаблоны, динамические блоки `block.json` + `render.php` + `style.css`, один `site.js` без зависимостей |
  14. | **Плагин данных** | типы записей и поля без ACF, настройки сайта, импорт контента, SEO, формы и заявки, аналитика с согласием на cookie, безопасность, редиректы, команды `wp <prefix> …` |
  15. | **Читаемый код** | пределы размера (строка 120, функция 40 строк, файл 250, вложенность 3), PHPCS + ESLint + Stylelint + Prettier, словарь имён, тесты бизнес-правил, одна команда `npm run check` |
  16. | **Удобный редактор** | записи открываются без шаблона, H1 правится в поле заголовка, на холсте ничего не плавает, в блоках нет образцов-заглушек; проверка `editor-usability.js` |
  17. | **SEO и GEO** | SEO-поля в исходнике контента с проверкой длины и дублей, Rank Math настроен кодом (версиями), JSON-LD по типам страниц, llms.txt, robots.txt для ботов ИИ, SEO-гейт в CI |
  18. | **Скорость** | шрифты локально, CSS блоков только на страницах с блоком, `acme_image()` с srcset и fetchpriority, WebP при загрузке, бюджет веса CSS/JS в проверке |
  19. | **Безопасность** | заголовки безопасности, закрытые XML-RPC и перечисление пользователей, запрет PHP в uploads, константы wp-config, поиск секретов перед коммитом и в CI |
  20. | **CI/CD** | `npm run check`, установка с нуля в CI на двух версиях PHP, деплой по SSH с бэкапом базы и откатом, ручной деплой без Actions, копия боевого на тестовый, дежурная проверка, ежемесячный SEO-аудит |
  21. ## Установка
  22. Скилл — это папка. Склонируйте репозиторий в папку скиллов Claude Code:
  23. ```bash
  24. # для всех проектов
  25. git clone https://github.com/kalaganov5/wp-block-site ~/.claude/skills/wp-block-site
  26. # или только для одного проекта
  27. git clone https://github.com/kalaganov5/wp-block-site .claude/skills/wp-block-site
  28. ```
  29. Claude подхватит скилл по описанию («сделай сайт на WordPress по макету», «блочная тема», «перенеси сайт»)
  30. или по команде `/wp-block-site`. В claude.ai скилл загружается архивом папки (Settings → Capabilities → Skills).
  31. Без Claude: начните с [`SKILL.md`](SKILL.md) — это методика, а каркас разворачивается одной командой.
  32. ## Быстрый старт: новый сайт
  33. Нужны Node 22+, Docker, Git.
  34. ```bash
  35. node ~/.claude/skills/wp-block-site/scripts/scaffold.js ../studio-site \
  36. --slug=studio --name="Studio Pro" --domain=studio.pro
  37. cd ../studio-site
  38. git init && npm install && composer install # инструменты проверки; хук перед коммитом подключится сам
  39. docker compose up -d && docker compose logs -f setup # http://localhost:8080, admin / admin
  40. npm run check
  41. ```
  42. `--slug` становится папкой темы, плагином `<slug>-core`, префиксом функций, классов, блоков и команд WP-CLI.
  43. После `scaffold.js` — шаги из таблицы «Порядок работы» в [`SKILL.md`](SKILL.md).
  44. ## Как устроено
  45. ```
  46. SKILL.md методика: главные правила, порядок работы, определение «готово»
  47. references/ главы с причинами каждого правила (архитектура, дизайн, блоки, контент, i18n, SEO,
  48. скорость, формы, CI/CD, проверки, чек-листы, процесс, перенос вёрстки, читаемый код)
  49. templates/project/ рабочий проект с именем-заглушкой acme — его копирует scaffold.js
  50. scripts/scaffold.js разворачивает каркас и заменяет имена
  51. evals/evals.json типовые задачи с критериями: проверка, что агент со скиллом следует правилам
  52. ```
  53. Главы:
  54. | Глава | О чём |
  55. |---|---|
  56. | [01](references/01-architecture.md) | Два слоя (тема и плагин данных), карта файлов, имена и префиксы |
  57. | [02](references/02-design-system.md) | Токены, тёмная тема, `theme.json`, шрифты, CSS по блокам |
  58. | [03](references/03-blocks-and-editor.md) | Динамические блоки, общий редактор без сборки, удобный редактор |
  59. | [04](references/04-content-model.md) | Типы записей, схема полей, настройки, роли страниц, цены-переменные |
  60. | [05](references/05-content-pipeline.md) | Контент из прототипа, импорт, версии контента |
  61. | [06](references/06-i18n.md) | Polylang, строки интерфейса, адреса на разных языках |
  62. | [07](references/07-seo-geo.md) | SEO-поля, Rank Math кодом, JSON-LD, llms.txt, SEO-гейт, перенос и 301 |
  63. | [08](references/08-performance-a11y.md) | PageSpeed 90+ и доступность AA |
  64. | [09](references/09-forms-analytics.md) | Contact Form 7, заявки, Telegram, GTM + Consent Mode v2 |
  65. | [10](references/10-ci-cd.md) | Docker, CI, деплой, откат, безопасность сервера, синхронизация |
  66. | [11](references/11-qa-audits.md) | Все автоматические проверки и как их читать |
  67. | [12](references/12-checklists.md) | Бриф, чек-листы запуска, приёмки и аудита |
  68. | [13](references/13-workflow.md) | Git, коммиты, документация, работа ИИ-агента |
  69. | [14](references/14-legacy-markup.md) | Перенос чужой вёрстки в блоки |
  70. | [15](references/15-code-style.md) | Читаемый код: пределы, структура, имена, тесты |
  71. ## Проверки самого скилла
  72. `.github/workflows/scaffold.yml` на каждый push разворачивает каркас, ставит инструменты и запускает
  73. `npm run check` в получившемся проекте. Полная установка с нуля, деплой и SEO-гейт проверяются CI
  74. развёрнутого проекта.
  75. ## Развитие
  76. Скилл дорабатывается по опыту реальных сайтов. Предложения и ошибки — в
  77. [Issues](https://github.com/kalaganov5/wp-block-site/issues); как предложить правку — [CONTRIBUTING.md](CONTRIBUTING.md).
  78. История версий — [CHANGELOG.md](CHANGELOG.md).
  79. ## Лицензия
  80. [GPL-2.0-or-later](LICENSE) — как у WordPress: код темы и плагина из каркаса попадает в сайты на WordPress и
  81. должен быть совместим с его лицензией.
scripts/scaffold.js · Bundled script · 97 lines
  1. #!/usr/bin/env node
  2. /*
  3. * Разворачивает каркас проекта (templates/project) в новую папку и заменяет имя-заглушку acme.
  4. *
  5. * node scaffold.js <папка> --slug=studio --name="Studio Pro" --domain=studio.pro [--force]
  6. *
  7. * --slug латиница и цифры, 2–8 символов, с буквы (короткий префикс — короткие строки кода): папка темы, плагин <slug>-core, префикс функций <slug>_,
  8. * классов <slug>-, блоков <slug>/, команд wp <slug> …, констант <SLUG>_
  9. * --name название сайта (заголовок темы и плагина, подписи в админке)
  10. * --domain боевой домен без https:// (защита деплоя, SEO-аудит, примеры)
  11. *
  12. * Только Node, без зависимостей. Папка должна быть пустой или отсутствовать (--force — писать поверх).
  13. */
  14. const fs = require('fs');
  15. const path = require('path');
  16. const args = process.argv.slice(2);
  17. const opt = Object.fromEntries(args.filter((a) => a.startsWith('--')).map((a) => { const [k, ...v] = a.slice(2).split('='); return [k, v.length ? v.join('=') : true]; }));
  18. const dest = args.find((a) => !a.startsWith('--'));
  19. const fail = (m) => { console.error('Ошибка: ' + m); process.exit(1); };
  20. if (!dest || !opt.slug || !opt.name || !opt.domain) {
  21. fail('нужны <папка> --slug=… --name="…" --domain=…\nПример: node scaffold.js ../studio-site --slug=studio --name="Studio Pro" --domain=studio.pro');
  22. }
  23. const slug = String(opt.slug);
  24. // Не длиннее 8: префикс стоит в каждой функции, классе и блоке; каркас рассчитан на этот запас длины строки (120).
  25. if (!/^[a-z][a-z0-9]{1,7}$/.test(slug)) fail('--slug: латиница в нижнем регистре и цифры, 2–8 символов, с буквы (это ещё и префикс функций PHP)');
  26. if (['wp', 'wordpress', 'core', 'block', 'theme'].includes(slug)) fail('--slug: слишком общее имя, возьмите имя проекта');
  27. if (/['"\\]/.test(String(opt.name))) fail('--name: без кавычек и обратной косой черты (имя попадает в строки PHP и shell)');
  28. const domain = String(opt.domain).replace(/^https?:\/\//, '').replace(/\/.*$/, '');
  29. const SRC = path.join(__dirname, '..', 'templates', 'project');
  30. const DEST = path.resolve(dest);
  31. if (fs.existsSync(DEST) && fs.readdirSync(DEST).length && !opt.force) fail(`папка ${DEST} не пуста (--force — писать поверх)`);
  32. const cap = slug[0].toUpperCase() + slug.slice(1);
  33. // Порядок важен: сначала длинные и составные заглушки, потом само имя.
  34. const swap = (s) => s
  35. .split('Acme Site').join(String(opt.name))
  36. .split('acme.example').join(domain)
  37. .split('ACME').join(slug.toUpperCase())
  38. .split('Acme').join(cap)
  39. .split('acme').join(slug);
  40. const SKIP_DIRS = ['node_modules', 'vendor'];
  41. // Каркас лежит папкой templates/project (репозиторий на GitHub) или одним файлом templates/project.bundle.json
  42. // (архив для claude.ai: там не больше 200 файлов в скилле). Файл собирает scripts/bundle-template.js.
  43. const BUNDLE = path.join(__dirname, '..', 'templates', 'project.bundle.json');
  44. /** Файлы каркаса: [путь от корня проекта, Buffer]. */
  45. function templateFiles() {
  46. if (!fs.existsSync(SRC)) {
  47. if (!fs.existsSync(BUNDLE)) fail('нет ни templates/project, ни templates/project.bundle.json');
  48. const bundle = JSON.parse(fs.readFileSync(BUNDLE, 'utf8'));
  49. return Object.entries(bundle.files).map(([file, base64]) => [file, Buffer.from(base64, 'base64')]);
  50. }
  51. const found = [];
  52. (function walk(dir, prefix) {
  53. for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
  54. // Установленные инструменты (npm install, composer install) в новый проект не копируются.
  55. if (e.isDirectory() && SKIP_DIRS.includes(e.name)) continue;
  56. const relative = prefix ? prefix + '/' + e.name : e.name;
  57. if (e.isDirectory()) walk(path.join(dir, e.name), relative);
  58. else found.push([relative, fs.readFileSync(path.join(dir, e.name))]);
  59. }
  60. })(SRC, '');
  61. return found;
  62. }
  63. let files = 0;
  64. for (const [relative, buf] of templateFiles()) {
  65. const dst = path.join(DEST, ...swap(relative).split('/'));
  66. fs.mkdirSync(path.dirname(dst), { recursive: true });
  67. // Текстовые файлы — с заменой имён; бинарные (картинки, шрифты) — как есть.
  68. const text = !buf.includes(0);
  69. fs.writeFileSync(dst, text ? swap(buf.toString('utf8')) : buf);
  70. if (/.sh$/.test(relative)) fs.chmodSync(dst, 0o755);
  71. files++;
  72. }
  73. console.log(`Готово: ${files} файлов в ${DEST}
  74. Дальше:
  75. cd ${path.relative(process.cwd(), DEST) || '.'}
  76. git init && npm install && composer install # инструменты проверки и хук перед коммитом
  77. npm run format # выровнять код под имя проекта (переносы и отступы)
  78. npm run check && git add -A && git commit -m "chore: project scaffold"
  79. docker compose up -d && docker compose logs -f setup # http://localhost:8080, admin / admin
  80. Настроить под проект (поиск по «${slug}»):
  81. - языки: project/content/site.js (languages, strings), ${slug.toUpperCase()}_LANGS в wordpress/${slug}-core/${slug}-core.php,
  82. EXTRA_LOCALES и LOCALE в wordpress/deploy/remote.sh; один язык — уберите polylang из PLUGINS и адреса /en/ из wordpress/deploy/pages.txt
  83. - дизайн: wordpress/${slug}/assets/css/tokens.css + палитра theme.json, шрифты в assets/fonts
  84. - контент: project/content/site.js → node wordpress/tools/build-content.js
  85. - кто за сайтом (person | company): ${slug.toUpperCase()}_SEO_ENTITY в wordpress/${slug}-core/inc/seo/rank-math.php
  86. - часовой пояс: TIMEZONE в wordpress/deploy/remote.sh
  87. - GitHub: Settings → Environments → test, production + секреты (wordpress/README.md)`);
templates/project/wordpress/deploy/manual.sh · Bundled script · 89 lines
  1. #!/usr/bin/env bash
  2. # Ручной деплой по SSH со своего компьютера — то же, что workflow «Деплой» (deploy.yml), без GitHub Actions.
  3. # Нужен, когда Actions недоступен (не прошла оплата GitHub, сбой сервиса) или сайт надо срочно откатить.
  4. #
  5. # bash wordpress/deploy/manual.sh test # тестовый сайт
  6. # bash wordpress/deploy/manual.sh production # боевой — только из main, с подтверждением
  7. # bash wordpress/deploy/manual.sh production rollback # вернуть предыдущую версию темы и плагина
  8. #
  9. # Ключи — в wordpress/deploy/manual-<test|production>.env (в git не попадает), образец — manual.env.example.
  10. # Порядок как в Actions: проверка ключей → npm run check → deploy.sh (пакет, remote.sh на сервере, проверка
  11. # страниц, откат при неудаче). Файлы уходят одним SSH-подключением: пароль спросят один раз за подключение.
  12. #
  13. # Необязательно (переменные окружения): FORCE_IMPORT=1 — как галочка force_import в Run workflow;
  14. # SKIP_CHECK=1 — не проверять страницы; YES=1 — не спрашивать подтверждение боевого деплоя;
  15. # ACME_ENV_FILE — другой файл ключей; ACME_EXEC — команда вместо ssh для проверки скрипта без сервера
  16. # (например, ACME_EXEC='docker compose exec -T wordpress').
  17. set -euo pipefail
  18. TARGET="${1:-}"
  19. ACTION="${2:-deploy}"
  20. PROD_HOST=acme.example # боевой домен: тестовый деплой не должен на него смотреть
  21. usage() { echo "Использование: bash wordpress/deploy/manual.sh test|production [rollback]" >&2; exit 2; }
  22. [ "$TARGET" = test ] || [ "$TARGET" = production ] || usage
  23. [ "$ACTION" = deploy ] || [ "$ACTION" = rollback ] || usage
  24. ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
  25. cd "$ROOT"
  26. say() { printf '\n=== %s\n' "$*"; }
  27. die() { printf '\nОШИБКА: %s\n' "$*" >&2; exit 1; }
  28. ENV_FILE="${ACME_ENV_FILE:-wordpress/deploy/manual-$TARGET.env}"
  29. [ -f "$ENV_FILE" ] || die "нет файла $ENV_FILE. Скопируйте wordpress/deploy/manual.env.example в $ENV_FILE и заполните."
  30. # Все переменные файла экспортируются: их читает deploy.sh.
  31. set -a
  32. # shellcheck disable=SC1090 # файл ключей у каждого свой
  33. . "$ENV_FILE"
  34. set +a
  35. # ---------- Проверка ключей (как в deploy.yml) ----------
  36. miss=""
  37. for v in DEPLOY_PATH SITE_URL; do [ -n "${!v:-}" ] || miss="$miss $v"; done
  38. [ -n "${ACME_EXEC:-}" ] || for v in SSH_HOST SSH_USER; do [ -n "${!v:-}" ] || miss="$miss $v"; done
  39. [ -z "$miss" ] || die "в $ENV_FILE не заданы:$miss"
  40. SITE_URL="${SITE_URL%/}"
  41. host=$(printf '%s' "$SITE_URL" | sed -E 's#^https?://##; s#/.*##')
  42. if [ "$TARGET" = production ]; then
  43. printf '%s' "$host" | grep -qiE '^dev\.' && die "production: SITE_URL = «$host» — это тестовый адрес."
  44. printf '%s' "$DEPLOY_PATH" | grep -qiE '(^|/)dev\.' && die "production: DEPLOY_PATH указывает на папку тестового сайта."
  45. else
  46. { [ "$host" = "$PROD_HOST" ] || [ "$host" = "www.$PROD_HOST" ]; } && die "тестовый деплой смотрит на боевой адрес $host."
  47. fi
  48. # Откат кода не выкладывает, поэтому ветка и состояние git для него не важны.
  49. if [ "$TARGET" = production ] && [ "$ACTION" = deploy ]; then
  50. [ "$(git rev-parse --abbrev-ref HEAD)" = main ] || die "боевой сайт выкладывается только из ветки main: сначала слейте изменения в main."
  51. git diff --quiet HEAD -- wordpress || die "в папке wordpress есть незакоммиченные изменения — на боевой уходит только то, что в main."
  52. git fetch -q origin main && [ "$(git rev-parse HEAD)" = "$(git rev-parse origin/main)" ] \
  53. || die "локальная main не совпадает с origin/main: сделайте git pull (или git push), чтобы на сайте был тот же код, что в GitHub."
  54. fi
  55. # ---------- Проверки кода: та же команда, что в CI и перед коммитом ----------
  56. if [ "$ACTION" = deploy ]; then
  57. say "Проверка кода (npm run check)"
  58. command -v npm >/dev/null 2>&1 || die "нужен Node.js: проверки кода запускает npm run check"
  59. [ -d node_modules ] || die "не установлены инструменты проверки: выполните npm install и composer install"
  60. npm run --silent check || die "проверки кода не прошли — исправьте и повторите (так же ответил бы CI)"
  61. fi
  62. # ---------- Подтверждение ----------
  63. if [ "$TARGET" = production ] && [ "${YES:-0}" != 1 ]; then
  64. if [ "$ACTION" = rollback ]; then
  65. printf '\nВернуть предыдущую версию темы и плагина на БОЕВОМ сайте %s? Напишите yes: ' "$SITE_URL"
  66. else
  67. printf '\nВыложить %s (коммит %s) на БОЕВОЙ сайт %s? Напишите yes: ' "$(git rev-parse --abbrev-ref HEAD)" "$(git rev-parse --short HEAD)" "$SITE_URL"
  68. fi
  69. read -r answer
  70. [ "$answer" = yes ] || die "отменено"
  71. fi
  72. # ---------- Выкладка или откат: общий с Actions скрипт ----------
  73. if [ -z "${ACME_EXEC:-}" ]; then
  74. # accept-new: отпечаток сервера запоминается при первом подключении, подмена сервера позже — ошибка.
  75. SSH_CMD="ssh -p ${SSH_PORT:-22} -o ServerAliveInterval=30 -o StrictHostKeyChecking=accept-new"
  76. # Путь к ключу — без пробелов (команда передаётся строкой).
  77. [ -n "${SSH_KEY_FILE:-}" ] && SSH_CMD="$SSH_CMD -i ${SSH_KEY_FILE/#\~/$HOME} -o IdentitiesOnly=yes"
  78. export SSH_CMD
  79. fi
  80. export SITE_URL SITE_ENV="$TARGET"
  81. [ "$ACTION" = rollback ] && export ROLLBACK=1
  82. exec bash wordpress/deploy/deploy.sh
templates/project/wordpress/tools/qa/lib/seo-summary.js · Bundled script · 251 lines
  1. /*
  2. * Сводка проблем SEO-обхода в Markdown (summary.md): шапка с итогами и разделы по группам проверок.
  3. * Раздел печатается всегда, даже пустой: по числу в заголовке видно, что проверка выполнена.
  4. * Тексты заголовков и порядок разделов менять нельзя — сводку читают люди и сравнивают между запусками.
  5. *
  6. * Отдельно не запускается — подключается из wordpress/tools/qa/seo-crawl.js.
  7. */
  8. const { normalizeUrl } = require('./seo-http');
  9. const MAX_ITEMS = 60;
  10. const formatUrl = (page) => page.url;
  11. // Раздел сводки: заголовок с числом находок и не больше 60 строк, остаток — одной строкой «… ещё N».
  12. function section(title, items, format) {
  13. const lines = [`\n## ${title} — ${items.length}\n`];
  14. for (const item of items.slice(0, MAX_ITEMS)) lines.push('- ' + format(item));
  15. if (items.length > MAX_ITEMS) lines.push(`- … ещё ${items.length - MAX_ITEMS}`);
  16. return lines;
  17. }
  18. // Страницы с одинаковым значением поля (title, description): пары [значение, список адресов].
  19. function findDuplicates(pages, field) {
  20. // Обычный объект, а не Map: порядок перебора его ключей определяет порядок строк в сводке.
  21. const urlsByValue = {};
  22. for (const page of pages) {
  23. const value = page[field];
  24. if (value) (urlsByValue[value] = urlsByValue[value] || []).push(page.url);
  25. }
  26. return Object.entries(urlsByValue).filter(([, urls]) => urls.length > 1);
  27. }
  28. const jsonLdTypes = (page) => page.jsonld.join(' ');
  29. const isNoindex = (robots) => /noindex/i.test(robots);
  30. // Глубина страницы без языкового префикса (/en/…): 0 — главная.
  31. function pageDepth(page) {
  32. const parts = new URL(page.final).pathname.split('/').filter(Boolean);
  33. return parts.length - (/^[a-z]{2}$/.test(parts[0] || '') ? 1 : 0);
  34. }
  35. const hasForeignCanonical = (page) =>
  36. !page.canonical ||
  37. normalizeUrl(new URL(page.canonical, page.final).href) !== normalizeUrl(page.final);
  38. // Автор-человек: не «admin», не заглушка «?» и не общий узел #author без имени.
  39. const hasHumanAuthor = (page) =>
  40. page.authors.some((author) => !/^(admin|\?)$/i.test(author) && !/#author$/.test(author));
  41. function headerLines(report) {
  42. const { base, site, pages, responding, indexable } = report;
  43. const mirrors = site.mirrors
  44. .map((mirror) => mirror.from + ' → ' + mirror.chain.join(' → '))
  45. .join('; ');
  46. const sitemaps = site.sitemaps.map((sitemap) => sitemap.status + ' ' + sitemap.url).join(', ');
  47. const llmsLinks = site.llms.status === 200 ? ', ссылок: ' + site.llms.links : '';
  48. const blockedBots =
  49. site.aiBots
  50. .filter((entry) => entry.blocked)
  51. .map((entry) => entry.bot)
  52. .join(', ') || 'нет';
  53. return [
  54. `# SEO-обход ${base} — ${site.date}\n`,
  55. `Страниц обойдено: ${pages.length}, в карте сайта: ${site.sitemapCount}, отвечают 200: ${responding.length}, индексируемых: ${indexable.length}.`,
  56. `Зеркала: ${mirrors}`,
  57. `robots.txt: ${site.robots.status}; несуществующая страница: ${site.notFound.status}; карты: ${sitemaps}`,
  58. `GEO: llms.txt — ${site.llms.status}${llmsLinks}; боты ИИ, закрытые в robots.txt: ${blockedBots}.`,
  59. ];
  60. }
  61. function statusSections({ pages, indexable }) {
  62. const formatNot200 = (page) =>
  63. `${page.status} ${page.url}${page.chain.length ? ' (' + page.chain.join(' → ') + ')' : ''}${page.error ? ' ' + page.error : ''}`;
  64. return [
  65. section(
  66. 'Не 200 (ошибки и редиректы внутри сайта)',
  67. pages.filter((page) => page.status !== 200),
  68. formatNot200,
  69. ),
  70. section(
  71. 'В карте сайта, но не 200 или noindex',
  72. pages.filter(
  73. (page) => page.inSitemap && (page.status !== 200 || isNoindex(page.robots || '')),
  74. ),
  75. (page) => `${page.status} ${page.url} ${page.robots || ''}`,
  76. ),
  77. section(
  78. 'Ссылки внутри сайта ведут на редирект',
  79. pages.filter((page) => page.status === 200 && page.chain.length),
  80. (page) => `${page.url} → ${page.final}`,
  81. ),
  82. section(
  83. 'Индексируемые, но нет в карте сайта',
  84. indexable.filter((page) => !page.inSitemap),
  85. formatUrl,
  86. ),
  87. ];
  88. }
  89. function titleSections({ indexable }) {
  90. const isBadDescriptionLength = (page) =>
  91. page.description && (page.description.length < 70 || page.description.length > 170);
  92. return [
  93. section(
  94. 'Без title',
  95. indexable.filter((page) => !page.title),
  96. formatUrl,
  97. ),
  98. section(
  99. 'Title длиннее 60 символов',
  100. indexable.filter((page) => page.title.length > 60),
  101. (page) => `${page.title.length}: ${page.title} — ${page.url}`,
  102. ),
  103. section(
  104. 'Без description',
  105. indexable.filter((page) => !page.description),
  106. formatUrl,
  107. ),
  108. section(
  109. 'Description короче 70 или длиннее 170',
  110. indexable.filter(isBadDescriptionLength),
  111. (page) => `${page.description.length}: ${page.url}`,
  112. ),
  113. section(
  114. 'Одинаковые title',
  115. findDuplicates(indexable, 'title'),
  116. ([value, urls]) => `«${value}»: ${urls.join(', ')}`,
  117. ),
  118. section(
  119. 'Одинаковые description',
  120. findDuplicates(indexable, 'description'),
  121. ([value, urls]) => `«${value.slice(0, 80)}…»: ${urls.join(', ')}`,
  122. ),
  123. ];
  124. }
  125. function markupSections({ responding, indexable }) {
  126. return [
  127. section(
  128. 'H1 не один',
  129. indexable.filter((page) => page.h1.length !== 1),
  130. (page) => `${page.h1.length}: ${page.url} ${page.h1.join(' | ').slice(0, 120)}`,
  131. ),
  132. section(
  133. 'Canonical отсутствует или указывает на другую страницу',
  134. indexable.filter(hasForeignCanonical),
  135. (page) => `${page.url} → ${page.canonical || '—'}`,
  136. ),
  137. section(
  138. 'Нет hreflang',
  139. indexable.filter((page) => !page.hreflang.length),
  140. formatUrl,
  141. ),
  142. section(
  143. 'Нет og:image',
  144. indexable.filter((page) => !page.og.image),
  145. formatUrl,
  146. ),
  147. section(
  148. 'Картинки без alt',
  149. responding.filter((page) => page.imagesNoAlt.length),
  150. (page) => `${page.imagesNoAlt.length}: ${page.url}`,
  151. ),
  152. section(
  153. 'Мало текста (< 250 слов) на индексируемых',
  154. indexable.filter((page) => page.words < 250),
  155. (page) => `${page.words}: ${page.url}`,
  156. ),
  157. section(
  158. 'Без микроразметки JSON-LD',
  159. indexable.filter((page) => !page.jsonld.length),
  160. formatUrl,
  161. ),
  162. ];
  163. }
  164. function geoSections({ indexable }) {
  165. return [
  166. section(
  167. 'GEO: статьи и кейсы без автора-человека в разметке',
  168. indexable.filter(
  169. (page) => /Article|BlogPosting/.test(jsonLdTypes(page)) && !hasHumanAuthor(page),
  170. ),
  171. (page) => `${page.url} (${page.authors.join(', ') || 'нет автора'})`,
  172. ),
  173. section(
  174. 'GEO: внутренние страницы без BreadcrumbList',
  175. indexable.filter((page) => pageDepth(page) > 0 && !/BreadcrumbList/.test(jsonLdTypes(page))),
  176. formatUrl,
  177. ),
  178. section(
  179. 'GEO: блок «Вопросы и ответы» без FAQPage',
  180. indexable.filter((page) => page.faqBlocks && !/FAQPage/.test(jsonLdTypes(page))),
  181. formatUrl,
  182. ),
  183. ];
  184. }
  185. const isLegacyOk = (entry) => entry.chain[0] === 301 && entry.status === 200;
  186. function technicalSections({ base, responding, indexable, legacy }) {
  187. return [
  188. section(
  189. 'Сиротские страницы (нет входящих ссылок, только из карты)',
  190. indexable.filter((page) => page.inlinks === 0 && page.url !== base + '/'),
  191. formatUrl,
  192. ),
  193. section(
  194. 'Медленный ответ сервера (> 800 мс)',
  195. responding.filter((page) => page.ms > 800),
  196. (page) => `${page.ms} мс: ${page.url}`,
  197. ),
  198. section(
  199. 'Без сжатия gzip/br',
  200. responding.filter((page) => !page.headers.encoding),
  201. formatUrl,
  202. ),
  203. section(
  204. 'Старые адреса: не 301 на рабочую страницу',
  205. legacy.filter((entry) => !isLegacyOk(entry)),
  206. (entry) => `${entry.from}: ${entry.chain.join(' → ')} → ${entry.final} (${entry.status})`,
  207. ),
  208. ];
  209. }
  210. /**
  211. * Строки сводки. data: { base, site, pages, legacy }.
  212. * Возвращает массив строк: первые пять — шапка, дальше разделы (заголовок раздела — один элемент).
  213. */
  214. function buildSummaryLines(data) {
  215. const responding = data.pages.filter((page) => page.status === 200 && page.title !== undefined);
  216. // Адрес с редиректом (/pricing/ → /en/pricing/) — не отдельная страница: её title и canonical принадлежат конечной.
  217. const indexable = responding.filter(
  218. (page) => !page.chain.length && !isNoindex(page.robots + ' ' + page.xRobots),
  219. );
  220. const report = { ...data, responding, indexable };
  221. const sections = [
  222. ...statusSections(report),
  223. ...titleSections(report),
  224. ...markupSections(report),
  225. ...geoSections(report),
  226. ...technicalSections(report),
  227. ];
  228. const legacyOkCount = data.legacy.filter(isLegacyOk).length;
  229. return [
  230. ...headerLines(report),
  231. ...sections.flat(),
  232. `\nСтарые адреса проверено: ${data.legacy.length}, правильно: ${legacyOkCount}.`,
  233. ];
  234. }
  235. module.exports = { buildSummaryLines };

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.