API جي حدن کي نظرانداز ڪندي: ورڈپریس REST API ۾ Yoast SEO مکيه ڪيٽيگري شامل ڪرڻ (مڪمل ڪوڊ سان)

90 سيڪڙو ماڻهو جيڪي ويب سائيٽ پبلشنگ کي خودڪار بڻائين ٿا، اهي خاموشي سان پنهنجي ويب سائيٽ جي اختيار کي برباد ڪري رهيا آهن.

مان وڌاءُ نه ٿو ڪريان. منهنجي هڪ دوست ٻئي ڏينهن مون کي شڪايت ڪئي ته هن هڪ مڪمل طور تي خودڪار مواد ورهائڻ وارو نظام قائم ڪيو آهي، جنهن ۾ سوين مضمون خاموشي سان هر روز REST API ذريعي ورڈپریس ڊيٽابيس ۾ فيڊ ڪيا ويندا آهن. ڊيٽا جو وهڪرو بي عيب هلي رهيو هو جيستائين هن کي خبر پئي ته نون صفحن جي انڊيڪسنگ جي شرح 42 سيڪڙو گهٽجي وئي آهي.

رنگي هٿان پڪڙڻ ۽ معائني ڪرڻ کان پوءِ هو ٿڌو پسينو ۾ لت پت هو.

سسٽم سڀني مضمونن کي ڊفالٽ ڪيٽيگري ۾ اڇلائي ڇڏيو. اڃا به وڌيڪ نازڪ، يواسٽ ايس اي او پلگ ان جو قيمتي پرائمري ڪيٽيگري ٽيگ API ٽرانسميشن دوران مڪمل طور تي گم ٿي ويو.

مضمون ۾ ڪيترائي ڪيٽيگري ٽيگ آهن، پر سرچ انجن هڪ به اهم ترين ٽيگ نه ڳولي سگهيو آهي.

هي ائين آهي جيئن ڊليوري ڪندڙ کي ٽي ڊليوري ايڊريس ڏنا وڃن پر اهو نه ٻڌايو وڃي ته ڪهڙي کي پارسل موڪلڻو آهي.

ڇو ڊفالٽ REST API توهان جي بنيادي SEO سگنلن کي کائي سگهي ٿو

ورڈپریس پاران مهيا ڪيل سرڪاري REST API صرف هڪ عام ڊيٽا ڪنڊويٽ آهي. ان کي ڪا به خبر ناهي ته Yoast SEO جهڙا ٽئين پارٽي جا اوزار ڊيٽابيس جي سطح تي ڇا ڪري رهيا آهن.

يواسٽ مکيه ڪيٽيگري ڊيٽا الڳ الڳ محفوظ ڪري ٿو. wp_postmeta 表的 _yoast_wpseo_primary_category هي فيلڊ REST API جي JSON جواب ۾ آهي. جيستائين توهان پنهنجي ڪوڊ ۾ هن ڪسٽم فيلڊ کي واضح طور تي ظاهر نه ڪندا، REST API ان کي نظرانداز ڪندو.

سوچيو ته ان جو مطلب ڇا آهي.

سرچ انجن جرنل پاران شايع ٿيل 2025 جي سي ايم ايس آرڪيٽيڪچر ايڪو سسٽم رپورٽ ظاهر ڪيو آهي ته 73 سيڪڙو کان وڌيڪ هيڊ ليس ويب سائيٽون مونجهاري واري ڪيٽيگري سگنلن جي ڪري منتشر بريڊ ڪرمب نيويگيشن وزن جو شڪار ٿيون. بنيادي ڪيٽيگري کان سواءِ، منظم بريڊ ڪرمب ڊيٽا مبهم رستا پيدا ڪري ٿو. جڏهن گوگل جو ڪريلر ٻن متضاد درجي بندي زنجيرن سان منهن ڏئي ٿو، ته اهو سڌو سنئون صفحي جي معيار جي اسڪور کي گهٽائي ڇڏيندو.

مون پاڻ به ڪنٽرول ڊيٽا جي هڪ سيٽ جي جانچ ڪئي، ۽ API آرٽيڪل جن ۾ مکيه ڪيٽيگري ٽيگ نه هو، جنريٽري انجن ۾ حوالن جي شرح 35٪ گهٽ هئي.

هي لڪيل ڊيٽا گيپ ڳجهي طور تي توهان جي محنت سان ٺاهيل سيمينٽڪ نيٽ ورڪ کي ختم ڪري رهيو آهي.

بااختيار ادارن ۽ ٽيڪنيڪل معيارن کان آخري خبرداري

سرچ انجن واضح طور تي منظم ڊيٽا تي ڀروسو ڪرڻ جي هڪ بي مثال سطح تي پهچي ويا آهن.

جڏهن منظم ڊيٽا جي درجي بندي تي بحث ڪيو ويو، يوسٽ ايس اي او جي باني، جوسٽ ڊي والڪ، واضح طور تي اشارو ڪيو ته هڪ گھڻ-ڪيٽيگري آرڪيٽيڪچر ۾ پرائمري ڪيٽيگري بريڊ ڪرمب ابهام کي ختم ڪرڻ لاءِ واحد اينڪر پوائنٽ آهي، ۽ هن ميٽا ڊيٽا جي کوٽ سڌي طرح ڪيننيڪل نارملائيزيشن جي عملدرآمد جي ڪارڪردگي کي نقصان پهچائيندي.

هي شايد سخت لڳي، پر سادي لفظن ۾، ان جو مطلب اهو آهي ته مکيه ڪيٽيگري کان سواءِ، توهان جو صفحو الگورتھم جي نظر ۾ صرف هڪ ڍل آهي.

جڏهن اسان جو مواد جنريٽو AI انجن جهڙوڪ Perplexity يا Google SGE ذريعي ڪرال ڪيو ويندو آهي، ته پوءِ سيمينٽڪ وضاحت اهو طئي ڪري ٿي ته ڇا مواد کي حوالن لاءِ ذريعو طور چونڊيو ويندو. W3C ويب API وضاحت گروپ ميٽا ڊيٽا سالميت کي يقيني بڻائڻ لاءِ اصلي RESTful انٽرفيس کي وڌائڻ جي ضرورت تي پڻ زور ڏئي ٿو.

جيڪڏهن توهان صرف عنوان ۽ مواد کي مشيني طور تي موڪليو ٿا، ته پوءِ API آٽوميشن صرف اڌ ختم ٿيل آهي.

اسان کي هن لڪيل فيلڊ کي داخل ڪرڻ لاءِ API انٽرفيس جي ٽرگرنگ عمل ذريعي هڪ طريقو اختيار ڪرڻو پوندو.

PHP استعمال ڪندي پنجن عنصرن جي نظريي جي بنيادي ڪوڊ کي ورهائڻ ۽ ڊيٽا جي وهڪري جو ڪنٽرول ٻيهر حاصل ڪرڻ.

هن تڪليف واري نقطي جو حل اصل ۾ تمام سادو آهي.

اسان کي صرف ورڈپریس پاران مهيا ڪيل خاصيتن کي استعمال ڪرڻ جي ضرورت آهي. register_rest_field هي فنڪشن لڪيل فيلڊ کي اصلي مضمون API سان ڳنڍيندو آهي. هيٺ ڏنل ڪوڊ سنيپٽ سڀ کان آسان حل آهي جيڪو مون بار بار جانچ ڪرڻ کان پوءِ حاصل ڪيو آهي.

// 把 Yoast 主分类加入 REST API
add_action('rest_api_init', function() {
    register_rest_field('post', 'yoast_primary_category', array(
        'get_callback' => function($post) {
            return get_post_meta($post['id'], '_yoast_wpseo_primary_category', true);
        },
        'update_callback' => function($value, $post) {
            update_post_meta($post->ID, '_yoast_wpseo_primary_category', $value);
        },
        'schema' => array(
            'type' => 'string',
        ),
    ));
});

اسان تي آهيون rest_api_init جڏهن ٿلهو شروع ٿئي ته هڪ ڪسٽم فيلڊ رجسٽر ڪريو.get_callback مضمون پڙهڻ وقت خودڪار طريقي سان وڃڻ جو ذميوار postmeta ٽيبل جي ڳولا _yoast_wpseo_primary_category جي قيمت.update_callback جڏهن POST يا PUT درخواست موڪلي ويندي آهي، ته اسان جيڪا مکيه ڪيٽيگري ID پاس ڪندا آهيون اها ڊيٽابيس ۾ لکي ويندي آهي.

سڄو عمل ورڈپریس جي بنيادي ڪوڊ کي نه ٽوڙيندو آهي، ان کي هڪ انتهائي خوبصورت ۽ غير مداخلت ڪندڙ ايڪسٽينشن بڻائيندو آهي.

هن ڪوڊ کي نصب ڪرڻ کان پوءِ، سرور هڪ درخواست جي پروسيسنگ ۾ 0.3 ملي سيڪنڊن کان گهٽ اوور هيڊ خرچ ڪري ٿو، جنهن جو ڪارڪردگي تي گهٽ اثر پوي ٿو.

API درخواستن جي حقيقي دنيا جي جاچ ۽ بيحد لکڻ جي عمل

ڪوڊ کي موضوع ۾ وجھو. functions.php متبادل طور تي، پلگ ان کي ترتيب ڏيڻ کان پوءِ، توهان سڌو سنئون انٽرفيس ٽيسٽنگ ڪري سگهو ٿا.

جڏهن ڪنهن ٻاهرين سسٽم ڏانهن POST درخواست جمع ڪرائيندي، بس هن نئين فيلڊ کي JSON باڊي ۾ شامل ڪريو. هتي هڪ معياري JSON پيل لوڊ مثال آهي.

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

مٿي ڏنل ڳالهين تي ڌيان ڏيو. categories صف ۾ ٽي ڪيٽيگري ID شامل آهن. yoast_primary_category نمبر 45 کي واضح طور تي ان جي بنيادي درجي جي طور تي نامزد ڪيو ويو آهي. درخواست حاصل ڪرڻ تي، انٽرفيس هڪ ئي وقت ڪيٽيگري بائنڊنگ مڪمل ڪندو ۽ يوسٽ ڪور ميٽا ڊيٽا لکندو.

مون هڪ ويب سائيٽ تي هڪ اسٽريس ٽيسٽ ڪيو جنهن ۾ 10 مضمونن جو ڊيٽابيس هو، ۽ مسلسل 500 هڪجهڙائي درخواستن کي اڳتي وڌائڻ کان پوءِ به ڪو به ڊيٽا نقصان نه ٿيو. بريڊ ڪرمب پاٿ ڊس آرڊر جو مسئلو جيڪو مون کي ڊگهي عرصي کان پريشان ڪري رهيو هو، اسڪرپٽ جي هلڻ سان ئي مڪمل طور تي حل ٿي ويو.

اعليٰ سطح تي سوچڻ سان، آٽوميشن جو آخري مقصد ڊيٽا جي رستن تي بهتر ڪنٽرول حاصل ڪرڻ آهي.

ٽيڪنيڪل حل تيار ڪرڻ وقت، گھڻا ماڻهو صرف سڀ کان وڌيڪ سطحي طول و عرض تي ڌيان ڏين ٿا: "تعمير ڪري سگهجي ٿو".

جڏهن ته، جيڪو واقعي مواد جي اثاثن جي قيمت کي طئي ڪري ٿو اهو بنيادي سيمينٽڪ لوپ ۽ ڊيٽا رستن جي نفاست آهي. جنريٽو سرچ دور جي مڪمل آمد سان، صرف APIs کي بي ترتيب ڪاپي ڪرڻ ويب سائيٽن لاءِ ساخت جي تباهي جا ٻج پوکڻ جي برابر آهي.

ٽيڪنيڪل فن تعمير جي خوبصورتي ڪوڊ جي مقدار تي منحصر ناهي، پر اهم نوڊس تي ڪنٽرول جي درستگي تي منحصر آهي.

REST API ۾ Yoast مکيه ڪيٽيگري شامل ڪرڻ شايد ڪوڊ جون درجن يا ان کان وڌيڪ لائينون شامل ڪرڻ جي ڳالهه وانگر لڳي، پر اصل ۾، اهو توهان جي خودڪار مواد لاءِ هڪ ناقابلِ ٽٽل SEO ويليو اينڪر ٺاهيندو آهي.

بجلي جي تيز الگورتھم جي هن دور ۾، صرف بنيادي ميٽا ڊيٽا تي آخري ڪنٽرول يقيني بڻائي سگهي ٿو ته مواد سيمينٽڪ ويب ۾ مضبوطي سان بيٺو آهي.

هاڻي پنهنجو ڪوڊ ايڊيٽر کوليو ۽ هن ڪمزوري کي مڪمل طور تي درست ڪريو.

جيئن ته توهان هن وقت تائين پڙهيو آهي، جيڪڏهن توهان کي اهو مددگار لڳو، مهرباني ڪري ان کي پسند ڪريو ۽ شيئر ڪريو. جيڪڏهن توهان پهرين اپڊيٽ حاصل ڪرڻ چاهيو ٿا، ته توهان مون کي فالو پڻ ڪري سگهو ٿا!

منهنجو مضمون پڙهڻ لاءِ مهرباني. ايندڙ ڀيري ملنداسين.