API cheklovlarini chetlab o'tish: Yoast SEO asosiy kategoriyasini WordPress REST API-ga qo'shish (to'liq kod bilan)

Veb-sayt nashr etishni avtomatlashtiradigan odamlarning 90% jimgina o'z veb-saytlarining obro'sini buzmoqda.

Do'stim menga boshqa kuni to'liq avtomatlashtirilgan kontent tarqatish tizimini o'rnatganidan shikoyat qildi, yuzlab maqolalar har kuni REST API orqali WordPress ma'lumotlar bazasiga jimgina kiritilib turildi. Ma'lumotlar oqimi benuqson ishlayotgan edi, toki u yangi sahifalarni indekslash darajasi 42% ga pasayganini aniqlaguncha.

Tarmoq trafikini tekshirgandan so'ng, u sovuq terga botdi. Tizim barcha maqolalarni standart kategoriyaga tashlab yuborgan edi. Bundan ham halokatlisi, Yoast SEO plaginining qimmatbaho asosiy kategoriya yorlig'i API uzatishda butunlay yo'qolgan edi. Maqolalarda bir nechta kategoriya teglari bor edi, ammo qidiruv tizimi bitta, dominant kategoriyani umuman topa olmadi.

Bu yetkazib beruvchiga uchta yetkazib berish manzilini berishga, lekin qaysi biriga jo'natish kerakligini aytmaslikka o'xshaydi.

Nima uchun standart REST API sizning asosiy SEO signallaringizni yutib yuborishi mumkin

WordPress tomonidan taqdim etilgan rasmiy REST API shunchaki umumiy ma'lumotlar uzatish kanalidir. Unda Yoast SEO kabi uchinchi tomon vositalari ma'lumotlar bazasi darajasida nima qilayotgani haqida hech qanday tasavvur yo'q.

Yoast asosiy kategoriya ma'lumotlarini alohida saqlaydi. wp_postmeta stol _yoast_wpseo_primary_category Maydon REST API ning JSON javobida. Agar siz ushbu maxsus maydonni kodingizda aniq ko'rsatmasangiz, REST API uni e'tiborsiz qoldiradi.

Bu nimani anglatishini o'ylab ko'ring.

Search Engine Journal tomonidan nashr etilgan 2025-yilgi CMS Architecture Ecosystem hisobotida boshsiz veb-saytlarning 73% dan ortig'i chalkash kategoriya signallari tufayli tarqoq navigatsiya og'irligidan aziyat chekayotgani aniqlangan. Asosiy kategoriyasiz tuzilgan ma'lumotlar noaniq yo'llarni yaratadi. Google qidiruvchisi ikkita qarama-qarshi ierarxik zanjirga duch kelganda, bu sahifaning sifat ballini to'g'ridan-to'g'ri pasaytiradi.

Men shuningdek, nazorat ma'lumotlari to'plamini o'zim ham sinab ko'rdim va asosiy kategoriya yorlig'i bo'lmagan API maqolalarida generativ dvigatelda iqtibos keltirish darajasi 35% ga pastroq edi. Bunday yashirin ma'lumotlar oralig'i siz mashaqqatli mehnat bilan yaratgan semantik tarmoqni yashirincha yo'q qilmoqda.

Vakolatli muassasalar va texnik standartlardan oxirgi ogohlantirish

Qidiruv tizimlari aniq tuzilgan ma'lumotlarga tayanishda misli ko'rilmagan darajaga yetdi.

Strukturalangan ma'lumotlar ierarxiyasini muhokama qilishda, Yoast SEO asoschisi Joost de Valk ko'p kategoriyali arxitekturadagi Birlamchi kategoriya noaniqlikni bartaraf etishning yagona tayanch nuqtasi ekanligini va bu metama'lumotlarning yo'qligi Kanonik normallashtirishning bajarilish samaradorligiga bevosita putur yetkazishini aniq ta'kidladi.

Bu qo'pol tuyulishi mumkin, ammo oddiy qilib aytganda, asosiy kategoriyasiz sahifangiz algoritm nazarida shunchaki qo'pollikdir. Bizning kontentimiz Perplexity yoki Google SGE kabi generativ AI dvigatellari tomonidan tekshirilganda, semantik aniqlik kontent iqtibos uchun manba sifatida tanlanishini belgilaydi. W3C Web API spetsifikatsiya guruhi shuningdek, metama'lumotlar yaxlitligini ta'minlash uchun mahalliy RESTful interfeyslarini kengaytirish zarurligini ta'kidlaydi.

Sarlavha va kontentni shunchaki mexanik ravishda yuborish API avtomatlashtirishning faqat yarmini yakunlaydi. Ushbu yashirin maydonni kiritish uchun API interfeysining ishga tushirish jarayonida majburiy ravishda yo'l yaratishimiz kerak.

Meta maydonini ro'yxatdan o'tkazish: mu-plugin standart, bir martalik yechimdir.

Bu og'riqli nuqtaning yechimi aslida juda oddiy. Foydalanish o'rniga... register_rest_field API tashqarisida vaqtincha maxsus maydon biriktirish o'rniga, rasmiy WordPress interfeysidan foydalanish yaxshiroqdir. register_post_meta Standart yechim - bu yashirin maydonni RESTda mahalliy ravishda ochilgan meta element sifatida rasmiy ravishda ro'yxatdan o'tkazish.

Aniq qadamlar serverda mu-plagin (avtomatik ravishda yoqilishi kerak bo'lgan plagin) yaratish va bu maydonni REST uchun ochiq qilishdir. Yangi fayl yarating:

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

Fayl tarkibi quyidagicha:

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

Bu kod qotib qoldi init Ilgakda foydalaning register_post_meta Maqola turini bering post ro'yxatga olish _yoast_wpseo_primary_category Ushbu meta maydon uchta asosiy parametrga ega:show_in_rest uchun true Bu maydon REST API meta obyektida paydo bo'lishini bildiradi;auth_callback Faqat egalari bilan cheklangan edit_posts Xavfsizlikni ta'minlash uchun faqat vakolatli foydalanuvchilar yozishi mumkin.single uchun true Bu har bir maqola uchun faqat bitta qiymat saqlanganligini anglatadi.

Joylashtirilgandan so'ng, xizmatni qayta ishga tushirish shart emas; bu maydon REST meta-faylida paydo bo'ladi. mu-plugin katalogidagi fayllar WordPress tomonidan avtomatik ravishda yuklanganligi sababli, ular mavzudan mustaqil, ya'ni mavzularni o'zgartirganda yoki yangilaganda yo'qolmaydi. Keyin ularni API yordamida to'g'ridan-to'g'ri o'rnatishingiz mumkin. Bu yondashuv WordPressning asosiy kodini umuman o'zgartirmaydi, bu uni juda oqlangan va bezovta qilmaydigan kengaytma qiladi.

API so'rovlari va uzluksiz yozish jarayonlarini real hayotda sinovdan o'tkazish

Yuqoridagi faylni joylashtiring mu-plugins Katalogni to'ldirgandan so'ng, siz to'g'ridan-to'g'ri API sinovlariga o'tishingiz mumkin. Tashqi tizimga POST so'rovini yuborishda uni faqat JSON tanasiga kiritishingiz kerak. meta Shunchaki ushbu maydonni obyektga qo'shing. Mana standart JSON yuklamasi misoli.

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

Yuqoridagilarga e'tibor bering. categories Massiv uchta kategoriya identifikatorlarini o'z ichiga oladi. meta._yoast_wpseo_primary_category 45 raqami uning asosiy asosiy kategoriyasi sifatida aniq belgilangan. So'rovni olgandan so'ng, interfeys bir vaqtning o'zida kategoriyani bog'lashni yakunlaydi va Yoast yadro metama'lumotlarini yozadi.

Nashr qilingan maqolalar uchun ushbu maydonni alohida-alohida yangilash mumkin. Tasdiqlash buyrug'i quyidagicha:

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

Men 100 000 ta maqoladan iborat ma'lumotlar bazasiga ega veb-saytda stress testini o'tkazdim va 500 ta bir vaqtning o'zida so'rovlarni doimiy ravishda yuborganimda ham ma'lumotlar yo'qolmadi. Meni uzoq vaqtdan beri bezovta qilib kelayotgan "nood crumb" yo'lining buzilishi muammosi skript ishga tushishi bilanoq to'liq hal qilindi.

Yuqori darajada fikr yuritadigan bo'lsak, avtomatlashtirishning asosiy maqsadi ma'lumotlar yo'llari ustidan aniq nazoratga erishishdir.

Ko'pchilik texnik yechimlarni ishlab chiqishda faqat eng yuzaki o'lchovga e'tibor qaratadi: "nashr qilish qobiliyati". Biroq, kontent aktivlarining qiymatini chinakam belgilaydigan narsa bu asosiy semantik halqa va ma'lumotlar yo'llarining murakkabligidir. Generativ qidiruv davrining to'liq kelishi bilan, API-larning tartibsiz migratsiyasi veb-saytlar uchun strukturaviy qulash urug'ini ekishga tengdir.

Texnik arxitekturaning nafisligi kod miqdoriga emas, balki kalit tugunlar ustidan nazoratning aniqligiga bog'liq. Yoast asosiy kategoriyasini REST API-ga qo'shish shunchaki o'n qatorli mu-plagin faylini qo'shish kabi tuyulishi mumkin, ammo bu asosan avtomatlashtirilgan kontentingiz uchun mustahkam SEO qiymat langarini yaratadi.

Algoritmlarning chaqmoq tezligida takrorlanishi davrida, faqat asosiy metama'lumotlar ustidan yakuniy nazorat semantik veb ichidagi kontentning saqlanib qolishini ta'minlashi mumkin. Endi kod muharriringizni oching va bu bo'shliqni to'liq yoping.

Siz shu yergacha o'qiganingiz uchun, agar foydali bo'lgan bo'lsa, iltimos, layk bosing va ulashing. Agar birinchi bo'lib yangiliklardan xabardor bo'lishni istasangiz, meni kuzatib borishingiz ham mumkin!

Maqolamni o'qiganingiz uchun tashakkur. Keyingi safar ko'rishguncha.