Penyimpanan
Secara default, semua nilai field disimpan sebagai atribut blok di dalam komentar blok pada konten postingan. Fitur penyimpanan memungkinkan Anda menyimpan nilai tambahan di meta postingan (wp_postmeta) atau opsi (wp_options), sehingga nilai tersebut dapat diakses di luar konteks blok.
Mengapa Menggunakan Penyimpanan?
Atribut blok disimpan di dalam komentar HTML pada konten postingan, artinya atribut tersebut hanya dapat diakses saat konten blok diurai. Dengan menggunakan lokasi penyimpanan tambahan, Anda dapat:
- Mencari postingan berdasarkan nilai field menggunakan
meta_query - Mengakses nilai melalui REST API untuk penyiapan tanpa kepala
- Berbagi data dengan plugin lain seperti SEO atau plugin caching
- Membuat pengaturan global yang tetap tersimpan di berbagai postingan
Jenis Penyimpanan
| Jenis | Lokasi | Cakupan | Cocok Untuk |
|---|---|---|---|
postMeta |
Tabel wp_postmeta |
Per postingan | Data khusus postingan yang dapat dikueri |
option |
Tabel wp_options |
Global (seluruh situs) | Pengaturan situs, nilai bersama |
Catatan
Penyimpanan atribut blok (dalam komentar HTML pada konten postingan) selalu dilakukan secara otomatis. Properti
storagemenambahkan lokasi penyimpanan tambahan; properti ini tidak menggantikan penyimpanan blok.
Konfigurasi
Tambahkan properti storage ke definisi field mana pun:
{
"name": "blockstudio/example",
"title": "Example Block",
"blockstudio": {
"attributes": [
{
"id": "subtitle",
"type": "text",
"label": "Subtitle",
"storage": {
"type": "postMeta",
"postMetaKey": "my_subtitle"
}
}
]
}
}
Properti Penyimpanan
| Properti | Tipe | Deskripsi |
|---|---|---|
type |
string | string[] |
Lokasi location(s) tambahan: "postMeta", "option" |
postMetaKey |
string |
Kunci meta khusus (default: {block_name}_{field_id}) |
optionKey |
string |
Kunci opsi khusus (default: {block_name}_{field_id}) |
Penyimpanan Tunggal vs Beberapa Lokasi
// Add post meta storage
"storage": {
"type": "postMeta"
}
// Add both post meta and option storage
"storage": {
"type": ["postMeta", "option"]
}
Cara Kerjanya
- Pendaftaran: Saat WordPress dimuat, Blockstudio mendaftarkan kunci meta dan pengaturan berdasarkan konfigurasi field Anda
- Pengeditan: Nilai dikelola sebagai atribut blok di editor (selalu disimpan di blok)
- Penyimpanan: Meta postingan disinkronkan saat postingan disimpan. Opsi situs disinkronkan saat postingan diterbitkan atau saat nilai field pada postingan terbit berubah.
Simpan otomatis dan revisi tidak menyinkronkan kedua lokasi penyimpanan. Postingan draf, tertunda, privat, dan terjadwal dapat memperbarui meta postingannya sendiri, tetapi tidak mengubah opsi situs aktif. Postingan terjadwal menyinkronkan opsi saat WordPress menerbitkannya.
Nilai disalin apa adanya, termasuk garis miring terbalik, tanda kutip, dan nilai repeater bertingkat. Jangan menambahkan escape pada nilai bidang untuk mengompensasi penyimpanan meta WordPress; Blockstudio menangani batas tersebut. Opsi situs mempertahankan nilai apa adanya tanpa penambahan garis miring.
Jika versi sebelumnya menghapus garis miring terbalik dari salinan meta sebuah pos, simpan kembali pos tersebut setelah pemutakhiran. Nilai bidang asli dalam atribut bloknya digunakan untuk memperbarui salinan meta.
Menyimpan Opsi Situs
Opsi dibagikan ke seluruh situs. Menerbitkan blok baru akan menulis field opsi yang disediakan dalam atribut tersimpannya. Penyimpanan berikutnya membandingkan setiap field dengan versi tersimpan sebelumnya dari blok tersebut dan hanya menulis nilai yang berubah. Menyimpan judul postingan, atau salinan lama blok yang tidak berubah pada postingan lain, tidak akan menimpa nilai opsi yang lebih baru.
Kolom yang tidak disertakan dalam atribut tersimpan tidak mengubah opsinya. Ini juga melindungi opsi yang sudah ada saat kolom baru ditambahkan ke block.json. null yang eksplisit menghapus opsi; string kosong, false, 0, dan array kosong disimpan sebagai nilai. Menghapus blok tidak menghapus opsinya.
Gunakan satu blok terbitan yang ditetapkan untuk mengelola setiap opsi bersama. Jika beberapa blok sengaja mengubah opsi yang sama, nilai terakhir yang diubah dan disimpan akan berlaku. Penyimpanan tidak memuat opsi saat ini ke setiap blok: setiap blok mempertahankan nilai kolomnya sendiri dalam konten pos.
Untuk halaman berbasis file, blok persisten key memungkinkan Blockstudio mengenali blok yang sama setelah dipindahkan dalam dokumen. Blok tanpa kunci dicocokkan berdasarkan nama dan posisi blok.
Mengakses Nilai Tersimpan
Di Templat Blok
Di dalam templat blok, nilai kolom selalu tersedia melalui $attributes:
PHP
<div>
<h1><?php echo $a['subtitle']; ?></h1>
</div>
Twig
<div>
<h1>{{ a.subtitle }}</h1>
</div>
Meta Pos (Di Luar Konteks Blok)
Nilai yang disimpan di postMeta dapat diakses di mana saja di WordPress:
PHP
// Get meta value
$subtitle = get_post_meta( $post_id, 'my_subtitle', true );
// Query posts by meta value
$posts = get_posts([
'meta_key' => 'my_subtitle',
'meta_value' => 'Hello World',
]);
Twig
{# Using Timber #}
{{ post.meta('my_subtitle') }}
{# Or via function #}
{{ function('get_post_meta', post.id, 'my_subtitle', true) }}
Meta pos juga tersedia melalui REST API:
GET /wp-json/wp/v2/posts/123
# Response includes: { "meta": { "my_subtitle": "Hello World" } }
Opsi (Nilai Global)
Nilai yang disimpan di option dapat diakses di seluruh situs:
PHP
$company_name = get_option( 'site_company_name' );
Twig
{{ function('get_option', 'site_company_name') }}
Contoh
Kolom Meta SEO
Simpan data SEO di meta pos agar kompatibel dengan plugin SEO:
{
"blockstudio": {
"attributes": [
{
"id": "seo_title",
"type": "text",
"label": "SEO Title",
"storage": {
"type": "postMeta",
"postMetaKey": "_yoast_wpseo_title"
}
},
{
"id": "seo_description",
"type": "textarea",
"label": "Meta Description",
"storage": {
"type": "postMeta",
"postMetaKey": "_yoast_wpseo_metadesc"
}
}
]
}
}
Konten Unggulan dengan Kueri
Tambahkan penyimpanan meta pos agar pos dapat dikueri berdasarkan nilai kolom:
{
"blockstudio": {
"attributes": [
{
"id": "featured",
"type": "toggle",
"label": "Featured",
"storage": {
"type": "postMeta",
"postMetaKey": "is_featured"
}
}
]
}
}
Kueri pos unggulan:
$featured_posts = get_posts([
'meta_key' => 'is_featured',
'meta_value' => '1',
]);
Pengaturan Situs Global
Simpan konfigurasi seluruh situs di opsi:
{
"blockstudio": {
"attributes": [
{
"id": "company_name",
"type": "text",
"label": "Company Name",
"storage": {
"type": "option",
"optionKey": "site_company_name"
}
},
{
"id": "support_email",
"type": "text",
"label": "Support Email",
"storage": {
"type": "option",
"optionKey": "site_support_email"
}
}
]
}
}
Akses dari mana saja di situs Anda:
<footer>
<p>© <?php echo get_option( 'site_company_name' ); ?></p>
<p>Contact: <?php echo get_option( 'site_support_email' ); ?></p>
</footer>
Meta Pos dan Opsi
Untuk data yang perlu dapat diakses pada tingkat pos maupun secara global:
{
"blockstudio": {
"attributes": [
{
"id": "important_value",
"type": "text",
"label": "Important Value",
"storage": {
"type": ["postMeta", "option"],
"postMetaKey": "important_meta",
"optionKey": "important_option"
}
}
]
}
}
Nama Kunci Default
Jika Anda tidak menentukan kunci khusus, Blockstudio akan membuatnya secara otomatis:
| Jenis Penyimpanan | Format Kunci Default | Contoh |
|---|---|---|
postMeta |
{block_name}_{field_id} |
blockstudio_example_subtitle |
option |
{block_name}_{field_id} |
blockstudio_example_subtitle |
Nama blok disanitasi (garis miring diganti dengan garis bawah).
Peringatan
Kunci khusus disarankan untuk penggunaan produksi. Kunci default dapat berubah jika Anda mengganti nama blok.