Обхід обмежень API: додавання основної категорії Yoast SEO до REST API WordPress (з повним кодом)

все SEO Зрештою, гра зводиться до того, чи є «сигнали» чіткими, чи ні.
Якщо сигнали категоризації заплутані, хлібні крихти можуть заплутати пошукові системи, як лабіринт.
Функція «Головна категорія» Yoast SEO є саме ключем до вирішення цієї проблеми.
问题 在于:WordPress Вбудований REST API не надає доступ до цього поля.
Тому ми повинні взяти справу у свої руки, подолати обмеження API та додати основну категорію до REST API.

Навіщо додавати основну категорію Yoast до REST API?

Багато хто вважає, що REST API – це лише інструменти для розробників, але в автоматизації контенту та... AI У сценарії рушійного письма це основний канал.
Якщо головну категорію неможливо встановити через API, ієрархія статей втратить свою унікальність.
这意味着:

• Шлях навігації може мати кілька гілок.
• Структурований парсинг даних Google може призвести до неоднозначності.
• Вага сторінки розподіляється між різними категоріями.

Згідно з офіційною документацією Google, хлібні крихти повинні мати єдиний, чіткий шлях; інакше вони вплинуть на ефективність індексації.
Це не перебільшення; це сигнал, безпосередньо пов'язаний з якістю сторінки.

Реєстрація метаполів: стандартне рішення, яке вирішує проблему раз і назавжди.

Рішення насправді досить елегантне: просто зареєструйте головне метаполе категорії Yoast та зробіть його доступним для REST API.
Таким чином, будь-який виклик API може безпосередньо зчитувати та записувати це поле.

Код виглядає наступним чином:

<?php
add_action('init', function () {
    register_post_meta('post', '_yoast_wpseo_primary_category', [
        'type'              => 'string',
        'single'            => true,
        'show_in_rest'      => true,
        'auth_callback'     => function () {
            return current_user_can('edit_posts');
        },
    ]);
});

Мета цього коду:

• Реєстрація метаполів _yoast_wpseo_primary_category.
• Відкритий REST APIЦе дозволяє читати та записувати через інтерфейс.
• Контроль доступуЦю функцію можуть використовувати лише користувачі з правами редагування статей.

Як розгорнути mu-плагін?

Введіть цей код mu-plugin Це гарантує його постійну роботу.

шлях:

wp-content/mu-plugins/yoast-primary-rest.php

Чому варто обрати mu-плагін?
Оскільки це не залежить від теми та не може бути вимкнено, це рішення "одноразового використання".
WordPress завантажить файл автоматично, якщо він існує.

Перевірка: Перевірте безпосередньо за допомогою команди curl.

Після розгортання перезавантаження чи додаткове налаштування не потрібні.
Він відображатиметься в метаполі REST API. _yoast_wpseo_primary_category.

Команда перевірки:

curl -s -u "用户名:应用密码" -X POST \
  -H "Content-Type: application/json" \
  -d '{"meta":{"_yoast_wpseo_primary_category":"33"}}' \
  "https://www.chenweiliang.com /wp-json/wp/v2/posts/{post_id}"

серед них:

• 33 Це ідентифікатор категорії.
• {post_id} Це ідентифікатор статті.
• 用户名:应用密码 Це автентифікація за паролем для додатків WordPress.

Після виконання основна категорія статті буде оновлена ​​до вказаної категорії.

Фактичний ефект: Уніфікація SEO-сигналів

Як тільки основну категорію можна буде налаштувати через API, весь ланцюжок SEO-сигналів стане зрозумілим:

• Шлях хлібних крихт унікальний.
• Структуровані дані однозначні.
• Сканер Google може швидко визначити ієрархію сторінок.

Це не лише технологічна оптимізація, а й стабілізатор для екосистеми контенту.
У сценаріях масштабного виробництва контенту об'єднання основних категорій може значно зменшити помилки індексації.

У статті Search Engine Land за 2025 рік зазначається:

«Хлібні крихти — це не просто засоби навігації; це сигнали ієрархії, на які покладаються пошукові системи».

В офіційній документації Yoast також чітко зазначено:

«Основна категорія гарантує, що ваш контент має єдиний, чіткий шлях у навігаційних сухарях».

Усі ці точки зору підкреслюють важливість головної категорії.
Розширюючи REST API, ми повністю інтегруємо цю функціональність в автоматизований процес.

Висновок

Суть SEO полягає в тому, щоб дозволити машинам розуміти контент, створений людиною.
Головною категорією є якір порядку в цьому спілкуванні.
Якщо ключові слова є символами мови, то хлібні крихти – це карти структури.
Без карти пошукова система може лише блукати лабіринтом.

Тому подолання обмежень API та додавання основної категорії Yoast до REST API – це не просто метод розробки, а й стратегічний вибір.
Це забезпечує вашому контенту більшу видимість та міцнішу стабільність сигналу в еру генеративних пошукових систем.

Тільки опанувавши порядок, можна контролювати владу.
Це справжній перетин технологій та SEO.