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_querykullanarak 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:
{
"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
// Add post meta storage
"storage": {
"type": "postMeta"
}
// Add both post meta and option storage
"storage": {
"type": ["postMeta", "option"]
}
Nasıl Çalışır
- Kayıt: WordPress yüklendiğinde Blockstudio, alan yapılandırmalarınıza göre meta anahtarlarını ve ayarları kaydeder
- Düzenleme: Değerler düzenleyicide blok özellikleri olarak yönetilir (her zaman blokta saklanır)
- 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
<div>
<h1><?php echo $a['subtitle']; ?></h1>
</div>
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
// 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) }}
Yazı meta verilerine REST API üzerinden de erişilebilir:
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
$company_name = get_option( 'site_company_name' );
Twig
{{ function('get_option', 'site_company_name') }}
Örnekler
SEO Meta Alanları
SEO verilerini SEO eklentileriyle uyumluluk için yazı meta verilerinde saklayın:
{
"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"
}
}
]
}
}
Öne Çıkan İçerikleri Sorgulama
Yazıları alan değerine göre sorgulayabilmek için yazı meta verisi depolamayı ekleyin:
{
"blockstudio": {
"attributes": [
{
"id": "featured",
"type": "toggle",
"label": "Featured",
"storage": {
"type": "postMeta",
"postMetaKey": "is_featured"
}
}
]
}
}
Öne çıkan yazıları sorgulayın:
$featured_posts = get_posts([
'meta_key' => 'is_featured',
'meta_value' => '1',
]);
Genel Site Ayarları
Site genelindeki yapılandırmayı seçeneklerde saklayın:
{
"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:
<footer>
<p>© <?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:
{
"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.