Sinkronisasi Konten
Blockstudio dirancang dengan alur kerja file-first: blok, field, templat, aset, pola, dan halaman berbasis file dapat disimpan di proyek Anda. Sinkronisasi Konten memperluas model tersebut ke konten basis data WordPress pilihan bagi tim yang juga ingin menyimpan posting, istilah, relasi, dan metadata yang dideklarasikan secara terkurasi di git.
Ini adalah alur kerja WP-CLI, bukan replikasi basis data langsung. Saat menarik, Sinkronisasi Konten memproyeksikan posting, postmeta, istilah, termmeta, dan relasi post-term yang diizinkan ke file portabel di tema Anda. Saat mengirim, fitur ini menerapkan file tersebut ke lingkungan lain menggunakan UID stabil dan hanya menulis ulang referensi yang Anda deklarasikan secara eksplisit.
Catatan
Sinkronisasi Konten berjalan sesuai permintaan. Fitur ini tidak berjalan pada setiap permintaan admin. Perintah mengembalikan baris yang dilewati sampai
content.enabledberstatustrue.
Kapan Menggunakan Sinkronisasi Konten
Gunakan Sinkronisasi Konten untuk kumpulan konten yang penting untuk diberi versi, ditinjau, dan dipindahkan antarlingkungan:
- konten terstruktur seperti anggota tim, lokasi, studi kasus, produk, entri dokumentasi, atau halaman kampanye
- taksonomi dan relasi yang terkait dengan kumpulan konten tersebut
- metadata yang diizinkan, aman untuk di-commit, dan memerlukan referensi stabil
- kumpulan konten kecil hingga sedang yang file-nya masih praktis untuk ditinjau di git
Sebagai pedoman umum, Sinkronisasi Konten cocok untuk puluhan atau ratusan baris, dan dapat menangani hingga beberapa ribu jika datanya terstruktur, jarang berubah, dan dibagi ke dalam jenis post yang terfokus. Fitur ini tidak ditujukan untuk mencerminkan seluruh basis data produksi, konten editorial dengan lalu lintas tinggi, log, pesanan, analitik, pengiriman formulir, sesi, atau data bervolume tinggi maupun sering berubah lainnya. Jika file yang dihasilkan terlalu ramai untuk ditinjau, push terlalu sulit dianalisis, atau sebagian besar baris berubah di luar alur kerja deployment Anda, gunakan alat pencadangan, migrasi, atau impor/ekspor basis data.
Berkas biner media tidak disalin. Referensi lampiran dapat dicatat dalam manifest dan divalidasi, tetapi berkasnya sendiri harus sudah ada di lingkungan target.
Konfigurasi
Aktifkan Sinkronisasi Konten di blockstudio.json:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"content": {
"enabled": true,
"id": "default",
"path": "content",
"includePageSyncManaged": false,
"authors": "ignore",
"postTypes": ["team_member"],
"meta": {
"include": ["_my_*"],
"exclude": ["_edit_lock", "_edit_last", "_wp_old_slug"],
"references": {
"_thumbnail_id": { "kind": "attachment" },
"_related_posts": { "kind": "post", "path": "*" },
"_hero": { "kind": "attachment", "path": "image.id" }
}
},
"taxonomies": [],
"media": "manifest"
}
}
postTypes adalah daftar izin. Jika kosong, Sinkronisasi Konten tidak menyentuh posting. taxonomies adalah daftar izin berisi taksonomi yang sudah terdaftar, dengan istilah dan relasi posting yang perlu disinkronkan. Blockstudio tidak mendaftarkan definisi taksonomi dari file Sinkronisasi Konten. Postmeta dan termmeta diizinkan melalui meta.include; meta.exclude selalu diutamakan.
Peringatan
Perlakukan
meta.includesebagai batas commit. File yang disinkronkan dimaksudkan untuk disimpan di git, jadi jangan sertakan kunci yang menyimpan rahasia, token, kredensial, atau PII.wp bs content statusmelaporkan baris peringatan saat kunci meta yang diizinkan tampak sensitif.
content.id disimpan pada entitas yang disinkronkan sebagai _blockstudio_content_set. Pemeriksaan pemangkasan dan kepemilikan dibatasi pada nilai tersebut, sehingga satu kumpulan konten tidak dapat menghapus konten milik kumpulan lain.
Posting yang dikelola Sinkronisasi Halaman dikecualikan secara default. Jika includePageSyncManaged diaktifkan, Sinkronisasi Konten dapat menyinkronkan meta yang dikonfigurasikan untuk posting tersebut, tetapi Sinkronisasi Halaman tetap mengelola post_content-nya.
Proyeksi ini berisi "bodyOwner": "page-sync". Pull melaporkan penulisan JSON sebagai hanya metadata dan menambahkan baris isi skipped, alih-alih menampilkan pos seolah-olah isinya kosong. Tindakan ini tidak menulis atau menghapus berkas .html yang menyertai. Salinan tinjauan yang sudah ada dipertahankan dan diabaikan oleh push. Pesan kepemilikan yang sama disertakan dalam keluaran dry-run.
Di lingkungan lain, jalankan Page Sync terlebih dahulu. Proyeksi dengan
bodyOwner: "page-sync" harus merujuk ke kiriman terkelola Page Sync yang sudah ada;
push menolak membuat pengganti kosong atau menerapkan salinan tinjauan dari isi tersebut.
Proyeksi tanpa penanda dari versi lama tetap didukung.
Penulis diabaikan secara default karena pengguna tidak disinkronkan. Atur authors: "login" untuk menyimpan login penulis dalam file post dan mencocokkan login tersebut dengan pengguna yang sudah ada saat push. Pengguna yang tidak ditemukan menyebabkan kesalahan prapemeriksaan; Sinkronisasi Konten tidak membuat pengguna.
Perintah
wp bs content pull [--post-type=<type>] [--taxonomy=<taxonomy>] [--dry-run]
wp bs content push [--dry-run] [--prune] [--yes]
wp bs content status
pull menangkap konten basis data ke dalam file. Fitur ini menetapkan _blockstudio_content_uid pada posting dalam cakupan yang belum memilikinya dan melaporkan file usang yang sumber basis datanya sudah tidak ada. File usang tidak dihapus saat pull.
push menerapkan file ke basis data saat ini. Fitur ini memvalidasi rencana sebelum menulis dan memblokir referensi yang dideklarasikan tetapi belum terselesaikan, konflik slug, entitas terkunci, serta jenis post yang tidak ditemukan.
status membandingkan file dengan basis data dan melaporkan setiap entitas sebagai unchanged, would-update, missing-db, conflict, locked, atau orphaned. Fitur ini juga memperingatkan tentang kunci meta yang diizinkan dan tampak seperti rahasia sebelum nilainya di-commit, serta tentang ID numerik di dalam badan markup blok karena Sinkronisasi Konten tidak menulis ulang ID dalam file .html.
Gunakan --dry-run untuk memeriksa pull atau push tanpa menulis. Gunakan push --prune --yes untuk menghapus entitas basis data milik kumpulan konten yang sudah tidak ada di dalam file.
Keamanan saat terjadi kegagalan
push mengurai dan memvalidasi seluruh rencana sumber sebelum menulis atau memangkas. JSON yang formatnya salah, referensi yang dideklarasikan tetapi belum terselesaikan, kepemilikan yang tidak valid, dan kegagalan prapemeriksaan lainnya akan memblokir fase destruktif. Pemangkasan tetap dibatasi pada jenis post, taksonomi, dan content.id yang dikonfigurasi.
pull menulis setiap file hasil proyeksi sebelum mencatat entitas tersebut sebagai tersinkron. Kegagalan penulisan sistem file dikembalikan sebagai baris kesalahan dan tidak memperbarui state sinkronisasi tersimpan untuk entitas tersebut.
Penanganan lampiran mengikuti content.media. Dengan "manifest", UID lampiran yang dirujuk harus ada di lingkungan target. Dengan "none", referensi lampiran yang dideklarasikan sengaja dihapus dari output portabel, bukan mempertahankan ID khusus lingkungan.
File
Content Sync menulis file di bawah content.path yang dikonfigurasi:
content/
posts/
team_member/
jane.9b1c0e6e.json
jane.9b1c0e6e.html
terms/
category/
leadership.5e900000.json
media/
manifest.json
File .json untuk post menyimpan identitas, kolom post, relasi term, meta yang dideklarasikan, dan pengodean meta. File .html di sebelahnya menyimpan post_content sebagai markup blok mentah dan tidak disertakan jika kontennya kosong. File .json untuk term menyimpan identitas, taksonomi, slug, nama, deskripsi, UID induk, termmeta yang dideklarasikan, dan pengodean meta.
Kasus lain tanpa file .html adalah isi yang dimiliki Page Sync, yang diidentifikasi oleh
bodyOwner di atas. Untuk kiriman biasa yang isinya menjadi kosong, pull menghapus
file isi lama dan mencantumkannya dalam baris isi deleted yang terpisah.
{
"uid": "9b1c0e6e-0000-4000-9000-000000000000",
"type": "team_member",
"status": "publish",
"slug": "jane",
"title": "Jane",
"parent": null,
"menuOrder": 0,
"terms": {
"category": ["5e900000-0000-4000-9000-000000000000"]
},
"meta": {
"_my_subtitle": "Creative Director",
"_thumbnail_id": "a1b2c3d4-0000-4000-9000-000000000000"
},
"metaEncoding": {
"_my_subtitle": "scalar",
"_thumbnail_id": "scalar"
}
}
Status sinkronisasi yang disimpan adalah:
| Kunci meta | Tujuan |
|---|---|
_blockstudio_content_uid |
Identitas konten portabel |
_blockstudio_content_set |
Namespace set konten dari content.id |
_blockstudio_content_source |
Jalur file sumber relatif terhadap tema |
_blockstudio_content_fingerprint |
Sidik jari file/database terakhir yang disinkronkan |
_blockstudio_content_locked |
Nilai truthy mencegah push menimpa entitas |
Referensi
Content Sync tidak pernah menganggap bilangan bulat sebagai ID. Referensi hanya ditulis ulang jika dikonfigurasi di meta.references.
{
"meta": {
"references": {
"_related_posts": { "kind": "post", "path": "*" },
"_topic": { "kind": "term" },
"_hero": { "kind": "attachment", "path": "image.id" }
}
}
}
Saat pull, ID lokal pada jalur tersebut menjadi UID portabel. Saat push, UID tersebut dipetakan kembali ke ID lokal di database saat ini.
Induk post, induk term, dan relasi post-term adalah referensi struktural yang dikelola Content Sync dan disimpan sebagai UID secara otomatis. Taksonomi yang dikonfigurasi ditulis ke file post meskipun kosong; array kosong akan menghapus relasi taksonomi tersebut saat push.
Referensi lampiran divalidasi, bukan diimpor. Dengan media: "manifest", lampiran yang dirujuk dicantumkan di content/media/manifest.json; push mengharuskan UID lampiran yang dirujuk tersedia secara lokal. Dengan media: "none", referensi lampiran yang dideklarasikan tidak disertakan dalam file portabel. Karena kunci yang tidak disertakan tidak diterapkan saat push, post target yang sudah ada tetap menyimpan meta lampiran saat ini.
Alur Kerja Portabilitas
- Daftarkan jenis post target di setiap lingkungan.
- Konfigurasikan
content.postTypes,meta.include, dan semua referensi yang dideklarasikan. - Jalankan
wp bs content pulldi lingkungan sumber. - Commit file yang dihasilkan.
- Jalankan
wp bs content pushdi lingkungan target. - Jalankan
wp bs content statusuntuk memverifikasi bahwa database sesuai dengan file.
File adalah sumber kebenaran untuk push. Database ditangkap kembali ke file dengan pull.
Cakupan
Content Sync mendukung:
- post dari jenis post yang diizinkan
- postmeta yang diizinkan
- term dari taksonomi terdaftar yang diizinkan
- termmeta yang diizinkan
- relasi post-term
- referensi
post,attachment, dantermyang dideklarasikan - UID post dan term portabel serta kepemilikan set konten
- pengecualian Page Sync secara default
- manifes lampiran dan validasi prapemeriksaan
- penanganan
pull,push,status,--dry-run,--prune, dan entitas terkunci
Perekaman definisi taksonomi, penyalinan berkas biner media, dan penulisan ulang ID markup blok tidak didukung.