CMS bloklarını dinamik eklenti verilerine bağlayın

Katalog, ticaret, etkinlik veya haber eklentisi yararlı alan verilerinin sahibi olabilir. Bu, o veriyi sunan sayfa yerleşiminin ve herkese açık HTML yapısının da sahibi olması gerektiği anlamına gelmez.

WebBlocks CMS içerik kaynakları bu sorumlulukları ayırır. Eklenti türlendirilmiş kayıtlar sunar; editörler bu kayıtları tanıdıkları CMS blok alanlarına bağlar. Kompozisyon, çeviri, önizleme ve görüntüleme kontrolü sayfada kalır.

İçerik kaynağı hangi verinin kullanılabilir olduğunu cevaplar. Blok bu verinin nasıl sunulacağını cevaplar. Sayfa ve alan ağacı ise nerede görüneceğini cevaplar.

Bu sayede eklenti, ayrı bir görüntüleme sistemi dağıtmak yerine çekirdekteki Header, Rich Text, Image, Button, Link List, Grid, Stack ve Slider davranışlarını yeniden kullanabilir.

Desteklenen bir bloğu düzenleyip Settings sekmesini açın. Content source altında, uyumlu her alan Block Fields bölümüne girilen sabit değeri koruyabilir veya bir eklenti kaynağı, kararlı bir kayıt ve tanımlı bir alan seçebilir.

Örneğin Header başlığı bir katalog kaydının metin alanına bağlanabilir. Editörler ilişkiyi listeden seçer; elle bağlama ifadesi yazılmaz.

Blokta saklanan özgün değer önemini korur: Bu, editoryal yedek değerdir. Eklenti devre dışı kalırsa, kaynak kaybolursa, kayıt çözümlenemezse veya çözümlenen değer boşsa herkese açık sayfa saklanan editoryal değeri göstermeye devam eder.

Koleksiyon kaynakları kayıt listelerini işler. Grid veya Stack gibi koleksiyon destekli bir kapsayıcı ekleyin, doğrudan alt öğelerinden birini görsel şablon olarak oluşturun; ardından koleksiyonu ve tekrarlanacak alt öğeyi seçin.

Kayıt sınırı belirleyebilir, tanımlı bir alana göre filtreleyebilir, iki yönde sıralayabilir ve boş sonuçta veya çözümleyici hatasında şablonun gizlenmesini ya da editoryal yedek içeriğin gösterilmesini seçebilirsiniz.

Seçilen şablonun içindeki desteklenen bir alt bloğu açın. Content source seçenekleri artık Current collection item içerir. Başlığı, açıklamayı, görseli veya bağlantıyı mevcut kaydın uyumlu alanlarına bağlayın.

Görüntüleme sırasında CMS, çözümlenen her kayıt için şablon alt ağacını bir kez çoğaltır ve o kaydı mevcut öğe olarak sağlar. Kapsayıcıdaki diğer alt öğeler elle hazırlanmış editoryal içerik olarak kalır ve konumlarını korur.

Tekil kayıt bağlamaları şu alanları kapsar: Header başlıkları; Plain Text ve Rich Text içeriği; Image kaynağı, açıklaması, alternatif metni ve bağlantısı; Button ve Button Link etiketleri ve URL’leri; Link List Item başlığı, ikincil metni, açıklaması ve URL’si.

Koleksiyon desteği sözleşmeye dayanır. Çekirdekteki Section, Container, Stack, Cluster, Grid ve Slide geçerli doğrudan alt öğelerini tekrarlayabilir. Slider, Slide tekrarlar; Columns, Column Item tekrarlar; Feature Grid, Feature Item veya Column Item tekrarlar; Link List ise Link List Item tekrarlar. Geçersiz kompozisyon oluşturacak yapısal kapsayıcılar koleksiyon desteği sunmaz.

Etkin bir eklenti, ad alanına sahip bir tanıtıcı, çözümleyici ve türlendirilmiş alan tanımlarıyla tekil kayıt veya koleksiyon kaynağı kaydeder. Tekil kayıt çözümleyicileri editöre güvenli seçimler ve kararlı bir anahtar için bir kayıt döndürür. Koleksiyon çözümleyicileri yinelenebilir kayıtlar döndürür. Büyük kaynaklar sorgulanabilir sözleşmeyi uygulayarak filtreleme, sıralama, sınırlar, toplamlar ve sayfalama aralıklarını veritabanında veya üst sistemin API’sinde tutabilir.

Kısıtlı veriye erişim politikası eklenebilir. Kaynaklar sınırlı önbellekleme kullanabilir ve alan verilerine yazıldıktan sonra önbellekteki sürümlerini geçersiz kılabilir. Çözümleyici çıktısı CMS’nin yetkili veri kaynağına dönüşmez: Revizyonlar ve aktarımlar çalıştırılmış çıktıyı değil, bağlama yapılandırmasını ve normal editoryal yedek değeri saklar.

Bu tasarımın yararı yalnızca verinin dinamik olabilmesi değildir; hata davranışının açık olmasıdır. Eksik kayıtlar, devre dışı eklentiler, erişim reddi, boş koleksiyonlar ve çözümleyici istisnaları sayfayı erişilemez hale getirmek zorunda değildir.

Editörler görünür bir yedek içerik tutar; Settings paneli eksik kaynakları veya alanları bildirir. Entegrasyon onarılırken herkese açık sayfa oluşturucu tutarlı içerik sunmaya devam edebilir.

Geliştirici sözleşmelerinin ve Internal Content API biçimlerinin tamamı için Content Sources and Block Field Bindings belgesini okuyun.