Ag Seachaint Teorainneacha API: Príomhchatagóir Yoast SEO a Chur leis an WordPress REST API (leis an gCód Iomlán)

Tá 90% de na daoine a uathoibríonn foilsiú gréasáin ag milleadh údarás a suíomh gréasáin féin go ciúin.

Nílim ag déanamh ró-mhóráin. Gearán cara liom an lá cheana go raibh córas dáilte ábhair lán-uathoibrithe curtha ar bun aige, agus na céadta alt á gcur isteach i mbunachar sonraí WordPress gach lá trí REST API. Bhí an sreabhadh sonraí ag rith go gan smál go dtí gur fuair sé amach go raibh ráta innéacsaithe leathanach nua tite go mór faoi 42%.

Bhí allas fuar air tar éis dó a bheith gafa ar dhearglámh agus cigireacht a dhéanamh air.

Chaith an córas na hailt go léir isteach sa chatagóir réamhshocraithe. Níos criticiúla fós, cailleadh clib luachmhar phríomhchatagóir an bhreiseáin Yoast SEO go hiomlán le linn tarchur API.

Tá clibeanna iolracha catagóire san alt, ach ní féidir leis an inneall cuardaigh an ceann is tábhachtaí a aimsiú.

Tá sé seo cosúil le trí sheoladh seachadta a thabhairt don fhear seachadta ach gan a rá leis cé acu ceann ar cheart an pacáiste a sheoladh chuige.

Cén fáth gur féidir leis an REST API réamhshocraithe do phríomhchomharthaí Sinsearach a shlogadh

Níl san REST API oifigiúil a sholáthraíonn WordPress ach bealach ginearálta sonraí. Níl aon tuairim aige faoi na rudaí atá uirlisí tríú páirtí cosúil le Yoast SEO a dhéanamh ag leibhéal an bhunachair shonraí.

Sábhálann Yoast sonraí na príomhchatagóire ar leithligh. wp_postmeta 表的 _yoast_wpseo_primary_category Tá an réimse i bhfreagra JSON an REST API. Mura nochtann tú an réimse saincheaptha seo go sainráite i do chód, déanfaidh an REST API neamhaird de.

Smaoinigh ar cad is brí leis seo.

Léirigh tuarascáil ar Éiceachóras Ailtireachta CMS in 2025 a foilsíodh ag Search Engine Journal go raibh os cionn 73% de shuíomhanna gréasáin gan cheann ag fulaingt ó mheáchan nascleanúna aráin scaipthe mar gheall ar chomharthaí catagóire mearbhall. Gan phríomhchatagóir, gineann sonraí aráin struchtúrtha cosáin débhríocha. Nuair a thagann crawler Google ar dhá shlabhra ordlathacha contrártha, laghdóidh sé scór cáilíochta an leathanaigh go díreach.

Rinne mé tástáil ar shraith sonraí rialaithe mé féin freisin, agus bhí ráta lua 35% níos ísle ag na hairteagail API nach raibh an chlib phríomhchatagóire orthu san inneall giniúna.

Tá an bhearna sonraí folaithe seo ag creimeadh go rúnda an líonra séimeantach atá tógtha agat go cúramach.

An rabhadh deiridh ó institiúidí údarásacha agus ó chaighdeáin theicniúla

Tá leibhéal gan fasach spleáchais bainte amach ag innill chuardaigh ar shonraí struchtúrtha go sainráite.

Agus ordlathas sonraí struchtúrtha á phlé, chuir Joost de Valk, bunaitheoir Yoast SEO, in iúl go soiléir gurb é an Phríomhchatagóir in ailtireacht ilchatagóire an t-aon phointe ancaire chun débhríocht maidir le brioscaí aráin a dhíchur, agus go mbainfidh easpa na meiteashonraí seo an bonn go díreach d’éifeachtúlacht fhorghníomhaithe an normalú Canónach.

Seans go bhfuil cuma cruálach air seo, ach i dtéarmaí simplí, ciallaíonn sé, gan phríomhchatagóir, nach bhfuil i do leathanach ach meascán i súile an algartaim.

Nuair a bhíonn ár n-ábhar á chraoladh ag innill AI giniúna ar nós Perplexity nó Google SGE, is í soiléireacht sheimeantach a chinneann an roghnófar an t-ábhar mar fhoinse le haghaidh lua. Leagann grúpa sonraíochta API Gréasáin W3C béim freisin ar an ngá atá le comhéadain dúchasacha RESTful a leathnú chun sláine meiteashonraí a chinntiú.

Mura ndéanann tú ach an teideal agus an t-ábhar a sheoladh go meicniúil, níl uathoibriú API ach leathchríochnaithe.

Ní mór dúinn bealach a fhorchur trí phróiseas spreagtha chomhéadan an API chun an réimse i bhfolach seo a chur isteach.

Ag díchódú chroíchód theoiric na gCúig Dúl agus ag athghabháil smacht ar shreabhadh sonraí ag baint úsáide as PHP.

Tá an réiteach ar an bpointe pian seo an-simplí i ndáiríre.

Ní gá dúinn ach na gnéithe a sholáthraíonn WordPress a úsáid register_rest_field Ceanglaíonn an fheidhm seo an réimse i bhfolach leis an API dúchasach don alt. Is é an sleachta cóid seo a leanas an réiteach is simplí atá faighte agam tar éis tástálacha arís agus arís eile.

// 把 Yoast 主分类加入 REST API（安全强化版）
add_action('rest_api_init', function() {
register_rest_field('post', 'yoast_primary_category', array(
'get_callback' => function($post) {
$primary_cat = get_post_meta($post['id'], '_yoast_wpseo_primary_category', true);
// 确保返回字符串或空串，避免返回 false
return $primary_cat ? (string)$primary_cat : '';
},
'update_callback' => function($value, $post) {
// 安全过滤：强制转换为正整数
$cat_id = absint($value);

if ($cat_id > 0) {
update_post_meta($post->ID, '_yoast_wpseo_primary_category', $cat_id);
} else {
// 传入 0、空串或 null 时，直接删除该元数据（重置主分类）
delete_post_meta($post->ID, '_yoast_wpseo_primary_category');
}
return true;
},
'schema' => array(
'description' => 'Yoast SEO Primary Category Term ID',
'type' => array('string', 'integer', 'null'),
'context' => array('view', 'edit'),
),
));
});

táimid ag rest_api_init Cláraigh réimse saincheaptha nuair a spreagtar an crúca.get_callback Freagrach as dul go huathoibríoch chuig nuair a bhíonn ailt á léamh postmeta Fiosrúchán tábla _yoast_wpseo_primary_category Luach an .update_callback Agus iarratas POST nó PUT á sheoladh, scríobhtar an príomh-ID catagóire a chuireamar isteach chuig an mbunachar sonraí.

Ní bhriseann an próiseas iomlán príomhchód WordPress, rud a fhágann gur síneadh thar a bheith galánta agus neamh-ionrach é.

Tar éis an cód seo a shuiteáil, ní thógann sé ach níos lú ná 0.3 milleasoicind de fhorchostais ar an bhfreastalaí agus iarratas aonair á phróiseáil aige, rud a bhfuil tionchar neamhbhríoch aige ar fheidhmíocht.

Tástáil fíorshaoil ​​ar iarratais API agus próisis scríbhneoireachta gan uaim

Caith an cód isteach sa téama functions.php Nó, tar éis an breiseán a shaincheapadh, is féidir leat tástáil chomhéadain a dhéanamh go díreach.

Agus iarratas POST á chur isteach chuig córas seachtrach, níl le déanamh ach an réimse nua seo a chur i gcorp an JSON. Seo sampla d’ualach JSON caighdeánach.

{
  "title": "测试自动化发布主分类",
  "content": "这里是文章正文内容...",
  "status": "publish",
  "categories": [12, 45, 88],
  "yoast_primary_category": "45"
}

Tabhair aird ar an méid thuas. categories Tá trí aitheantóir catagóire san eagar. yoast_primary_category Tá an uimhir 45 ainmnithe go sainráite mar a phríomhchatagóir lárnach. Nuair a gheofar an t-iarratas, comhlánóidh an comhéadan an ceangal catagóire agus scríobhfaidh sé meiteashonraí lárnacha Yoast ag an am céanna.

Rinne mé tástáil struis ar shuíomh gréasáin le bunachar sonraí de 10 alt, agus ní raibh aon chaillteanas sonraí ann fiú tar éis 500 iarratas comhuaineach a bhrú go leanúnach. Réitíodh an fhadhb leis an neamhord cosáin aráin a bhí ag cur isteach orm le fada an nóiméad a rith an script.

Ag smaoineamh ar leibhéal níos airde, is é cuspóir deiridh an uathoibrithe rialú scagtha a bhaint amach ar chonairí sonraí.

Agus réitigh theicniúla á bhforbairt acu, ní dhíríonn formhór na ndaoine ach ar an ngné is dromchlaí: "is féidir é a imscaradh".

Ach is é an lúb séimeantach bunúsach agus sofaisticiúlacht na gcosán sonraí a chinneann fíorluach sócmhainní ábhair. Le teacht iomlán ré an chuardaigh ghiniúnaigh, is ionann cóipeáil APIanna gan idirdhealú agus síolta titim struchtúrach a chur do shuíomhanna gréasáin.

Ní bhraitheann galántacht ailtireachta teicniúla ar mhéid an chóid, ach ar chruinneas an rialaithe ar nóid thábhachtacha.

D’fhéadfadh sé go mbeadh cuma dosaen líne cóid nó mar sin ar phríomhchatagóir Yoast a chur leis an REST API, ach go bunúsach, cruthaíonn sé ancaire luacha Sinsearach dochloíte do d’ábhar uathoibrithe.

Sa ré seo d’athdhéanamh algartam atá thar a bheith gasta, ní féidir ach le smacht deiridh ar na meiteashonraí bunúsacha a chinntiú go seasfaidh an t-ábhar go daingean sa ghréasán séimeantach.

Anois oscail d’eagarthóir cóid agus déan an leochaileacht seo a phaisteáil go hiomlán.

Ós rud é gur léigh tú an méid seo, má fuair tú é ina chuidiú, tabhair "Is maith liom" agus roinn é le do thoil. Más mian leat nuashonruithe a fháil ar dtús, is féidir leat mé a leanúint freisin!

Go raibh maith agat as mo alt a léamh. Feicfidh mé thú an chéad uair eile.