API-korlátozások megkerülése: A Yoast SEO főkategória hozzáadása a WordPress REST API-hoz (teljes kóddal)

minden SEO A játék végső soron azon múlik, hogy a "jelzések" tiszták-e vagy sem.
Ha a kategorizálási jelek zavaróak, a navigációs morzsák úgy zavarhatják meg a keresőmotorokat, mint egy labirintus.
A Yoast SEO „Fő kategória” funkciója pontosan a kulcsa ennek a problémának a megoldásához.
A probléma a következő:WordPress Ez a mező nincs engedélyezve a natív REST API-ban.
Ezért a saját kezünkbe kell vennünk az ügyet, át kell törnünk az API korlátait, és hozzá kell adnunk a fő kategóriát a REST API-hoz.

Miért érdemes hozzáadni a Yoast főkategóriát a REST API-hoz?

Sokan azt gondolják, hogy a REST API-k csak fejlesztőknek szánt eszközök, de a tartalomautomatizálásban és... AI Vezetett írás esetén ez a központi csatorna.
Ha a fő kategória nem állítható be API-n keresztül, a cikkhierarchia elveszíti egyediségét.
Ez azt jelenti:

• A navigációs útvonalnak több ága is lehet.
• A Google strukturált adatelemzési módszerei kétértelműségeket okozhatnak.
• Az oldal súlya a különböző kategóriák között eloszlik.

A Google hivatalos dokumentációja szerint a breadcrumboknak egyetlen, egyértelmű útvonalat kell követniük; ellenkező esetben befolyásolják az indexelés hatékonyságát.
Ez nem túlzás; ez egy olyan jelzés, amely közvetlenül kapcsolódik az oldal minőségéhez.

Metamezők regisztrálása: egy szabványos megoldás, amely végleg megoldja a problémát.

A megoldás valójában elég elegáns: egyszerűen regisztráld a Yoast fő kategória metamezőjét, és tedd elérhetővé a REST API számára.
Ily módon bármely API-hívás közvetlenül olvashatja és írhatja ezt a mezőt.

A kód a következő:

<?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');
        },
    ]);
});

Ennek a kódnak a célja:

• Metamezők regisztrálása _yoast_wpseo_primary_category.
• Nyílt REST APILehetővé teszi az olvasást és az írást a felületen keresztül.
• Engedélyek kezeléseCsak a cikkszerkesztési jogosultsággal rendelkező felhasználók használhatják ezt a funkciót.

Hogyan telepíthetem a mu-plugint?

Tedd be ezt a kódot mu-plugin Ez biztosítja, hogy mindig működjön.

útvonal:

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

Miért válasszam a mu-plugint?
Mivel nem témától függő és nem letiltható, „egyszer használatos” megoldás.
A WordPress automatikusan betölti a fájlt, amíg az létezik.

Ellenőrzés: Teszteld közvetlenül a curl paranccsal.

A telepítés után nincs szükség újraindításra vagy további konfigurációra.
Ez a REST API meta mezőjében fog megjelenni. _yoast_wpseo_primary_category.

Ellenőrző parancs:

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}"

közöttük:

• 33 Ez egy kategóriaazonosító.
• {post_id} Ez a cikk azonosítója.
• 用户名:应用密码 Ez egy jelszó-hitelesítés WordPress alkalmazásokhoz.

A végrehajtás után a cikk fő kategóriája frissül a megadott kategóriára.

Tényleges hatás: A SEO-jelek egységesítése

Miután a fő kategória beállítható API-n keresztül, a teljes SEO jellánc egyértelművé válik:

• A navigációs útvonal egyedi.
• A strukturált adatok egyértelműek.
• A Google robotja gyorsan képes azonosítani az oldalak hierarchiáját.

Ez nemcsak technológiai optimalizálás, hanem a tartalom-ökoszisztéma stabilizálója is.
Nagyméretű tartalomgyártási forgatókönyvekben a fő kategóriák egyesítése jelentősen csökkentheti az indexelési hibákat.

A Search Engine Land 2025-ös cikke rámutat:

„A kenyérmorzsák nem csupán navigációs segédletek; a hierarchia jelei, amelyekre a keresőmotorok támaszkodnak.”

A hivatalos Yoast dokumentáció egyértelműen kimondja:

„Az elsődleges kategória biztosítja, hogy a tartalmad egyetlen, egyértelmű útvonallal rendelkezzen a navigációs útvonalon.”

Ezek a nézőpontok mind a fő kategória fontosságát hangsúlyozzák.
A REST API kiterjesztésével ezt a funkciót teljes mértékben integráljuk az automatizált folyamatba.

Következtetés

A SEO lényege, hogy képessé tegye a gépeket az ember által generált tartalom megértésére.
A fő kategória a rend horgonya ebben a kommunikációban.
Ha a kulcsszavak a nyelv szimbólumai, akkor a kenyérmorzsák a struktúra térképei.
Térkép nélkül egy keresőmotor csak egy labirintusban tud bolyongani.

Ezért az API korlátainak áttörése és a Yoast fő kategória hozzáadása a REST API-hoz nem csupán fejlesztési technika, hanem stratégiai döntés is.
Nagyobb láthatóságot és erősebb jelstabilitást biztosít a tartalomnak a generatív keresőmotorok korában.

Csak a rend uralásával lehet uralni a hatalmat.
Ez a technológia és a SEO igazi metszéspontja.