Editoryal içerik ve uygulama verileri aynı sayfada

Bir günlük sayfasında çoğu zaman iki tür içerik bulunur. Editör giriş metnini yazar ve sayfanın nasıl okunacağına karar verir. Aşağıdaki başlık ve açıklamalar ise değişen bir kayıt listesinden gelir.

Bu kayıtları sayfa bloklarına kopyalamak, onları güncel tutmanız gereken ikinci bir yer oluşturur. Sayfanın tamamını veri akışına dönüştürmek ise editoryal giriş ve kompozisyon üzerindeki kontrolü azaltır. WebBlocks CMS içerik kaynakları, hangi alanların kaynağı izleyeceğini seçmenize ve sayfanın kalanını düzenlenebilir tutmanıza olanak verir.

Bu örnekte WebBlocks CMS 1.90.2 kullanan, kurgusal Northstar Studio showcase sitesi var. Günlük kaynağı sentetik kayıtlar döndürüyor. Ekran görüntüleri özelliği gösteriyor; bir müşteri uygulamasını veya onaylanmış CMS sayfalarının otomatik akışını temsil etmiyor.

Örnek sayfa bir başlık, editoryal giriş ve günlük kayıtlarını gösteren üç sütunlu bir Grid içeriyor. Her kartta bir başlık ve açıklama var.

Giriş, normal Rich Text olarak kalıyor. Sayfa başlığı tek bir seçilmiş kayıttan geliyor. Grid ise kartları doldurmak için koleksiyon kaynağını kullanıyor. Giriş metnini değiştirmek kaynak kayıtlarını değiştirmiyor; kaynak başlığının değişmesi ise CMS'teki metni düzenlemeden sayfanın görünen sonucunu değiştirebiliyor.

Header bloğunun Settings sekmesindeki Content source alanını açın. Başlık alanı için Northstar entry kaynağını, Field Notes kaydını ve Title alanını seçin. Sayfada görünen başlık artık “Field Notes” olur.

Blokta saklanan metin yedek değer olarak kullanılabilir durumda kalır. Bu gösterimde davranışı kolayca tanımak için “Editorial fallback: Journal entry” yazıyor. Gerçek bir sayfada, okuyucu için anlamlı bir yedek metin hazırlayın.

Burada açıkça seçilmiş bir alan bağlaması var. Önce geliştirici kaynağı sağlar ve kullanılabilecek alanları tanımlar. Editör bu kaynaktan uyumlu alanı ve kaydı seçer. CMS, veri tabanındaki her tabloyu kendiliğinden kullanılabilir hale getirmez.

Günlük listesi için bir Grid oluşturun ve doğrudan çocuğu olarak bir Stack ekleyin. Bu Stack'in içine, tek kartı oluşturan Header ve Rich Text bloklarını yerleştirin. Bu çocuk, koleksiyonun şablonudur.

Grid ayarlarında Northstar journal koleksiyonunu seçin, tekrarlanacak çocuk olarak Stack'i belirleyin ve sonucu üç kayıtla sınırlayın. Örnek, Title alanına göre artan sıralama kullanıyor: Autumn field notes, Materials and process ve Working with natural light.

Kaynak önizlemesi, koleksiyonu yapılandırırken örnek kayıtları incelemenizi sağlar. Sayfa düzenini değerlendirmeden önce beklenmedik bir başlığı veya uygun olmayan seçimi fark etmenize yardımcı olur.

Şablon içindeki Header'ı açıp başlığını Current collection item → Title alanına bağlayın. Rich Text bloğunu da mevcut öğenin Description alanına bağlayın. Tekrarlanan her kart artık kendi kaydını okur.

Renderer, şablonu çalışma anında tekrarlar. Her kayıt için veri tabanında ayrı bir CMS blok ağacı oluşturmaz. Tek kart tasarımını yönetirsiniz; kayıtları kaynak sağlar. Kapsayıcıdaki diğer elle hazırlanmış çocuklar yerlerini koruyabilir.

Boş sonuç editoryal bir karardır. Bu showcase örneğinde kaynak hiç kayıt döndürmezse Grid şablonu gizler. Aksi halde örnek günlük kaydını göstermek, gerçekte bir kayıt bulunduğu izlenimini verebilir.

Resolver hatası farklı bir durumdur. Bu örnek, hata durumunda şablonun yedek içeriğini koruyor; böylece sayfada saklanan metin gösterilebilir. Bu yedek içerik normal içerik kadar dikkatle incelenmelidir. Rahatlatıcı ama yanlış bir mesaj da yanlıştır.

Eksik veya devre dışı kaynak, erişim reddi ve geçersiz şablon da özgün çocukları korur. Bunlar, geçerli bir boş sonuç için seçilen ayara uymaz. Tekil alan bağlamasında erişilemeyen kayıt veya boş değer ise yapılandırılmış ya da blokta saklanan editoryal değere döner.

Bu yüzden “boşken gizle” seçimi, “herhangi bir sorun olduğunda gizle” anlamına gelmez. Yayımlamadan önce beklenen sonucu önizleyin ve hata yolunu anlayın.

Dinamik koleksiyonlar güncel kayıtları izlemesi gereken sayfalara uygundur: günlük dizini, etkinlik listesi veya değişen katalog gibi. Elle seçilmiş bir kampanya sayfasında ise birlikte incelenmiş sabit bir seçim ve metin gerekebilir. Böyle bir durumda normal editoryal bloklar daha uygun olabilir.

Revizyonların da bir sınırı var. Sayfa revizyonu bağlamaları, ayarları ve editoryal yedek içeriği saklar; dış veri kaynağının kayıtlarını yakalamaz. Eski sayfa revizyonunu geri yüklemek, eski günlük verisini geri getirmez. Sabit bir anlık görüntü gerektiren inceleme süreçleri bunu veri kaynağında veya yayın akışında ele almalıdır.

Bu sayfada sınır açık: giriş ve kart kompozisyonu editöre, kayıt değerleri kayıtlı kaynağa ait. Sayfanın tamamını statik veya dinamik saymak yerine bu sınırı alan alan belirleyin.

Bir içerik sayfasında hangi alanlar uygulama verisini izlemeli, hangileri editörün kontrolünde kalmalı?

Genel özellik açıklaması için Connect CMS blocks to dynamic plugin data makalesine bakabilirsiniz. Kaynak kaydı ve API ayrıntıları Content Sources and Block Field Bindings belgesinde yer alıyor.