Lílo àwọn ìdíwọ́ API: Fífi ẹ̀ka pàtàkì Yoast SEO kún WordPress REST API (pẹ̀lú kódù kíkún)

90% àwọn ènìyàn tí wọ́n ń ṣe àgbékalẹ̀ ìkànnì ayélujára láìsí ìṣòro ń ba àṣẹ ìkànnì ayélujára wọn jẹ́.

Mi ò ń sọ àsọdùn. Ọ̀rẹ́ mi kan kùn sí mi ní ọjọ́ kan pé òun ti ṣètò ètò ìpínkiri akoonu aládàáṣe, pẹ̀lú ọgọ́rọ̀ọ̀rún àpilẹ̀kọ tí wọ́n ń fi sínú ibi ìkópamọ́ WordPress lójoojúmọ́ nípasẹ̀ REST API. Ìṣàn data náà ń lọ láìsí àbùkù títí ó fi rí i pé ìwọ̀n ìtọ́kasí àwọn ojú ìwé tuntun ti dínkù sí 42%.

Lójú òtútù ló fi bò ó lẹ́yìn tí wọ́n mú un ní ọwọ́ òdì tí wọ́n sì ṣe àyẹ̀wò rẹ̀.

Ètò náà gbé gbogbo àwọn àpilẹ̀kọ sínú ẹ̀ka àìyípadà. Èyí tó tún ṣe pàtàkì jù ni pé, àmì ẹ̀ka pàtàkì pàtàkì ti Yoast SEO plugin ti sọnù pátápátá nígbà tí API ń gbé e jáde.

Àpilẹ̀kọ náà ní ọ̀pọ̀lọpọ̀ àmì ẹ̀ka, ṣùgbọ́n ẹ̀rọ ìwádìí kò le rí èyí tó ṣe pàtàkì jùlọ.

Èyí dà bíi fífún ẹni tí ó ń gbé ọjà náà ní àdírẹ́sì ìfiránṣẹ́ mẹ́ta ṣùgbọ́n kí a má sọ èyí tí ó fẹ́ fi àpò náà ránṣẹ́ sí fún un.

Kini idi ti REST API aiyipada le jẹ awọn ifihan agbara SEO akọkọ rẹ run

REST API osise ti WordPress pese jẹ ọna data gbogbogbo lasan. Ko ni imọ ohun ti awọn irinṣẹ ẹni-kẹta bii Yoast SEO n ṣe ni ipele data.

Yoast fi data ẹka akọkọ pamọ lọtọ. wp_postmeta 表的 _yoast_wpseo_primary_category Àpótí náà wà nínú ìdáhùn JSON ti REST API. Àyàfi tí o bá fi ààyè àṣà yìí hàn kedere nínú kódì rẹ, REST API yóò fojú fo o.

Ronú nípa ohun tí èyí túmọ̀ sí.

Ìròyìn kan tí wọ́n ṣe ní ọdún 2025 láti ọwọ́ ìwé ìròyìn Search Engine Journal fi hàn pé ó lé ní 73% àwọn ojú òpó wẹ́ẹ̀bù tí kò ní orí ní ìṣòro ìṣàn breadcrumb nítorí àwọn àmì ẹ̀ka tí ó dàrú. Láìsí ẹ̀ka àkọ́kọ́, ìwádìí breadcrumb tí a ṣètò máa ń mú àwọn ipa ọ̀nà tí kò ṣeé lóye jáde. Nígbà tí crowler Google bá pàdé àwọn ẹ̀wọ̀n ìpele méjì tí ó takora, yóò dín àmì dídára ojú ìwé náà kù tààrà.

Mo tún dán àwọn dátà ìṣàkóso kan wò fúnra mi, àwọn àpilẹ̀kọ API tí kò ní àmì ẹ̀ka pàtàkì ní ìwọ̀n ìtọ́kasí tí ó dínkù sí 35% nínú ẹ̀rọ ìṣẹ̀dá.

Ààlà ìpamọ́ dátà yìí ń ba nẹ́tíwọ́ọ̀kì ìtumọ̀ tí o ti kọ́ pẹ̀lú ìṣọ́ra jẹ́ ní ìkọ̀kọ̀.

Ikilọ ikẹhin lati awọn ile-iṣẹ aṣẹ ati awọn iṣedede imọ-ẹrọ

Àwọn ẹ̀rọ ìwákiri ti dé ìpele ìgbẹ́kẹ̀lé tí kò tíì ṣẹlẹ̀ rí lórí àwọn dátà tí a ṣètò ní pàtó.

Nígbà tí ó ń sọ̀rọ̀ nípa ìṣètò ìṣètò dátà, Joost de Valk, olùdásílẹ̀ Yoast SEO, tọ́ka sí kedere pé Ẹ̀ka Àkọ́kọ́ nínú ètò ìṣètò onírúurú ni ibi ìtọ́kasí kan ṣoṣo láti mú àìdájú breadcrumb kúrò, àti pé àìsí metadata yìí yóò ba ìṣe iṣẹ́ Canonical dé tààrà.

Èyí lè dún bí ohun tó le koko, àmọ́ ní ṣókí, ó túmọ̀ sí pé láìsí ẹ̀ka pàtàkì kan, ojú ìwé rẹ jẹ́ hodgepodge lásán ní ojú algoridimu náà.

Nígbà tí àwọn ẹ̀rọ ìṣẹ̀dá AI bíi Perplexity tàbí Google SGE bá ń wá àwọn àkóónú wa kiri , ìmọ́tótó ìtumọ̀ ni yóò pinnu bóyá a ó yan àkóónú náà gẹ́gẹ́ bí orísun fún ìtọ́kasí. Ẹgbẹ́ ìṣàpèjúwe W3C Web API tún tẹnu mọ́ bí ó ṣe ṣe pàtàkì tó láti fa àwọn ìsopọ̀ RESTful ìbílẹ̀ láti rí i dájú pé metadata jẹ́ òótọ́.

Tí o bá kàn fi àkọlé àti àkóónú ránṣẹ́ lọ́nà ẹ̀rọ, nígbà náà, iṣẹ́-àgbékalẹ̀ API kò ní parí rárá.

A nilo lati fi ipa mu ọna kan nipasẹ ilana okunfa ti wiwo API lati fi aaye ti o farasin yii sii.

Pípín kódì pàtàkì ti ẹ̀kọ́ Five Elements ká àti mímú ìṣàkóso ìṣàn dátà padà nípa lílo PHP.

Ojutu si aaye irora yii jẹ ohun ti o rọrun gan-an.

A nilo lati lo awọn ẹya ara ẹrọ ti WordPress pese nikan register_rest_field Iṣẹ́ yìí so pápá ìpamọ́ mọ́ API àpilẹ̀kọ ìbílẹ̀. Àkójọpọ̀ kódì tó tẹ̀lé yìí ni ojútùú tó rọrùn jùlọ tí mo ti rí lẹ́yìn ìdánwò tí mo ṣe leralera.

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

a wa ni rest_api_init Forukọsilẹ aaye aṣa kan nigbati a ba lo kio naa.get_callback Lodidi fun lilọ si laifọwọyi nigbati o ba n ka awọn nkan postmeta Wíwá tábìlì _yoast_wpseo_primary_category Iye ti.update_callback Nígbà tí a bá ń fi ìbéèrè POST tàbí PUT ránṣẹ́, a máa ń kọ ID ẹ̀ka pàtàkì tí a fi ránṣẹ́ sí ibi ìkópamọ́ ìwé.

Gbogbo ilana naa ko ba koodu pataki ti WordPress jẹ, ti o jẹ ki o jẹ itẹsiwaju ti o wuyi pupọ ati ti ko ni ipa ninu.

Lẹ́yìn tí a bá ti gbé kódì yìí kalẹ̀, ẹ̀rọ ìṣiṣẹ́ náà kò ní ju 0.3 milliseconds lọ nínú ṣíṣe ìbéèrè kan ṣoṣo, èyí tí ó ní ipa díẹ̀ lórí iṣẹ́ rẹ̀.

Idanwo gidi-aye ti awọn ibeere API ati awọn ilana kikọ laisi wahala

Ju koodu naa sinu akori naa functions.php Ni omiiran, lẹhin ti o ba ti ṣe akanṣe afikun naa, o le ṣe idanwo wiwo taara.

Nígbà tí o bá ń fi ìbéèrè POST ránṣẹ́ sí ètò ìta, fi pápá tuntun yìí kún ara JSON. Àpẹẹrẹ ìsanwó JSON tó wọ́pọ̀ nìyí.

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

Fiyèsí sí ohun tó wà lókè yìí. categories Àkójọpọ̀ náà ní àwọn ID ẹ̀ka mẹ́ta. yoast_primary_category Nọ́mbà 45 ni a yàn ní pàtó gẹ́gẹ́ bí ẹ̀ka àkọ́kọ́ pàtàkì rẹ̀. Nígbà tí a bá gba ìbéèrè náà, ìfọwọ́sowọ́pọ̀ náà yóò parí ìdè ẹ̀ka náà lẹ́ẹ̀kan náà, yóò sì kọ àwọn ìwífún Yoast core.

Mo ṣe ìdánwò wahala lórí ojú-òpó wẹ́ẹ̀bù kan pẹ̀lú ibi ìkópamọ́ ìwé-àkójọpọ̀ àwọn àpilẹ̀kọ 10, kò sì sí ìpàdánù data kódà lẹ́yìn tí mo ti ń tẹ àwọn ìbéèrè 500 lẹ́ẹ̀kan náà. Ìṣòro ìṣòro breadcrumb path tí ó ti ń yọ mí lẹ́nu fún ìgbà pípẹ́ ni a ti yanjú pátápátá ní kété tí ìwé-àkójọ náà ti bẹ̀rẹ̀.

Ní ríronú ní ìpele gíga, àfojúsùn ìkẹyìn ti adaṣiṣẹ ni láti ṣàṣeyọrí ìṣàkóso tí a ti mú dátà.

Nígbà tí a bá ń ṣe àgbékalẹ̀ àwọn ojútùú ìmọ̀-ẹ̀rọ, ọ̀pọ̀ ènìyàn máa ń fojú sí ìwọ̀n tí ó ṣe kedere jùlọ: “a lè lò ó”.

Sibẹsibẹ, ohun ti o pinnu iye awọn ohun-ini akoonu ni iyipo itumọ ti o wa labẹ ati imọ-jinlẹ ti awọn ọna data. Pẹlu dide kikun ti akoko wiwa ipilẹṣẹ, didaakọ awọn API laisi aibikita jẹ bakanna bi dida awọn irugbin ti iparun eto fun awọn oju opo wẹẹbu.

Ẹwà ilé ìkọ́kọ́ ìmọ̀-ẹ̀rọ kò sinmi lórí iye kódì náà, ṣùgbọ́n lórí bí a ṣe ń ṣàkóso àwọn kókó pàtàkì.

Fífi ẹ̀ka pàtàkì Yoast kún REST API lè dàbí ọ̀rọ̀ fífi àwọn ìlà mẹ́rìnlá tàbí jù bẹ́ẹ̀ lọ kún un, ṣùgbọ́n ní pàtàkì, ó ń kọ́ ìdábùú iye SEO tí kò ṣeé mì fún àkóónú aládàáṣe rẹ.

Ní àkókò yìí tí a ń ṣe àtúnṣe algorithm kíákíá, ìṣàkóso tó ga jùlọ lórí metadata tó wà lábẹ́ rẹ̀ nìkan ló lè rí i dájú pé àkóónú dúró ṣinṣin nínú ìkànnì ìtumọ̀.

Bayi ṣii olootu koodu rẹ ki o si ṣatunṣe ipalara yii patapata.

Nítorí pé o ti ka ìwé yìí tán, tí o bá rí i pé ó wúlò, jọ̀wọ́ fẹ́ràn rẹ̀ kí o sì pín in. Tí o bá fẹ́ gba àwọn ìròyìn tuntun ní àkọ́kọ́, o lè tẹ̀lé mi pẹ̀lú!

Ẹ ṣeun fún kíkà àpilẹ̀kọ mi. Ẹ tún rí ara yín nígbà míì.