Ukudlula imida ye-API: Ukongeza i-Yoast SEO Main Category kwi-WordPress REST API (eneKhowudi epheleleyo)

Ama-90% abantu abapapasha iiwebhusayithi ngokuzenzekelayo bawonakalisa ngokufihlakeleyo igunya lewebhusayithi yabo.

Andibaxi. Umhlobo wam wandikhalazela ngenye imini esithi usete inkqubo yokusasazwa komxholo ezenzekelayo ngokupheleleyo, kunye namakhulu amanqaku afakwa buthule kwi- database yeWordPress yonke imihla nge-REST API. Ukuhamba kwedatha bekuqhubeka ngokungenasiphako de wafumanisa ukuba izinga lokufakwa kwamaphepha amatsha liye lehla ngama-42%.

Wayegcwele ukubila okubandayo emva kokubanjwa ebanjwe enetyala waza wahlolwa.

Le nkqubo ilahle onke amanqaku kudidi olumiselweyo. Okubaluleke ngakumbi kukuba, i-tag ye-primary category exabisekileyo ye-Yoast SEO plugin yalahleka ngokupheleleyo ngexesha lokudluliselwa kwe-API.

Eli nqaku lineethegi ezininzi zeentlobo, kodwa injini yokukhangela ayinakufumana eyona ibalulekileyo.

Oku kufana nokunika umntu ohambisa impahla iidilesi ezintathu kodwa ungamxeleli ukuba makathumele iphakheji kweyiphi.

Kutheni i-REST API engagqibekanga inokuchitha imiqondiso yakho ephambili ye-SEO

I-REST API esemthethweni ebonelelwa yiWordPress yindlela nje yokudlulisa idatha ngokubanzi. Ayinalo nofifi lokuba zeziphi izixhobo zomntu wesithathu ezifana neYoast SEO ezizenzayo kwinqanaba ledatha.

I-Yoast igcina idatha yodidi oluphambili ngokwahlukeneyo. wp_postmeta itafile _yoast_wpseo_primary_category Intsimi ikwimpendulo ye-REST API ye-JSON. Ngaphandle kokuba uyityhile ngokucacileyo le ntsimi yesiko kwikhowudi yakho, i-REST API ayizukuyihoya.

Cinga ngento ethethwa koku.

Ingxelo ye-2025 CMS Architecture Ecosystem epapashwe yiSearch Engine Journal ityhile ukuba ngaphezulu kwe-73% yeewebhusayithi ezingenamakhanda zinengxaki yobunzima bokuhambahamba obusasazekileyo ngenxa yeempawu zecandelo ezididayo. Ngaphandle kodidi oluphambili, idatha ye-breadcrumb ecwangcisiweyo ivelisa iindlela ezingacacanga. Xa i-crawler kaGoogle idibana neentambo ezimbini ezingqubanayo zolawulo, iya kunciphisa ngokuthe ngqo amanqaku omgangatho wephepha.

Ndivavanye neseti yedatha yolawulo ngokwam, kwaye amanqaku e-API awayengenalo i-tag yecandelo eliphambili ayenezinga eliphantsi le-35% lokucaphula kwi-engine evelisayo.

Esi sikhewu sedatha esifihliweyo sitshabalalisa ngasese inethiwekhi yentsingiselo oyilakhileyo ngononophelo.

Isilumkiso sokugqibela esivela kumaziko anegunya kunye nemigangatho yobugcisa

Iinjini zokukhangela zifikelele kwinqanaba elingazange libonwe ngaphambili lokuxhomekeka kwidatha ecwangcisiweyo ngokucacileyo.

Xa wayexoxa ngolawulo lwedatha olucwangcisiweyo, uJoost de Valk, umseki weYoast SEO, wabonisa ngokucacileyo ukuba udidi oluPhambili kwisakhiwo esineendidi ezininzi yeyona ndawo iphambili yokuphelisa ukungacaci kwento, kwaye ukungabikho kwale metadata kuya kuyiphazamisa ngokuthe ngqo indlela esebenza ngayo iCanonical normalization.

Oku kusenokuvakala kurhabaxa, kodwa ngokucacileyo, kuthetha ukuba ngaphandle kodidi oluphambili, iphepha lakho lifana nje ne-hodgepodge emehlweni e-algorithm.

Xa umxholo wethu ukhasa ziinjini ze-AI ezivelisayo ezifana nePerplexity okanye iGoogle SGE, ukucaca kwentsingiselo kumisela ukuba umxholo uza kukhethwa njengomthombo wokucaphula. Iqela leenkcukacha ze-W3C Web API likwagxininisa imfuneko yokwandisa ii-interfaces ze-RESTful zemveli ukuqinisekisa ukuthembeka kwe-metadata.

Ukuba uthumela nje isihloko kunye nomxholo ngoomatshini, oko kuthetha ukuba i-API automation ayigqitywanga ngokupheleleyo.

Sidinga ukunyanzela indlela edlula kwinkqubo yokuqalisa ye-API interface ukuze sifake le ndawo ifihliweyo.

Ukwahlulahlula ikhowudi engundoqo yethiyori yeFive Elements kunye nokubuyisela ulawulo lokuhamba kwedatha kusetyenziswa i-PHP.

Isisombululo sale ngongoma ibuhlungu silula kakhulu.

Sidinga kuphela ukusebenzisa iimpawu ezibonelelwa yiWordPress register_rest_field Lo msebenzi uncamathisela intsimi efihliweyo kwi-API yenqaku lemveli. I-snippet yekhowudi elandelayo sesona sisombululo silula endisifumeneyo emva kovavanyo oluphindaphindwayo.

// 把 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'),
),
));
});

silapha rest_api_init Bhalisa intsimi eyenziwe ngokwezifiso xa i-hook ivuliwe.get_callback Uxanduva lokuya ngokuzenzekelayo xa ufunda amanqaku postmeta Umbuzo weTheyibhile _yoast_wpseo_primary_category Ixabiso le.update_callback Xa uthumela isicelo sePOST okanye se-PUT, i-ID yodidi oluphambili esiludlulisileyo ibhalwa kwisiseko sedatha.

Yonke le nkqubo ayiphuli ikhowudi ephambili yeWordPress, nto leyo eyenza ukuba ibe lulwandiso oluhle kakhulu nolungaphazamisiyo.

Emva kokufaka le khowudi, iseva ifumana ngaphantsi kwe-0.3 milliseconds ye-overhead ekucubunguleni isicelo esinye, nto leyo enefuthe elincinci ekusebenzeni.

Uvavanyo lokwenyani lwezicelo ze-API kunye neenkqubo zokubhala ezingenamthungo

Phosa ikhowudi kumxholo functions.php Okanye, emva kokwenza ngokwezifiso i-plugin, ungenza uvavanyo lwe-interface ngokuthe ngqo.

Xa uthumela isicelo sePOST kwinkqubo yangaphandle, faka nje le ntsimi intsha emzimbeni weJSON. Nantsi umzekelo oqhelekileyo weJSON payload.

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

Nika ingqalelo koku kungasentla. categories Uluhlu luqulathe ii-ID zodidi ezintathu. yoast_primary_category Inombolo 45 ichazwe ngokucacileyo njengodidi oluphambili oluphambili. Xa ifumene isicelo, ujongano luya kugqiba ngaxeshanye ukubopha udidi kwaye lubhale i-metadata engundoqo ye-Yoast.

Ndenze uvavanyo loxinzelelo kwiwebhusayithi enesiseko sedatha samanqaku ayi-10, kwaye akukho lahleko yedatha nasemva kokuqhubeka ndicela izicelo ezingama-500 ngaxeshanye. Ingxaki yengxaki yendlela ye-breadcrumb eyayindikhathaza ixesha elide yasonjululwa ngokupheleleyo kwangoko xa iskripthi sisebenza.

Ukucinga kwinqanaba eliphezulu, injongo ephambili yokwenza izinto ngokuzenzekelayo kukufikelela kulawulo olucokisekileyo kwiindlela zedatha.

Xa bephuhlisa izisombululo zobugcisa, uninzi lwabantu lugxila kuphela kumlinganiselo ongaphezulu kakhulu: "ungafakwa".

Nangona kunjalo, into egqiba ngokwenene ixabiso lezinto eziqulathwe ngumxholo yi-semantic loop esisiseko kunye nobunzima beendlela zedatha. Ngokufika ngokupheleleyo kwexesha lokukhangela elivelisayo, ukukopa nje ii-API ngokungakhethiyo kubeka emngciphekweni wokuwa kwesakhiwo sewebhusayithi.

Ubuhle boyilo lobugcisa abuxhomekekanga kubungakanani bekhowudi, kodwa kuxhomekeke ekuchanekeni kolawulo kwii-key nodes.

Ukongeza udidi oluphambili lweYoast kwi-REST API kunokubonakala ngathi yinto nje yokongeza imigca elishumi elinesibini okanye ngaphezulu yekhowudi, kodwa ngokwenene, yakha i-anchor yexabiso le-SEO engagungqiyo yomxholo wakho ozenzekelayo.

Kule mihla yokuphindaphinda kwe-algorithm ngokukhawuleza, lulawulo olupheleleyo kuphela kwi-metadata engaphantsi olunokuqinisekisa ukuba umxholo umi ngokuqinileyo kwi-semantic web.

Ngoku vula umhleli wakho wekhowudi uze ulungise ngokupheleleyo obu buthathaka.

Ekubeni sele uyifundile le ncwadi, ukuba uyifumene iluncedo, nceda uyithande kwaye uyibelane ngayo. Ukuba ufuna ukufumana uhlaziyo kuqala, ungandilandela!

Enkosi ngokufunda inqaku lam. Siza kubonana kwixesha elizayo.