Laporan otomatis semua post belum memiliki meta description bisa salah jika workflow membaca field yang tidak tersedia melalui REST API. Sebelum memperbarui banyak artikel WordPress, pastikan data yang dicari memang dapat diakses melalui endpoint, konteks, dan akun yang digunakan.
Saya menyarankan satu post pembanding yang isinya sudah diketahui. Cocokkan panel editor, respons API, nilai setelah penyimpanan, dan HTML publik. Empat lapisan ini membantu membedakan kekosongan konten dari kegagalan integrasi.
Buat peta field sebelum mengirim perubahan
Judul post, SEO title, excerpt, meta description, dan focus keyword tidak selalu merupakan field yang sama. Plugin dapat mempunyai penyimpanan serta aturan render sendiri. Focus keyword pada panel analisis juga tidak otomatis menjadi elemen HTML yang dibaca pengunjung.
Buat tabel dari implementasi aktual.
| Kebutuhan | Field pada editor | Jalur baca/tulis yang disepakati | Hasil publik yang diperiksa |
|---|---|---|---|
| Judul artikel | Title post | Field title pada endpoint post | Judul halaman yang dirender template |
| Judul pencarian | SEO title plugin | Field atau endpoint yang didukung integrasi | Elemen title |
| Ringkasan pencarian | Meta description plugin | Field atau endpoint yang didukung integrasi | meta name="description" |
| Kata fokus analisis | Focus keyword plugin | Penyimpanan yang terkonfirmasi | Biasanya dinilai sebagai input analisis plugin |
Isi nama field sebenarnya bersama developer. Jangan mengambil nama meta key dari tutorial lain lalu menganggap semua versi plugin dan post type sama.
WordPress menyediakan cara menambahkan field REST dan mengekspos meta yang terdaftar. register_rest_field dan registrasi meta dengan show_in_rest mempunyai mekanisme berbeda. Dukungan baca dan tulis perlu ditetapkan sesuai schema serta callback yang digunakan. Panduan memperluas respons REST WordPress.
Baca post yang sudah diketahui nilainya
Pilih satu post uji yang judul dan deskripsinya dapat diperiksa pada editor. Catat ID, post type, status, dan waktu perubahan terakhir. Gunakan akses yang memang diizinkan untuk pekerjaan tersebut.
Pada endpoint post standar, bentuk pemeriksaan dapat berupa:
GET /wp-json/wp/v2/posts/123?context=edit&_fields=id,modified_gmt,title,meta
Angka 123 adalah contoh ID, bukan target universal. Post type lain dapat memakai rute berbeda. Dokumentasi Posts menjelaskan field, konteks, dan operasi yang tersedia. Parameter _fields membatasi field respons; ia tidak membuat field yang belum terekspos menjadi tersedia. Referensi Posts, parameter global REST.
Autentikasi dan izin tetap diperlukan untuk operasi edit. WordPress mendokumentasikan Application Passwords untuk autentikasi API melalui HTTPS. Simpan kredensial pada pengelolaan secret proyek, bukan artikel, spreadsheet, atau prompt yang dibagikan. Autentikasi REST WordPress.
Jangan menyamakan field hilang dengan nilai kosong
Periksa apakah key ada dalam objek respons sebelum membaca nilainya. Contoh logika berikut hanya mengklasifikasikan hasil pembacaan; ia tidak mengubah WordPress.
function classifyField(object, key) {
if (!object || !Object.prototype.hasOwnProperty.call(object, key)) {
return "not_returned";
}
if (object[key] === null) return "null_value";
if (typeof object[key] !== "string") return "unexpected_type";
if (object[key].trim() === "") return "empty_string";
return "value_present";
}
Jika hasilnya not_returned, periksa endpoint, konteks, parameter pemilihan field, registrasi, dan izin. Jika empty_string, cocokkan dengan editor serta aturan default plugin. Jika nilainya ada, pastikan workflow tidak membaca jalur JSON yang berbeda.
Hasil scan yang menyebut seluruh post kosong, padahal satu post pembanding jelas terisi, merupakan alasan menghentikan batch dan memperbaiki pembacaan. Mengisi semua post pada keadaan itu berisiko menimpa materi yang sebenarnya sudah benar.
Uji satu perubahan dengan bukti sebelum dan sesudah
Setelah kontrak field jelas, siapkan usulan untuk satu post dan catat nilai awal. Gunakan prosedur dry run perubahan SEO massal agar daftar perbedaan dapat ditinjau.
Pada uji penerapan, kirim hanya field yang termasuk cakupan. Periksa status HTTP dan isi respons, lalu lakukan permintaan baca baru. Respons sukses dari permintaan pertama belum menggantikan pemeriksaan bahwa nilai tersimpan pada objek yang benar.
Bandingkan post ID, nilai field, waktu modifikasi, dan field lain yang tidak seharusnya ikut berubah. Jika orang lain mengedit sumber setelah snapshot dibuat, jangan menimpa perubahan itu dengan data lama.
Periksa HTML yang diterima pembaca
Metadata tersimpan dapat berbeda dari hasil publik karena template, variabel dinamis, filter plugin, atau cache. Rank Math, misalnya, mendokumentasikan filter frontend untuk title dan description. Itu alasan untuk memeriksa output akhir, bukan hanya panel. Filter metadata Rank Math.
Buka URL publik dalam kondisi pengunjung biasa. Periksa elemen title dan meta description pada HTML, termasuk apakah muncul lebih dari satu keluaran yang saling bertentangan. Jika nilai lama masih tampil, telusuri jalur render dan cache sebelum mengirim update berulang.
Gunakan kalimat status yang terpisah: nilai tersimpan benar, HTML publik sesuai, dan tampilan pencarian belum diperiksa. Mesin pencari dapat menampilkan judul atau snippet berbeda; perubahan field CMS bukan janji bahwa hasil pencarian segera menyalinnya.
Perluas setelah kontrak terbukti
Uji variasi yang relevan: nilai kosong, nilai manual, template default, karakter khusus, post type lain, dan artikel yang sedang diedit. Catat objek yang dilewati beserta alasannya.
Simpan cara memulihkan hanya perubahan milik batch tersebut. Setelah pemeriksaan lulus, perluas secara bertahap sambil menjaga daftar ID, versi input, field sebelum/sesudah, serta hasil baca kembali.
Pekerjaan ini selesai ketika tim dapat menunjukkan data apa yang dibaca, apa yang berubah, dan apa yang tampil. Skor plugin boleh menjadi petunjuk pemeriksaan, tetapi tidak menggantikan ketepatan isi atau bukti implementasi.
