Lewati ke konten

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 storage menambahkan lokasi penyimpanan tambahan; properti ini tidak menggantikan penyimpanan blok.

Konfigurasi

Tambahkan properti storage ke definisi field mana pun:

JSON
{
  "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

JSON
// Add post meta storage
"storage": {
  "type": "postMeta"
}

// Add both post meta and option storage
"storage": {
  "type": ["postMeta", "option"]
}

Cara Kerjanya

  1. Pendaftaran: Saat WordPress dimuat, Blockstudio mendaftarkan kunci meta dan pengaturan berdasarkan konfigurasi field Anda
  2. Pengeditan: Nilai dikelola sebagai atribut blok di editor (selalu disimpan di blok)
  3. 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

PHP
<div>
  <h1><?php echo $a['subtitle']; ?></h1>
</div>

Twig

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

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

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:

Shell
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

PHP
$company_name = get_option( 'site_company_name' );

Twig

Twig
{{ function('get_option', 'site_company_name') }}

Contoh

Kolom Meta SEO

Simpan data SEO di meta pos agar kompatibel dengan plugin SEO:

JSON
{
  "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"
        }
      }
    ]
  }
}

Tambahkan penyimpanan meta pos agar pos dapat dikueri berdasarkan nilai kolom:

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "featured",
        "type": "toggle",
        "label": "Featured",
        "storage": {
          "type": "postMeta",
          "postMetaKey": "is_featured"
        }
      }
    ]
  }
}

Kueri pos unggulan:

PHP
$featured_posts = get_posts([
  'meta_key'   => 'is_featured',
  'meta_value' => '1',
]);

Pengaturan Situs Global

Simpan konfigurasi seluruh situs di opsi:

JSON
{
  "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:

PHP
<footer>
  <p>&copy; <?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:

JSON
{
  "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.