wp-block-site
Методика и каркас сайта на 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.
Badge for your README
Markdown
[](/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
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
- ---
- name: wp-block-site
- description: >-
- Методика и каркас сайта на 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.
- ---
- # Сайт на WordPress: блочная тема + плагин данных + автоматизация
- Версия 2.0 (история — `CHANGELOG.md`). Комплект описывает подход, на котором сделан kalaganov5.com, и даёт
- каркас, чтобы повторить его на любом проекте. Всё ниже — правила, проверенные на живом сайте; причина каждого
- правила записана в `references/`.
- ## Что получается на выходе
- - **Тема** `wordpress/<slug>/` — блочная тема без сборки: `theme.json`, шаблоны `templates/*.html`,
- динамические блоки `blocks/<имя>/{block.json,render.php,style.css}`, стили на CSS-переменных, один `site.js`.
- - **Плагин данных** `wordpress/<slug>-core/` — типы записей и поля, настройки сайта, импорт контента,
- SEO, формы, аналитика, безопасность, редиректы, команды `wp <prefix> …`. Тема вызывает только его публичный
- интерфейс `inc/api.php` и работает без плагина (пустые блоки, не ошибки).
- - **Деплой** `wordpress/deploy/remote.sh` — один повторяемый скрипт: ставит сайт с нуля или обновляет
- тему и плагин. Его же запускают CI, локальный Docker, тестовый и боевой сервер.
- - **Проверки** — одна команда `npm run check`: синтаксис, оформление, пределы размера, безопасность PHP,
- граница темы и плагина, тесты бизнес-правил, бюджет веса. Её запускают хук перед коммитом, CI и ручной деплой.
- - **GitHub Actions** — `ci.yml` (`npm run check` + установка с нуля + SEO-гейт), `deploy.yml` (test/production по
- SSH, откат при сбое), `sync.yml` (копия боевого на тестовый), `health.yml` (дежурная проверка),
- `seo-audit.yml` (обход сайта + Lighthouse → ветка отчётов, раз в месяц).
- - **Сборщики** `wordpress/tools/` — контент из прототипа в разметку Gutenberg, обложки, QA-скрипты.
- - **Документация** — `wordpress/README.md` (для владельца сайта и разработчика), `CLAUDE.md` (для ИИ-агента), `TODO.md`,
- `docs/glossary.md` (словарь имён), `docs/decisions.md` (принятые решения).
- ## Главные правила (не нарушать)
- 1. **Код — только через git, контент — только в админке боевого сайта.** Деплой обновляет файлы темы и
- плагина и не трогает записи, меню, настройки. Копия данных идёт только боевой → тестовый.
- 2. **Редактор удобен владельцу.** Запись открывается без шаблона: поле заголовка (это H1) и текст, клик в любой
- абзац работает. На холсте те же стили, что на сайте, но ничто не плавает и не прилипает; шаблон — по кнопке
- «Показать шаблон». В блоках нет образцов-заглушек: пустой блок — подсказка в редакторе и пустота на сайте.
- 3. **Блоки темы — динамические, без сборки.** `block.json` + `render.php` + `style.css` в папке блока; панель
- настроек строит один общий `editor.js` из атрибутов `block.json`. Тексты страниц — core-блоки (абзац,
- заголовок, список, кнопки) со стилями дизайн-системы (`is-style-*`). Один H1 на странице — из шаблона.
- 4. **Один источник дизайна.** Цвета, шрифты, отступы — `assets/css/tokens.css` (светлая и тёмная тема);
- палитра `theme.json` совпадает с ним; свои цвета и размеры в редакторе выключены.
- 5. **Поля записей — без ACF.** Схема полей в PHP → `register_post_meta(show_in_rest)` → панель в
- редакторе строится по схеме.
- 6. **Всё повторяемо и идемпотентно.** Импорт, деплой, команды `wp <prefix> …` создают только то, чего
- нет; «перезаписать» — только явным флагом `--force`. Настройки сторонних плагинов ставятся «один раз на
- версию»: дальше главная — админка.
- 7. **Сгенерированное коммитится и сверяется в CI.** Если файл собирается скриптом, руками его не правят.
- 8. **Тестовый сайт закрыт от поисковиков и счётчиков; боевой открыт.** Это решает окружение, а не человек.
- 9. **Минимум плагинов.** Polylang (если языков больше одного), Contact Form 7, Rank Math, кеш страниц.
- Слайдеры, меню, cookie, калькуляторы — в теме. Никаких конструкторов страниц.
- 10. **Каждое правило — с причиной в комментарии.** Код и документы пишутся так, чтобы следующий
- разработчик (или ИИ) понял, почему сделано именно так.
- 11. **Код читается за пару минут, и это проверяет машина.** Строка ≤ 120, функция ≤ 40 строк, файл ≤ 250,
- вложенность ≤ 3; один файл — одна задача; говорящие имена по словарю; бизнес-правило — чистая функция с
- тестом. `npm run check` красный — изменение не принимается (`references/15-code-style.md`).
- 12. **SEO — с брифа, а не в конце.** У каждой страницы запрос, адрес, title и description в исходнике контента;
- сборщик не пропускает пустые, длинные и повторяющиеся поля; Rank Math настраивается кодом; SEO-гейт в CI
- не даёт слить страницу без title или с двумя H1.
- 13. **Безопасно по умолчанию.** Заголовки безопасности, закрытые XML-RPC и перечисление пользователей, запрет
- PHP в uploads, правка файлов из админки выключена, секреты не попадают в git (поиск перед коммитом и в CI),
- деплой делает бэкап базы и откатывает файлы, если сайт после выкладки не открылся.
- ## Порядок работы над новым проектом
- | Шаг | Что делаем | Читать |
- |---|---|---|
- | 0 | Бриф: страницы, запросы и SEO-поля, типы контента, языки, формы, интеграции, хостинг, домены test/prod | `references/12-checklists.md` (бриф), `07-seo-geo.md` |
- | 1 | Каркас: `node scripts/scaffold.js <папка> --slug=… --name="…" --domain=…`, затем `npm install && composer install` | `references/01-architecture.md`, `15-code-style.md` |
- | 2 | Дизайн → токены, `theme.json`, шрифты локально, базовый CSS | `references/02-design-system.md` |
- | 3 | Типы записей и поля (схема), настройки сайта | `references/04-content-model.md` |
- | 4 | Блоки темы и шаблоны; паттерны для редактора | `references/03-blocks-and-editor.md` |
- | 5 | Контент из прототипа → `content.json` → `wp <prefix> import` | `references/05-content-pipeline.md` |
- | 6 | Многоязычность, строки интерфейса, адреса | `references/06-i18n.md` |
- | 7 | SEO и GEO, перенос старого сайта и 301 | `references/07-seo-geo.md` |
- | 8 | Скорость и доступность | `references/08-performance-a11y.md` |
- | 9 | Формы, заявки, аналитика, cookie | `references/09-forms-analytics.md` |
- | 10 | Локальный Docker, CI, деплой, синхронизация | `references/10-ci-cd.md` |
- | 11 | Проверки и аудиты | `references/11-qa-audits.md` |
- | 12 | Git, ветки, коммиты, документация, передача владельцу | `references/13-workflow.md` |
- | — | Есть готовая чужая вёрстка (шаблон, лендинг, экспорт из Figma/конструктора) | `references/14-legacy-markup.md` |
- Шаги 2–9 делаются итерациями: блок за блоком, каждый раз — локальный сайт, `npm run check`, коммит.
- ## Как пользоваться каркасом
- ```bash
- node ~/.claude/skills/wp-block-site/scripts/scaffold.js ../new-site \
- --slug=studio --name="Studio Pro" --domain=studio.pro
- cd ../new-site && git init && npm install && composer install # инструменты проверки и хук перед коммитом
- docker compose up -d && docker compose logs -f setup # http://localhost:8080, admin / admin
- npm run check
- ```
- `templates/project/` — рабочий проект с именем-заглушкой `acme` (тема `acme`, плагин `acme-core`,
- функции `acme_*`, блоки `acme/*`, классы `acme-*`). Скрипт копирует его и заменяет имена. Без скрипта:
- скопировать папку (без `node_modules` и `vendor`) и заменить `acme`/`ACME`/`Acme Site`/`acme.example` поиском по проекту.
- `--force` пишет поверх, но не удаляет файлы, которых больше нет в каркасе.
- Что внутри каркаса — `references/01-architecture.md`, раздел «Карта файлов».
- В архиве скилла для claude.ai папки `templates/project/` нет: там не больше 200 файлов, поэтому каркас упакован в
- один файл `templates/project.bundle.json` (`node scripts/bundle-template.js --zip`). `scaffold.js` разворачивает
- проект и из папки, и из этого файла — результат одинаковый. Чтобы прочитать файл каркаса, разверните проект во
- временную папку.
- Каркас проверен (версия 2.0, WordPress 7.1.5, Rank Math 1.0.282, PHP 8.3 и 8.4): развёрнут scaffold-ом и
- установлен с нуля в Docker; `npm run check` зелёный, тестов правил — 39 на PHP и 27 на JS; повторный деплой
- ничего не меняет. Все типы страниц на двух языках отвечают 200, ровно один H1, 404 и 301 работают; JSON-LD по
- типам страниц, карта сайта, robots.txt с ботами ИИ, llms.txt; SEO-гейт проходит и ловит удалённое описание и
- второй H1. Обход 360/1280 — 0 проблем; сценарии интерфейса и редактора — PASS; блоков в редакторе — 0
- недействительных; журнал PHP пуст. Защита проверена снаружи: заголовки, закрытые xmlrpc и `wp-config.php`, PHP
- в uploads не выполняется, `/wp/v2/users` без входа — 401, форма работает. Откат проверен: выкладка темы с
- фатальной ошибкой → страницы 500 → автоматический откат → страницы 200. shellcheck и actionlint — без замечаний.
- Не проверено: запуск workflow на самом GitHub (SSH, Telegram, ветка отчётов), HSTS на живом https-сайте.
- ### Модули: что в каркасе, что описано для реализации по месту
- | Модуль | В каркасе | Где описан |
- |---|---|---|
- | Тема, блоки, общий редактор блоков, шаблоны, паттерн | да | 03 |
- | Типы записей, схема полей и панель, настройки, роли страниц | да | 04 |
- | Цены-переменные `{{price:key}}` | да | 04 |
- | Сборщик контента, импорт, меню, формы | да | 05 |
- | Polylang, строки интерфейса, noindex непереведённого | да | 06 |
- | Rank Math кодом, JSON-LD, robots, llms.txt, 301 | да | 07 |
- | Заявки CF7 + Telegram + антиспам, GTM + Consent Mode, cookie | да | 09 |
- | Деплой, CI, синхронизация, Docker | да | 10, 11 |
- | QA: обход, сценарии, блоки в редакторе, удобство редактора, SEO-обход | да | 11 |
- | `npm run check`: линтеры, пределы размера, граница темы и плагина, тесты, бюджет веса; хук перед коммитом | да | 15, 11 |
- | Удобный редактор, CSS по блокам, `acme_image()`, WebP | да | 03, 02, 08 |
- | SEO-поля в контенте, Rank Math кодом, LocalBusiness, коды вебмастеров, IndexNow, SEO-гейт | да | 07 |
- | Защита: `inc/security.php`, заголовки, запрет PHP в uploads, константы wp-config | да | 10 |
- | Ручной деплой, откат, кеш страниц (Cache Enabler), дежурная проверка, ежемесячный SEO-аудит | да | 10, 11 |
- | Генератор блока `node wordpress/tools/new-block.js`, сниппеты и задачи VS Code | да | 03, 13 |
- | Локально: phpMyAdmin (`--profile tools`), сайт на телефоне по IP + QR (`phone.js`) | да | 10 |
- | Перенос старого сайта из WXR (`wp acme legacy`) | нет | 05, 07 |
- | Обложки записей (Playwright + генератор в админке) | нет | 04 |
- | Статьи пакетом с отложенной публикацией | нет | 05 |
- | Перелинковка («Услуга по теме», «Читайте также») | нет | 07 |
- | «Обновлено» у статей, история изменений, dateModified | нет | 07 |
- | Брендбук, Style Guide, Компоненты | нет | 02 |
- Модули «нет» нужны не каждому сайту; эталонная реализация — в репозитории kalaganov5 (`wordpress/kalaganov5-core/inc/`).
- ## Как передать комплект
- - **Claude Code**: скопировать папку `wp-block-site` в `~/.claude/skills/` (для всех проектов) или в
- `.claude/skills/` проекта — скилл подхватится по описанию или вызовом `/wp-block-site`.
- - **Другая нейросеть или разработчик**: передать папку целиком и начать с `SKILL.md`; каркас разворачивается
- `node scripts/scaffold.js` (нужен Node 22+; для проверок — Composer и Docker).
- - **Публичный репозиторий**: https://github.com/kalaganov5/wp-block-site — `git clone` прямо в папку скиллов.
- ## Определение «готово» для любой доработки
- - `npm run check` зелёный: оформление, пределы размера, PHPCS, граница темы и плагина, тесты, бюджет веса;
- сгенерированные файлы пересобраны. Новое бизнес-правило — с тестом.
- - CI зелёный: установка с нуля дважды подряд (вторая — без изменений и ошибок), страницы отвечают 200, SEO-гейт пройден.
- - В редакторе: запись открывается без шаблона, клик в абзац работает, на холсте ничего не плавает; блоки не
- «недействительны» (`editor-usability.js`, `editor-validity.js`).
- - На 360 и 1280 px нет горизонтальной прокрутки и ошибок JS; тёмная тема не сломана.
- - Тексты интерфейса — через строки (`<prefix>_t`), а не зашиты в разметку; работают на всех языках.
- - README обновлён (раздел «где что править»), если поменялось, как владелец работает с сайтом.
- - Нет ответа в брифе — вопрос владельцу «вопрос · варианты · влияние · рекомендация», решение — в `docs/decisions.md`.
- - Коммит: Conventional Commits, тело — что и почему (см. `references/13-workflow.md`).
- ## Чего не делать
- - Не править файлы темы и плагина на сервере (SFTP): следующий деплой их перезапишет.
- - Не менять шаблоны в «Внешний вид → Редактор»: шаблон из базы перекрывает файл из git.
- - Не запускать перезапись контента (`--force`) на боевом после запуска сайта.
- - Не класть в репозиторий пароли, ключи, экспорт старого сайта, личные данные.
- - Не тянуть шрифты с Google Fonts, не грузить счётчики до согласия, не ставить плагины ради одной функции.
- - Не класть образцы текста в `default` атрибутов блока и не ставить H1 в текст или паттерн.
- - Не обходить пределы размера комментариями `phpcs:ignore`/`eslint-disable` и не заводить файлы `helpers`/`utils`.
- - Не включать принудительный показ шаблона в редакторе для всех записей и не делать липких элементов мимо `.acme-is-sticky`.
- - Не делать статические (save) блоки для разметки, которая может меняться: старая разметка в базе станет
- «недействительной». Динамический блок перерисовывается сервером всегда.
- ## Справочник
- - `references/01-architecture.md` — слои, ответственность, карта файлов, имена и префиксы.
- - `references/02-design-system.md` — токены, тёмная тема, `theme.json`, шрифты, CSS по блокам.
- - `references/03-blocks-and-editor.md` — блоки, общий `editor.js`, серверное превью, стили core-блоков, шаблоны, паттерны, удобный редактор.
- - `references/04-content-model.md` — типы записей, схема полей и панель, настройки, роли страниц, переменные в тексте.
- - `references/05-content-pipeline.md` — сборщики, `content.json`, импорт, версии контента, обложки, статьи пакетом.
- - `references/06-i18n.md` — Polylang, строки интерфейса, адреса на разных языках, непереведённое.
- - `references/07-seo-geo.md` — SEO-поля, Rank Math кодом, JSON-LD, llms.txt, robots, canonical, SEO-гейт, перенос и 301.
- - `references/08-performance-a11y.md` — что держит PageSpeed 90+ и доступность AA.
- - `references/09-forms-analytics.md` — CF7, заявки, Telegram, антиспам, GTM + Consent Mode v2, cookie.
- - `references/10-ci-cd.md` — версии, Docker, CI, деплой и откат, защита сервера, окружения и секреты, синхронизация, кеш.
- - `references/11-qa-audits.md` — все автоматические проверки и как их читать.
- - `references/12-checklists.md` — бриф, чек-листы запуска, приёмки и аудита.
- - `references/13-workflow.md` — git-процесс, коммиты, документация, VS Code, работа ИИ-агента в проекте.
- - `references/14-legacy-markup.md` — перенос чужой вёрстки: таблица «чужой паттерн → core-блок или блок темы», порядок, пример.
- - `references/15-code-style.md` — читаемый код: одна команда проверки, пределы, структура, имена, комментарии, тесты.
- - `CHANGELOG.md` — история версий.
- - `evals/evals.json` — 13 типовых задач с критериями: проверка, что агент со скиллом следует правилам (прогон — skill-creator или вручную).
README.md · README · 106 lines
- # wp-block-site
- Скилл для [Claude Code](https://claude.com/claude-code) и готовый каркас проекта: сайт на WordPress с блочной
- темой без сборки и плагином данных, где редактор удобен владельцу, код читается за пару минут, SEO настроено
- с первого дня, а проверки и деплой делает GitHub Actions.
- Подход проверен на живом сайте [kalaganov5.com](https://kalaganov5.com): каждое правило записано вместе с
- причиной — обычно это ошибка, на которую уже наступили.
- > A Claude Code skill and a project scaffold for WordPress sites built on a block theme (no build step) and a
- > data plugin: readable code enforced by linters, Rank Math configured by code, an editor that does not get
- > in the way, security headers, and CI/CD over SSH to shared hosting. Docs are in Russian.
- ## Что получается
- | Часть | Что внутри |
- |---|---|
- | **Тема** | `theme.json` на токенах дизайна, шаблоны, динамические блоки `block.json` + `render.php` + `style.css`, один `site.js` без зависимостей |
- | **Плагин данных** | типы записей и поля без ACF, настройки сайта, импорт контента, SEO, формы и заявки, аналитика с согласием на cookie, безопасность, редиректы, команды `wp <prefix> …` |
- | **Читаемый код** | пределы размера (строка 120, функция 40 строк, файл 250, вложенность 3), PHPCS + ESLint + Stylelint + Prettier, словарь имён, тесты бизнес-правил, одна команда `npm run check` |
- | **Удобный редактор** | записи открываются без шаблона, H1 правится в поле заголовка, на холсте ничего не плавает, в блоках нет образцов-заглушек; проверка `editor-usability.js` |
- | **SEO и GEO** | SEO-поля в исходнике контента с проверкой длины и дублей, Rank Math настроен кодом (версиями), JSON-LD по типам страниц, llms.txt, robots.txt для ботов ИИ, SEO-гейт в CI |
- | **Скорость** | шрифты локально, CSS блоков только на страницах с блоком, `acme_image()` с srcset и fetchpriority, WebP при загрузке, бюджет веса CSS/JS в проверке |
- | **Безопасность** | заголовки безопасности, закрытые XML-RPC и перечисление пользователей, запрет PHP в uploads, константы wp-config, поиск секретов перед коммитом и в CI |
- | **CI/CD** | `npm run check`, установка с нуля в CI на двух версиях PHP, деплой по SSH с бэкапом базы и откатом, ручной деплой без Actions, копия боевого на тестовый, дежурная проверка, ежемесячный SEO-аудит |
- ## Установка
- Скилл — это папка. Склонируйте репозиторий в папку скиллов Claude Code:
- ```bash
- # для всех проектов
- 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) — это методика, а каркас разворачивается одной командой.
- ## Быстрый старт: новый сайт
- Нужны Node 22+, Docker, Git.
- ```bash
- node ~/.claude/skills/wp-block-site/scripts/scaffold.js ../studio-site \
- --slug=studio --name="Studio Pro" --domain=studio.pro
- cd ../studio-site
- git init && npm install && composer install # инструменты проверки; хук перед коммитом подключится сам
- docker compose up -d && docker compose logs -f setup # http://localhost:8080, admin / admin
- npm run check
- ```
- `--slug` становится папкой темы, плагином `<slug>-core`, префиксом функций, классов, блоков и команд WP-CLI.
- После `scaffold.js` — шаги из таблицы «Порядок работы» в [`SKILL.md`](SKILL.md).
- ## Как устроено
- ```
- SKILL.md методика: главные правила, порядок работы, определение «готово»
- references/ главы с причинами каждого правила (архитектура, дизайн, блоки, контент, i18n, SEO,
- скорость, формы, CI/CD, проверки, чек-листы, процесс, перенос вёрстки, читаемый код)
- templates/project/ рабочий проект с именем-заглушкой acme — его копирует scaffold.js
- scripts/scaffold.js разворачивает каркас и заменяет имена
- evals/evals.json типовые задачи с критериями: проверка, что агент со скиллом следует правилам
- ```
- Главы:
- | Глава | О чём |
- |---|---|
- | [01](references/01-architecture.md) | Два слоя (тема и плагин данных), карта файлов, имена и префиксы |
- | [02](references/02-design-system.md) | Токены, тёмная тема, `theme.json`, шрифты, CSS по блокам |
- | [03](references/03-blocks-and-editor.md) | Динамические блоки, общий редактор без сборки, удобный редактор |
- | [04](references/04-content-model.md) | Типы записей, схема полей, настройки, роли страниц, цены-переменные |
- | [05](references/05-content-pipeline.md) | Контент из прототипа, импорт, версии контента |
- | [06](references/06-i18n.md) | Polylang, строки интерфейса, адреса на разных языках |
- | [07](references/07-seo-geo.md) | SEO-поля, Rank Math кодом, JSON-LD, llms.txt, SEO-гейт, перенос и 301 |
- | [08](references/08-performance-a11y.md) | PageSpeed 90+ и доступность AA |
- | [09](references/09-forms-analytics.md) | Contact Form 7, заявки, Telegram, GTM + Consent Mode v2 |
- | [10](references/10-ci-cd.md) | Docker, CI, деплой, откат, безопасность сервера, синхронизация |
- | [11](references/11-qa-audits.md) | Все автоматические проверки и как их читать |
- | [12](references/12-checklists.md) | Бриф, чек-листы запуска, приёмки и аудита |
- | [13](references/13-workflow.md) | Git, коммиты, документация, работа ИИ-агента |
- | [14](references/14-legacy-markup.md) | Перенос чужой вёрстки в блоки |
- | [15](references/15-code-style.md) | Читаемый код: пределы, структура, имена, тесты |
- ## Проверки самого скилла
- `.github/workflows/scaffold.yml` на каждый push разворачивает каркас, ставит инструменты и запускает
- `npm run check` в получившемся проекте. Полная установка с нуля, деплой и SEO-гейт проверяются CI
- развёрнутого проекта.
- ## Развитие
- Скилл дорабатывается по опыту реальных сайтов. Предложения и ошибки — в
- [Issues](https://github.com/kalaganov5/wp-block-site/issues); как предложить правку — [CONTRIBUTING.md](CONTRIBUTING.md).
- История версий — [CHANGELOG.md](CHANGELOG.md).
- ## Лицензия
- [GPL-2.0-or-later](LICENSE) — как у WordPress: код темы и плагина из каркаса попадает в сайты на WordPress и
- должен быть совместим с его лицензией.
scripts/scaffold.js · Bundled script · 97 lines
- #!/usr/bin/env node
- /*
- * Разворачивает каркас проекта (templates/project) в новую папку и заменяет имя-заглушку acme.
- *
- * node scaffold.js <папка> --slug=studio --name="Studio Pro" --domain=studio.pro [--force]
- *
- * --slug латиница и цифры, 2–8 символов, с буквы (короткий префикс — короткие строки кода): папка темы, плагин <slug>-core, префикс функций <slug>_,
- * классов <slug>-, блоков <slug>/, команд wp <slug> …, констант <SLUG>_
- * --name название сайта (заголовок темы и плагина, подписи в админке)
- * --domain боевой домен без https:// (защита деплоя, SEO-аудит, примеры)
- *
- * Только Node, без зависимостей. Папка должна быть пустой или отсутствовать (--force — писать поверх).
- */
- const fs = require('fs');
- const path = require('path');
- const args = process.argv.slice(2);
- 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]; }));
- const dest = args.find((a) => !a.startsWith('--'));
- const fail = (m) => { console.error('Ошибка: ' + m); process.exit(1); };
- if (!dest || !opt.slug || !opt.name || !opt.domain) {
- fail('нужны <папка> --slug=… --name="…" --domain=…\nПример: node scaffold.js ../studio-site --slug=studio --name="Studio Pro" --domain=studio.pro');
- }
- const slug = String(opt.slug);
- // Не длиннее 8: префикс стоит в каждой функции, классе и блоке; каркас рассчитан на этот запас длины строки (120).
- if (!/^[a-z][a-z0-9]{1,7}$/.test(slug)) fail('--slug: латиница в нижнем регистре и цифры, 2–8 символов, с буквы (это ещё и префикс функций PHP)');
- if (['wp', 'wordpress', 'core', 'block', 'theme'].includes(slug)) fail('--slug: слишком общее имя, возьмите имя проекта');
- if (/['"\\]/.test(String(opt.name))) fail('--name: без кавычек и обратной косой черты (имя попадает в строки PHP и shell)');
- const domain = String(opt.domain).replace(/^https?:\/\//, '').replace(/\/.*$/, '');
- const SRC = path.join(__dirname, '..', 'templates', 'project');
- const DEST = path.resolve(dest);
- if (fs.existsSync(DEST) && fs.readdirSync(DEST).length && !opt.force) fail(`папка ${DEST} не пуста (--force — писать поверх)`);
- const cap = slug[0].toUpperCase() + slug.slice(1);
- // Порядок важен: сначала длинные и составные заглушки, потом само имя.
- const swap = (s) => s
- .split('Acme Site').join(String(opt.name))
- .split('acme.example').join(domain)
- .split('ACME').join(slug.toUpperCase())
- .split('Acme').join(cap)
- .split('acme').join(slug);
- const SKIP_DIRS = ['node_modules', 'vendor'];
- // Каркас лежит папкой templates/project (репозиторий на GitHub) или одним файлом templates/project.bundle.json
- // (архив для claude.ai: там не больше 200 файлов в скилле). Файл собирает scripts/bundle-template.js.
- const BUNDLE = path.join(__dirname, '..', 'templates', 'project.bundle.json');
- /** Файлы каркаса: [путь от корня проекта, Buffer]. */
- function templateFiles() {
- if (!fs.existsSync(SRC)) {
- if (!fs.existsSync(BUNDLE)) fail('нет ни templates/project, ни templates/project.bundle.json');
- const bundle = JSON.parse(fs.readFileSync(BUNDLE, 'utf8'));
- return Object.entries(bundle.files).map(([file, base64]) => [file, Buffer.from(base64, 'base64')]);
- }
- const found = [];
- (function walk(dir, prefix) {
- for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
- // Установленные инструменты (npm install, composer install) в новый проект не копируются.
- if (e.isDirectory() && SKIP_DIRS.includes(e.name)) continue;
- const relative = prefix ? prefix + '/' + e.name : e.name;
- if (e.isDirectory()) walk(path.join(dir, e.name), relative);
- else found.push([relative, fs.readFileSync(path.join(dir, e.name))]);
- }
- })(SRC, '');
- return found;
- }
- let files = 0;
- for (const [relative, buf] of templateFiles()) {
- const dst = path.join(DEST, ...swap(relative).split('/'));
- fs.mkdirSync(path.dirname(dst), { recursive: true });
- // Текстовые файлы — с заменой имён; бинарные (картинки, шрифты) — как есть.
- const text = !buf.includes(0);
- fs.writeFileSync(dst, text ? swap(buf.toString('utf8')) : buf);
- if (/.sh$/.test(relative)) fs.chmodSync(dst, 0o755);
- files++;
- }
- console.log(`Готово: ${files} файлов в ${DEST}
- Дальше:
- cd ${path.relative(process.cwd(), DEST) || '.'}
- git init && npm install && composer install # инструменты проверки и хук перед коммитом
- npm run format # выровнять код под имя проекта (переносы и отступы)
- npm run check && git add -A && git commit -m "chore: project scaffold"
- docker compose up -d && docker compose logs -f setup # http://localhost:8080, admin / admin
- Настроить под проект (поиск по «${slug}»):
- - языки: project/content/site.js (languages, strings), ${slug.toUpperCase()}_LANGS в wordpress/${slug}-core/${slug}-core.php,
- EXTRA_LOCALES и LOCALE в wordpress/deploy/remote.sh; один язык — уберите polylang из PLUGINS и адреса /en/ из wordpress/deploy/pages.txt
- - дизайн: wordpress/${slug}/assets/css/tokens.css + палитра theme.json, шрифты в assets/fonts
- - контент: project/content/site.js → node wordpress/tools/build-content.js
- - кто за сайтом (person | company): ${slug.toUpperCase()}_SEO_ENTITY в wordpress/${slug}-core/inc/seo/rank-math.php
- - часовой пояс: TIMEZONE в wordpress/deploy/remote.sh
- - GitHub: Settings → Environments → test, production + секреты (wordpress/README.md)`);
templates/project/wordpress/deploy/manual.sh · Bundled script · 89 lines
- #!/usr/bin/env bash
- # Ручной деплой по SSH со своего компьютера — то же, что workflow «Деплой» (deploy.yml), без GitHub Actions.
- # Нужен, когда Actions недоступен (не прошла оплата GitHub, сбой сервиса) или сайт надо срочно откатить.
- #
- # bash wordpress/deploy/manual.sh test # тестовый сайт
- # bash wordpress/deploy/manual.sh production # боевой — только из main, с подтверждением
- # bash wordpress/deploy/manual.sh production rollback # вернуть предыдущую версию темы и плагина
- #
- # Ключи — в wordpress/deploy/manual-<test|production>.env (в git не попадает), образец — manual.env.example.
- # Порядок как в Actions: проверка ключей → npm run check → deploy.sh (пакет, remote.sh на сервере, проверка
- # страниц, откат при неудаче). Файлы уходят одним SSH-подключением: пароль спросят один раз за подключение.
- #
- # Необязательно (переменные окружения): FORCE_IMPORT=1 — как галочка force_import в Run workflow;
- # SKIP_CHECK=1 — не проверять страницы; YES=1 — не спрашивать подтверждение боевого деплоя;
- # ACME_ENV_FILE — другой файл ключей; ACME_EXEC — команда вместо ssh для проверки скрипта без сервера
- # (например, ACME_EXEC='docker compose exec -T wordpress').
- set -euo pipefail
- TARGET="${1:-}"
- ACTION="${2:-deploy}"
- PROD_HOST=acme.example # боевой домен: тестовый деплой не должен на него смотреть
- usage() { echo "Использование: bash wordpress/deploy/manual.sh test|production [rollback]" >&2; exit 2; }
- [ "$TARGET" = test ] || [ "$TARGET" = production ] || usage
- [ "$ACTION" = deploy ] || [ "$ACTION" = rollback ] || usage
- ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
- cd "$ROOT"
- say() { printf '\n=== %s\n' "$*"; }
- die() { printf '\nОШИБКА: %s\n' "$*" >&2; exit 1; }
- ENV_FILE="${ACME_ENV_FILE:-wordpress/deploy/manual-$TARGET.env}"
- [ -f "$ENV_FILE" ] || die "нет файла $ENV_FILE. Скопируйте wordpress/deploy/manual.env.example в $ENV_FILE и заполните."
- # Все переменные файла экспортируются: их читает deploy.sh.
- set -a
- # shellcheck disable=SC1090 # файл ключей у каждого свой
- . "$ENV_FILE"
- set +a
- # ---------- Проверка ключей (как в deploy.yml) ----------
- miss=""
- for v in DEPLOY_PATH SITE_URL; do [ -n "${!v:-}" ] || miss="$miss $v"; done
- [ -n "${ACME_EXEC:-}" ] || for v in SSH_HOST SSH_USER; do [ -n "${!v:-}" ] || miss="$miss $v"; done
- [ -z "$miss" ] || die "в $ENV_FILE не заданы:$miss"
- SITE_URL="${SITE_URL%/}"
- host=$(printf '%s' "$SITE_URL" | sed -E 's#^https?://##; s#/.*##')
- if [ "$TARGET" = production ]; then
- printf '%s' "$host" | grep -qiE '^dev\.' && die "production: SITE_URL = «$host» — это тестовый адрес."
- printf '%s' "$DEPLOY_PATH" | grep -qiE '(^|/)dev\.' && die "production: DEPLOY_PATH указывает на папку тестового сайта."
- else
- { [ "$host" = "$PROD_HOST" ] || [ "$host" = "www.$PROD_HOST" ]; } && die "тестовый деплой смотрит на боевой адрес $host."
- fi
- # Откат кода не выкладывает, поэтому ветка и состояние git для него не важны.
- if [ "$TARGET" = production ] && [ "$ACTION" = deploy ]; then
- [ "$(git rev-parse --abbrev-ref HEAD)" = main ] || die "боевой сайт выкладывается только из ветки main: сначала слейте изменения в main."
- git diff --quiet HEAD -- wordpress || die "в папке wordpress есть незакоммиченные изменения — на боевой уходит только то, что в main."
- git fetch -q origin main && [ "$(git rev-parse HEAD)" = "$(git rev-parse origin/main)" ] \
- || die "локальная main не совпадает с origin/main: сделайте git pull (или git push), чтобы на сайте был тот же код, что в GitHub."
- fi
- # ---------- Проверки кода: та же команда, что в CI и перед коммитом ----------
- if [ "$ACTION" = deploy ]; then
- say "Проверка кода (npm run check)"
- command -v npm >/dev/null 2>&1 || die "нужен Node.js: проверки кода запускает npm run check"
- [ -d node_modules ] || die "не установлены инструменты проверки: выполните npm install и composer install"
- npm run --silent check || die "проверки кода не прошли — исправьте и повторите (так же ответил бы CI)"
- fi
- # ---------- Подтверждение ----------
- if [ "$TARGET" = production ] && [ "${YES:-0}" != 1 ]; then
- if [ "$ACTION" = rollback ]; then
- printf '\nВернуть предыдущую версию темы и плагина на БОЕВОМ сайте %s? Напишите yes: ' "$SITE_URL"
- else
- printf '\nВыложить %s (коммит %s) на БОЕВОЙ сайт %s? Напишите yes: ' "$(git rev-parse --abbrev-ref HEAD)" "$(git rev-parse --short HEAD)" "$SITE_URL"
- fi
- read -r answer
- [ "$answer" = yes ] || die "отменено"
- fi
- # ---------- Выкладка или откат: общий с Actions скрипт ----------
- if [ -z "${ACME_EXEC:-}" ]; then
- # accept-new: отпечаток сервера запоминается при первом подключении, подмена сервера позже — ошибка.
- SSH_CMD="ssh -p ${SSH_PORT:-22} -o ServerAliveInterval=30 -o StrictHostKeyChecking=accept-new"
- # Путь к ключу — без пробелов (команда передаётся строкой).
- [ -n "${SSH_KEY_FILE:-}" ] && SSH_CMD="$SSH_CMD -i ${SSH_KEY_FILE/#\~/$HOME} -o IdentitiesOnly=yes"
- export SSH_CMD
- fi
- export SITE_URL SITE_ENV="$TARGET"
- [ "$ACTION" = rollback ] && export ROLLBACK=1
- exec bash wordpress/deploy/deploy.sh
templates/project/wordpress/tools/qa/lib/seo-summary.js · Bundled script · 251 lines
- /*
- * Сводка проблем SEO-обхода в Markdown (summary.md): шапка с итогами и разделы по группам проверок.
- * Раздел печатается всегда, даже пустой: по числу в заголовке видно, что проверка выполнена.
- * Тексты заголовков и порядок разделов менять нельзя — сводку читают люди и сравнивают между запусками.
- *
- * Отдельно не запускается — подключается из wordpress/tools/qa/seo-crawl.js.
- */
- const { normalizeUrl } = require('./seo-http');
- const MAX_ITEMS = 60;
- const formatUrl = (page) => page.url;
- // Раздел сводки: заголовок с числом находок и не больше 60 строк, остаток — одной строкой «… ещё N».
- function section(title, items, format) {
- const lines = [`\n## ${title} — ${items.length}\n`];
- for (const item of items.slice(0, MAX_ITEMS)) lines.push('- ' + format(item));
- if (items.length > MAX_ITEMS) lines.push(`- … ещё ${items.length - MAX_ITEMS}`);
- return lines;
- }
- // Страницы с одинаковым значением поля (title, description): пары [значение, список адресов].
- function findDuplicates(pages, field) {
- // Обычный объект, а не Map: порядок перебора его ключей определяет порядок строк в сводке.
- const urlsByValue = {};
- for (const page of pages) {
- const value = page[field];
- if (value) (urlsByValue[value] = urlsByValue[value] || []).push(page.url);
- }
- return Object.entries(urlsByValue).filter(([, urls]) => urls.length > 1);
- }
- const jsonLdTypes = (page) => page.jsonld.join(' ');
- const isNoindex = (robots) => /noindex/i.test(robots);
- // Глубина страницы без языкового префикса (/en/…): 0 — главная.
- function pageDepth(page) {
- const parts = new URL(page.final).pathname.split('/').filter(Boolean);
- return parts.length - (/^[a-z]{2}$/.test(parts[0] || '') ? 1 : 0);
- }
- const hasForeignCanonical = (page) =>
- !page.canonical ||
- normalizeUrl(new URL(page.canonical, page.final).href) !== normalizeUrl(page.final);
- // Автор-человек: не «admin», не заглушка «?» и не общий узел #author без имени.
- const hasHumanAuthor = (page) =>
- page.authors.some((author) => !/^(admin|\?)$/i.test(author) && !/#author$/.test(author));
- function headerLines(report) {
- const { base, site, pages, responding, indexable } = report;
- const mirrors = site.mirrors
- .map((mirror) => mirror.from + ' → ' + mirror.chain.join(' → '))
- .join('; ');
- const sitemaps = site.sitemaps.map((sitemap) => sitemap.status + ' ' + sitemap.url).join(', ');
- const llmsLinks = site.llms.status === 200 ? ', ссылок: ' + site.llms.links : '';
- const blockedBots =
- site.aiBots
- .filter((entry) => entry.blocked)
- .map((entry) => entry.bot)
- .join(', ') || 'нет';
- return [
- `# SEO-обход ${base} — ${site.date}\n`,
- `Страниц обойдено: ${pages.length}, в карте сайта: ${site.sitemapCount}, отвечают 200: ${responding.length}, индексируемых: ${indexable.length}.`,
- `Зеркала: ${mirrors}`,
- `robots.txt: ${site.robots.status}; несуществующая страница: ${site.notFound.status}; карты: ${sitemaps}`,
- `GEO: llms.txt — ${site.llms.status}${llmsLinks}; боты ИИ, закрытые в robots.txt: ${blockedBots}.`,
- ];
- }
- function statusSections({ pages, indexable }) {
- const formatNot200 = (page) =>
- `${page.status} ${page.url}${page.chain.length ? ' (' + page.chain.join(' → ') + ')' : ''}${page.error ? ' ' + page.error : ''}`;
- return [
- section(
- 'Не 200 (ошибки и редиректы внутри сайта)',
- pages.filter((page) => page.status !== 200),
- formatNot200,
- ),
- section(
- 'В карте сайта, но не 200 или noindex',
- pages.filter(
- (page) => page.inSitemap && (page.status !== 200 || isNoindex(page.robots || '')),
- ),
- (page) => `${page.status} ${page.url} ${page.robots || ''}`,
- ),
- section(
- 'Ссылки внутри сайта ведут на редирект',
- pages.filter((page) => page.status === 200 && page.chain.length),
- (page) => `${page.url} → ${page.final}`,
- ),
- section(
- 'Индексируемые, но нет в карте сайта',
- indexable.filter((page) => !page.inSitemap),
- formatUrl,
- ),
- ];
- }
- function titleSections({ indexable }) {
- const isBadDescriptionLength = (page) =>
- page.description && (page.description.length < 70 || page.description.length > 170);
- return [
- section(
- 'Без title',
- indexable.filter((page) => !page.title),
- formatUrl,
- ),
- section(
- 'Title длиннее 60 символов',
- indexable.filter((page) => page.title.length > 60),
- (page) => `${page.title.length}: ${page.title} — ${page.url}`,
- ),
- section(
- 'Без description',
- indexable.filter((page) => !page.description),
- formatUrl,
- ),
- section(
- 'Description короче 70 или длиннее 170',
- indexable.filter(isBadDescriptionLength),
- (page) => `${page.description.length}: ${page.url}`,
- ),
- section(
- 'Одинаковые title',
- findDuplicates(indexable, 'title'),
- ([value, urls]) => `«${value}»: ${urls.join(', ')}`,
- ),
- section(
- 'Одинаковые description',
- findDuplicates(indexable, 'description'),
- ([value, urls]) => `«${value.slice(0, 80)}…»: ${urls.join(', ')}`,
- ),
- ];
- }
- function markupSections({ responding, indexable }) {
- return [
- section(
- 'H1 не один',
- indexable.filter((page) => page.h1.length !== 1),
- (page) => `${page.h1.length}: ${page.url} ${page.h1.join(' | ').slice(0, 120)}`,
- ),
- section(
- 'Canonical отсутствует или указывает на другую страницу',
- indexable.filter(hasForeignCanonical),
- (page) => `${page.url} → ${page.canonical || '—'}`,
- ),
- section(
- 'Нет hreflang',
- indexable.filter((page) => !page.hreflang.length),
- formatUrl,
- ),
- section(
- 'Нет og:image',
- indexable.filter((page) => !page.og.image),
- formatUrl,
- ),
- section(
- 'Картинки без alt',
- responding.filter((page) => page.imagesNoAlt.length),
- (page) => `${page.imagesNoAlt.length}: ${page.url}`,
- ),
- section(
- 'Мало текста (< 250 слов) на индексируемых',
- indexable.filter((page) => page.words < 250),
- (page) => `${page.words}: ${page.url}`,
- ),
- section(
- 'Без микроразметки JSON-LD',
- indexable.filter((page) => !page.jsonld.length),
- formatUrl,
- ),
- ];
- }
- function geoSections({ indexable }) {
- return [
- section(
- 'GEO: статьи и кейсы без автора-человека в разметке',
- indexable.filter(
- (page) => /Article|BlogPosting/.test(jsonLdTypes(page)) && !hasHumanAuthor(page),
- ),
- (page) => `${page.url} (${page.authors.join(', ') || 'нет автора'})`,
- ),
- section(
- 'GEO: внутренние страницы без BreadcrumbList',
- indexable.filter((page) => pageDepth(page) > 0 && !/BreadcrumbList/.test(jsonLdTypes(page))),
- formatUrl,
- ),
- section(
- 'GEO: блок «Вопросы и ответы» без FAQPage',
- indexable.filter((page) => page.faqBlocks && !/FAQPage/.test(jsonLdTypes(page))),
- formatUrl,
- ),
- ];
- }
- const isLegacyOk = (entry) => entry.chain[0] === 301 && entry.status === 200;
- function technicalSections({ base, responding, indexable, legacy }) {
- return [
- section(
- 'Сиротские страницы (нет входящих ссылок, только из карты)',
- indexable.filter((page) => page.inlinks === 0 && page.url !== base + '/'),
- formatUrl,
- ),
- section(
- 'Медленный ответ сервера (> 800 мс)',
- responding.filter((page) => page.ms > 800),
- (page) => `${page.ms} мс: ${page.url}`,
- ),
- section(
- 'Без сжатия gzip/br',
- responding.filter((page) => !page.headers.encoding),
- formatUrl,
- ),
- section(
- 'Старые адреса: не 301 на рабочую страницу',
- legacy.filter((entry) => !isLegacyOk(entry)),
- (entry) => `${entry.from}: ${entry.chain.join(' → ')} → ${entry.final} (${entry.status})`,
- ),
- ];
- }
- /**
- * Строки сводки. data: { base, site, pages, legacy }.
- * Возвращает массив строк: первые пять — шапка, дальше разделы (заголовок раздела — один элемент).
- */
- function buildSummaryLines(data) {
- const responding = data.pages.filter((page) => page.status === 200 && page.title !== undefined);
- // Адрес с редиректом (/pricing/ → /en/pricing/) — не отдельная страница: её title и canonical принадлежат конечной.
- const indexable = responding.filter(
- (page) => !page.chain.length && !isNoindex(page.robots + ' ' + page.xRobots),
- );
- const report = { ...data, responding, indexable };
- const sections = [
- ...statusSections(report),
- ...titleSections(report),
- ...markupSections(report),
- ...geoSections(report),
- ...technicalSections(report),
- ];
- const legacyOkCount = data.legacy.filter(isLegacyOk).length;
- return [
- ...headerLines(report),
- ...sections.flat(),
- `\nСтарые адреса проверено: ${data.legacy.length}, правильно: ${legacyOkCount}.`,
- ];
- }
- module.exports = { buildSummaryLines };
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.