İçeriğe geç

Depolama

Varsayılan olarak tüm alan değerleri, yazı içeriğindeki blok yorumunun içinde blok öznitelikleri olarak depolanır. Depolama özelliği, değerleri ayrıca yazı meta verilerinde (wp_postmeta) veya seçeneklerde (wp_options) saklamanıza olanak tanır; böylece blok bağlamının dışında da erişilebilir olurlar.

Depolamayı Neden Kullanmalı?

Blok öznitelikleri, yazı içeriğindeki HTML yorumlarının içinde saklandığından yalnızca blok içeriği ayrıştırıldığında erişilebilir. Ek depolama konumları kullanarak şunları yapabilirsiniz:

  • meta_query kullanarak yazıları alan değerlerine göre sorgulama
  • Başsız kurulumlarda değerlere REST API aracılığıyla erişme
  • SEO veya önbellekleme eklentileri gibi diğer eklentilerle veri paylaşma
  • Yazılar arasında geçerliliğini koruyan genel ayarlar oluşturma

Depolama Türleri

Tür Konum Kapsam En Uygun Kullanım
postMeta wp_postmeta tablosu Yazı başına Sorgulanabilir, yazıya özgü veriler
option wp_options tablosu Genel (site çapında) Site ayarları, paylaşılan değerler

Not

Blok özniteliklerinin depolanması (yazı içeriğindeki HTML yorumunda) her zaman otomatik olarak gerçekleşir. storage özelliği ek depolama konumları sağlar; blok depolamasının yerini almaz.

Yapılandırma

Herhangi bir alan tanımına storage özelliğini ekleyin:

JSON
{
  "name": "blockstudio/example",
  "title": "Example Block",
  "blockstudio": {
    "attributes": [
      {
        "id": "subtitle",
        "type": "text",
        "label": "Subtitle",
        "storage": {
          "type": "postMeta",
          "postMetaKey": "my_subtitle"
        }
      }
    ]
  }
}

Depolama Özellikleri

Özellik Tür Açıklama
type string | string[] Ek depolama location(s): "postMeta", "option"
postMetaKey string Özel meta anahtarı (varsayılan: {block_name}_{field_id})
optionKey string Özel seçenek anahtarı (varsayılan: {block_name}_{field_id})

Tekli ve Çoklu Depolama

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

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

Nasıl Çalışır

  1. Kayıt: WordPress yüklendiğinde Blockstudio, alan yapılandırmalarınıza göre meta anahtarlarını ve ayarları kaydeder
  2. Düzenleme: Değerler düzenleyicide blok özellikleri olarak yönetilir (her zaman blokta saklanır)
  3. Kaydetme: Yazı kaydedildiğinde yazı meta verileri eşitlenir. Site seçenekleri, yazı yayımlandığında veya yayımlanmış bir yazının alan değeri değiştiğinde eşitlenir.

Otomatik kaydetmeler ve sürümler, her iki depolama konumunu da eşitlemez. Taslak, beklemede olan, özel ve zamanlanmış yazılar kendi yazı meta verilerini güncelleyebilir ancak canlı site seçeneklerini değiştirmez. Zamanlanmış bir yazı, WordPress onu yayımladığında seçenekleri eşitler.

Değerler; ters eğik çizgiler, tırnak işaretleri ve iç içe geçmiş tekrarlayıcı değerleri dâhil olmak üzere olduğu gibi kopyalanır. WordPress meta depolamasını telafi etmek için alan değerlerine kaçış karakterleri eklemeyin; bu sınırı Blockstudio yönetir. Site seçenekleri, ek kaçış karakterleri olmadan aynı değerleri olduğu gibi korur.

Önceki bir sürüm yazı meta kopyasındaki ters eğik çizgileri sildiyse yükseltmeden sonra yazıyı yeniden kaydedin. Meta kopyasını yenilemek için blok özniteliklerindeki özgün alan değeri kullanılır.

Site Seçeneklerini Kaydetme

Seçenekler sitenin tamamında paylaşılır. Yeni bir bloğu yayımlamak, kaydedilmiş özniteliklerinde bulunan seçenek alanlarını yazar. Sonraki kaydetmelerde her alan, bloğun önceki kaydedilmiş sürümüyle karşılaştırılır ve yalnızca değişen değerler yazılır. Bir yazının başlığını kaydetmek veya başka bir yazıdaki bloğun değişmemiş eski bir kopyasını kaydetmek, daha yeni bir seçenek değerinin üzerine yazmaz.

Kaydedilen özniteliklerde yer almayan bir alan, seçeneğini olduğu gibi bırakır. Bu, block.json için yeni bir alan eklendiğinde mevcut seçenekleri de korur. Açıkça belirtilen bir null seçeneği siler; boş dizeler, false, 0 ve boş diziler değer olarak kaydedilir. Bir bloğu kaldırmak seçeneklerini silmez.

Paylaşılan her seçeneği yönetmek için yayımlanmış tek bir blok belirleyin. Birden fazla blok aynı seçeneği bilerek değiştirirse, kaydedilen son değişiklik kazanır. Depolama, geçerli seçeneği her bloğa yüklemez: her blok kendi alan değerlerini yazı içeriğinde tutar.

Dosya tabanlı sayfalarda kalıcı bir blok key, Blockstudio belgenin içinde taşındıktan sonra aynı bloğu tanımasını sağlar. Anahtarı olmayan bloklar, blok adına ve konumuna göre eşleştirilir.

Saklanan Değerlere Erişme

Blok Şablonlarında

Blok şablonunuzda alan değerlerine her zaman $attributes üzerinden erişebilirsiniz:

PHP

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

Twig

Twig
<div>
  <h1>{{ a.subtitle }}</h1>
</div>

Yazı Meta Verileri (Blok Bağlamının Dışında)

postMeta içinde saklanan değerlere WordPress’in herhangi bir yerinden erişilebilir:

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) }}

Yazı meta verilerine REST API üzerinden de erişilebilir:

Kabuk
GET /wp-json/wp/v2/posts/123
# Response includes: { "meta": { "my_subtitle": "Hello World" } }

Seçenekler (Genel Değerler)

option içinde saklanan değerlere sitenin tamamından erişilebilir:

PHP

PHP
$company_name = get_option( 'site_company_name' );

Twig

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

Örnekler

SEO Meta Alanları

SEO verilerini SEO eklentileriyle uyumluluk için yazı meta verilerinde saklayın:

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

Yazıları alan değerine göre sorgulayabilmek için yazı meta verisi depolamayı ekleyin:

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

Öne çıkan yazıları sorgulayın:

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

Genel Site Ayarları

Site genelindeki yapılandırmayı seçeneklerde saklayın:

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

Sitenizin herhangi bir yerinden erişin:

PHP
<footer>
  <p>&copy; <?php echo get_option( 'site_company_name' ); ?></p>
  <p>Contact: <?php echo get_option( 'site_support_email' ); ?></p>
</footer>

Yazı Meta Verisi ve Seçenek

Hem yazı düzeyinde hem de genel erişilebilir olması gereken veriler için:

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "important_value",
        "type": "text",
        "label": "Important Value",
        "storage": {
          "type": ["postMeta", "option"],
          "postMetaKey": "important_meta",
          "optionKey": "important_option"
        }
      }
    ]
  }
}

Varsayılan Anahtar Adları

Özel bir anahtar belirtmezseniz Blockstudio otomatik olarak bir tane oluşturur:

Depolama Türü Varsayılan Anahtar Biçimi Örnek
postMeta {block_name}_{field_id} blockstudio_example_subtitle
option {block_name}_{field_id} blockstudio_example_subtitle

Blok adı, eğik çizgiler alt çizgilerle değiştirilerek temizlenir.

Uyarı

Üretim ortamında özel anahtarlar kullanmanız önerilir. Bloğunuzu yeniden adlandırırsanız varsayılan anahtarlar değişebilir.