Blok Türü Sözleşmeleri
Amaç ve Kapsam
Bu başvuru, yayınlanmış çekirdek blok türlerini, düzenlenebilir alanlarını, çevirilerini, alt blok kurallarını ve herkese açık render davranışını açıklar. Blok Türleri ekranı aynı sözleşmeyi salt okunur sunar; özel şema veya yeni düzenleme formu oluşturmaz.
Eklenti sistemi, PluginBlockTypeDefinition, PluginBlockPackDefinition ve PluginBlockRegistry aracılığıyla yalnızca bildirime dayalı eklenti blok kancaları ekler. Etkin eklentiler, keşif için analytics-tools::score-card gibi eklentiye ait tanıtıcıları sunabilir; ancak bu bildirimler dağıtılan çekirdek blok sözleşmelerinin, çekirdek blok görünümlerinin, çekirdek seeder'ların veya blok düzenleme hizmetlerinin yerini almaz. hero gibi nitelenmemiş çekirdek tarzı tanıtıcılar çekirdeğe ait kalır ve eklenti bildirimleri için reddedilir.
Tanım
A Blok Türü Sözleşmesi, bir blok türünün CMS katmanları genelinde nasıl davrandığına ilişkin mevcut teknik anlaşmadır:
- Katalog kimliği: bilgi, etiket, kategori, durum ve sistem veya kapsayıcı meta verileri
- Yönetici form kaynağı: bloğu şu anda hangi Blade kısmı düzenliyor ve hangi alanları açığa çıkarıyor
- Doğrulama ve istek işleme:
WebBlocks\Cms\Http\Requests\Admin\BlockRequestşu anda blok veri yüklerini nasıl normalleştirir ve doğrular - Depolama sahipliği: hangi değerler
blocks'de, özel çeviri satırlarında,block_media'de veya ilgili kayıtlarda yayınlanır - Çeviri sahipliği: kullanıcıya yönelik hangi alanlar yerel ayara aittir
- paylaşılan sahiplik: yerel ayarlar arasında hangi ayarlar veya ilişkiler paylaşılır
- Medya veya ilişki sahipliği: doğrudan
media_id, sıralıblock_media, gezinme aramaları, veya aynı sayfadaki ilişkiler - çocuk desteği: bloğun bir kapsayıcı olup olmadığı ve alt türlerin kısıtlı olup olmadığı
- genel oluşturucu kaynağı: bloğu bugün hangi genel Blade kısmı oluşturuyor
- İşleyici kök sözleşmesi: bloğun genel kök işaretlemesine sahip olup olmadığı veya genel sarmalayıcı yoluna dayanır
- Taşınabilirlik ve revizyonlar: mevcut depolama şeklinin revizyonlar, klonlama, dışa/içe aktarma ve tanıtım yoluyla seyahat etmeye devam edip etmeyeceği
- Testler ve boşluklar: bilinen odaklanmış kapsam, belirsiz davranış veya uyumluluk borcu
Güncel Sözleşme Terimleri
Aşağıda kullanılan durum terimleri:
clear: yönetim formu, istek işleme, depolama ve renderer çoğunlukla örtüşüyormostly clear: güncel sözleşme anlaşılabilir ama kayda değer bir çekincesi vartransitional: güncel sözleşme bilinçli olarak bir uyumluluk yolu veya karma sahiplik deseni taşıyorneeds review: davranışa güvenmeden önce kurulu sözleşme doğrulanmalıdırlegacy/fallback: yayındaki davranış bir yedek (fallback) veya uyumluluk yoluna dayanıyor
Depolama Sahipliği Kuralları
Mevcut ve gelecekteki sözleşme çalışmaları bu sahiplik kurallarını açık tutmalıdır:
- Kullanıcıya yönelik kopya, blok yerel ayara ait olduğunda çeviri satırlarına aittir
- Paylaşılan operasyonel veya ayar verileri, paylaşılan blok ayarlarına veya açık ilişkilere aittir
- medya kullanmalıdır Uygun olduğunda
media_idveyablock_mediasahiplik yolları - Kullanıcıya yönelik içeriği rastgele paylaşılan ayarlara taşımaktan kaçının
- Genel çıktıyı veya içe aktarmaları hâlâ etkilediklerinde uyumluluk depolama yollarını belgelenmiş tutun
CMS 1.98.6'den uyumlu settings modeli/API alanı ilişkisel kayıtlarla desteklenir. Bilinen çekirdek alanlar sonlu tipte görünüm, medya, gezinme ve içerik sütunlarını kullanır. İçerik bağlamaları, koleksiyon yapılandırması ve uygulama örneği değerlerinin ayrı kayıtları vardır; Yazılan düğümler yapıyı, sıralamayı ve geçmiş/eklenti uzantılarını korur. CMS 1.98.8, geçici JSON geri alma kopyalarını kaldırdı; SQL yetkilidir. Düzenleyici, çeviri sahipliği, API yükleri ve oluşturucu yöntemleri mevcut sözleşmelerini korur; depolama geçişi, yerel ayara ait kopyayı paylaşılan ayarlara taşımaz.
İçerik yazım ayarlarının doğrulanması
CMS 1.105.9, yayımlanan 55 temel bloğun tamamı için sürümlenmiş authoring_settings_schema keşfini ekler. Bir alan göndermeden önce oluşturma, PATCH ve yönetim paneli için ayrı yazma kurallarını okuyun. Yeni veya değiştirilen değerler, bildirilen türlere, seçeneklere ve sınırlara uymalıdır. Desteklenmeyen alanlar sessizce kabul edilmek veya temizlenmek yerine doğrulama hatası döndürür. Bu sözleşme kod tarafından tanımlanır; düzenlenebilir bir şema veya otomatik form oluşturucu değildir.
Değişmeyen geçmiş değerler, ilgisiz düzenlemeler ile güvenilir klonlama, hazırlık kopyası oluşturma ve revizyon işlemlerinde korunur. Yeni bloklar ve tam değiştirmeler güncel doğrulamadan geçmelidir. Şeması olmayan eklentiler mevcut davranışlarını korur. İsteğe bağlı eklenti skaler şemaları; medya, uygulama veya Dynamic Content doğrulayıcılarının yerini almaz. HTML yalnızca insan tarafından düzenlenebilir.
İşlem meta verileri, uyumluluk kuralları ve salt okunur webblocks:blocks:audit-settings uyumluluk komutu için Blok başına içerik yazım ayarları şemaları bölümüne bakın. Aşağıdaki ayrı katalog denetimi, kayıtlı ayarlar yerine paketle gelen formları ve sayfa oluşturucularını kontrol eder.
Dağıtılan Kaynaklar
Bu başvuru dağıtılan katalog, formlar ve renderer kaynaklarını kullanır.
- katalog kaynağı:
src/Support/Blocks/CoreBlockTypeCatalogSyncer.php - blok düzenleme isteği normalizasyonu:
src/Http/Requests/Admin/BlockRequest.php - kalıcı yardımcılar:
src/Support/Blocks/BlockPayloadWriter.php,src/Support/Blocks/BlockTranslationWriter.php,src/Support/Blocks/BlockTranslationResolver.php - çeviri kaydı:
src/Support/Blocks/BlockTranslationRegistry.php - Yönetici formları:
resources/views/admin/blocks/types/*.blade.php - genel oluşturucular:
resources/views/pages/partials/blocks/*.blade.php - kapsam referansları:
tests/Feature/ - kapsamında blok kataloğu, işleme, çeviri ve slug'a özgü testler
Şu anda burada belgelenen yayınlanmış çekirdek blok türleri: 55.
Katalog mutabakatı: WebBlocks CMS 1.105.8. Tablo, yayınlanmış 55 temel tanımın tamamını kapsamaktadır; yedi ek tanım yayınlanmamıştır. Aşağıdaki sonraki aşama notları, ikinci güncel katalog sayımı değil, tarihsel kayıtlardır.
Denetim Komutu
Yöneticiler ve geliştiriciler bu salt okunur katalog kontrolünü çalıştırabilir:
php artisan block-types:contracts-audit
php artisan block-types:contracts-audit --jsonKomut salt okunurdur.
- veritabanını değiştirmez
- kurulu site içeriğine bağımlı değildir
- dağıtılan çekirdek katalog tanımlarını okur
- dağıtılan yönetim formu ve herkese açık renderer dosyalarının varlığını doğrular
- çeviri ailesi meta verilerini ve temel kapsayıcı desteğini raporlar
Komut, katalog ve dosya varlığı sapmaları için bir güncellik yardımcısıdır. Bu belgedeki daha kapsamlı sözleşme notlarının yerini tutmaz.
Salt Okunur Yönetim Görünümü
Sözleşme ayrıntılarını Admin -> System -> Block Types içinde salt okunur açın.
- her satır bir
Block Type Contractkipi (modal) açabilir - kip yalnızca bilgilendirme amaçlıdır ve güncelleme göndermez
- dağıtılan koddan katalog, yönetim formu, depolama, çeviri, medya veya ilişki, alt öğe, renderer ve boşluk ayrıntılarını gösterir
- Blok Türleri yönetimini bir şema editörüne veya form oluşturucuya dönüştürmez
- özel veya taslak blok türleri kipi yine açabilir, ancak tanımlı bir çekirdek sözleşme yoksa
No shipped contract is documented for this block type yet.mesajını gösterebilir
Yayındaki Blok Sözleşmesi Matrisi
İçerik
Başlık — header
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | header |
| Etiket | Başlık |
| Kategori | content |
| Çevrilebilir alanlar | title metin çeviri satırları üzerinden |
| Ortak/ayar alanları | variant başlık düzeyi; settings.alignment; settings.anchor içinde ortak çapa, eski url geri dönüşüyle birlikte |
| Medya/ilişki alanları | Aynı yuvadaki TOC bağlantılı Başlık bloklarını okur |
| Alt öğe/kapsayıcı davranışı | Kapsayıcı değildir |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Kanonik başlık bloğudur; ortak çapa sözleşmesi nettir ancak eski url geri dönüş davranışı hâlâ mevcuttur. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/header.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/header.blade.php |
| Renderer kök sözleşmesi | Kök başlık öğesine kendisi sahiptir |
| Testler / kapsam | SyncCoreBlockTypesCommandTest, PublicEditorialBlocksRenderingTest, BlockTranslationIntegrityTest |
Düz Metin — plain_text
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | plain_text |
| Etiket | Düz Metin |
| Kategori | content |
| Çevrilebilir alanlar | content metin çeviri satırları üzerinden |
| Ortak/ayar alanları | settings.alignment |
| Medya/ilişki alanları | Yok |
| Alt öğe/kapsayıcı davranışı | Kapsayıcı değildir |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Çevrilen gövde metni için basit bir temel bloktur. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/plain_text.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/plain_text.blade.php |
| Renderer kök sözleşmesi | Köküne sahiptir <p> |
| Testler / kapsam | PublicEditorialBlocksRenderingTest, BlockTranslationIntegrityTest |
Zengin Metin — rich-text
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | rich-text |
| Etiket | Zengin Metin |
| Kategori | content |
| Çevrilebilir alanlar | content metin çeviri satırları üzerinden |
| Ortak/ayar alanları | Yok |
| Medya/ilişki alanları | Yok |
| Alt öğe/kapsayıcı davranışı | Kapsayıcı değildir |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Güvenli HTML saklama ve çeviri sahipliği nettir. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/rich-text.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/rich-text.blade.php |
| Renderer kök sözleşmesi | İçerik mevcut olduğunda .wb-rich-text köküne kendisi sahiptir |
| Testler / kapsam | RichTextBlockTest, PublicRichContentTest, BlockTranslationIntegrityTest |
Kod — code
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | code |
| Etiket | Kod |
| Kategori | content |
| Çevrilebilir alanlar | title, subtitle, content metin çeviri satırları üzerinden |
| Ortak/ayar alanları | settings.language |
| Medya/ilişki alanları | Yok |
| Alt öğe/kapsayıcı davranışı | Kapsayıcı değildir; geçmişten kalan alt satırlar korunur ancak yeni alt öğe yerleştirme desteklenmez |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Blok çevrilen kod başlığını, etiketini ve parçacık gövdesini mevcut metin çevirisi mimarisiyle hizalar ve artık genel çıktıda geçmişten kalan rastgele alt öğe ağaçlarını yok sayar. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/code.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/code.blade.php |
| Renderer kök sözleşmesi | <pre><code> köküne sahiptir |
| Testler / kapsam | PublicRichContentTest, BlockTypePhaseThreeContractsTest, PageBuilderExperienceTest |
Düğme Bağlantısı — button_link
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | button_link |
| Etiket | Düğme Bağlantısı |
| Kategori | content |
| Çevrilebilir alanlar | title etiketi metin çeviri satırları üzerinden |
| Ortak/ayar alanları | settings.url; settings.target; ortak variant |
| Medya/ilişki alanları | Yok |
| Alt öğe/kapsayıcı davranışı | Kapsayıcı değildir |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Ortak URL ve hedef, çevrilen etiketle tutarlıdır. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/button_link.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/button_link.blade.php |
| Renderer kök sözleşmesi | <a.wb-btn> köküne sahiptir |
| Testler / kapsam | PublicEditorialBlocksRenderingTest |
Kart — card
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | card |
| Etiket | Kart |
| Kategori | layout |
| Çevrilebilir alanlar | Yok |
| Ortak/ayar alanları | Paylaşılan media_id; settings.layout_name; settings.background_position; settings.background_overlay; isteğe bağlı settings.url ve settings.target |
| Medya/ilişki alanları | Doğrudan media_id aracılığıyla isteğe bağlı arka plan image; alt bölge blokları yapıyı tanımlar |
| Alt öğe/kapsayıcı davranışı | Kapsayıcıdır; izin verilen doğrudan alt öğeler yalnızca card_header, card_body ve card_footer bloklarıdır |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Kart şekillendirilebilir bir kabuktur. İsteğe bağlı tam card URL'si güvenli ve anlamsaldır; editörler bağlantılı Kartlara iç içe geçmiş etkileşimli kontroller yerleştirmemelidir. Medya Kitaplığı arka planlarını destekler ve Kart bölgeleri olmayan eski satırlar için eski geri dönüşü minimum düzeyde tutar. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/card.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/card.blade.php |
| Renderer kök sözleşmesi | Bağlandığında <article class="wb-card"> köküne veya bir anlamsal <a class="wb-card wb-no-decoration"> köküne sahiptir |
| Testler / kapsam | CardClickableRenderTest, PublicEditorialBlocksRenderingTest, PageBuilderExperienceTest, BlockTypePhaseThreeContractsTest, BlockTranslationIntegrityTest, MediaVisualBlockContractsTest |
Kart Başlığı — card_header
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | card_header |
| Etiket | Kart Başlığı |
| Kategori | layout |
| Çevrilebilir alanlar | Yok |
| Ortak/ayar alanları | settings.layout_name, settings.icon_slug, settings.icon_tone, settings.icon_size |
| Medya/ilişki alanları | Yalnızca üst card ilişkisi |
| Alt öğe/kapsayıcı davranışı | Kapsayıcıdır; yalnızca card altına yerleştirilebilir; kart bölgesi alt öğelerine izin verilmez |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | header content için Şekillendirilebilir Kart bölge bloğu. İsteğe bağlı simgeler, etkin content katalog bilgilerini kullanır ve yalnızca güvenli simge, ton ve boyut sınıfları aracılığıyla oluşturulur. Kart Başlığında rozet kopyası yoktur ve bu nedenle rozet tonu görülmez. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/card_header.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/card_header.blade.php |
| Renderer kök sözleşmesi | <div class="wb-card-header"> köküne sahiptir |
| Testler / kapsam | PublicEditorialBlocksRenderingTest, PageBuilderExperienceTest, BlockTypePhaseThreeContractsTest, PublicIconBadgeSupportTest |
Kart Gövdesi — card_body
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | card_body |
| Etiket | Kart Gövdesi |
| Kategori | layout |
| Çevrilebilir alanlar | Yok |
| Ortak/ayar alanları | settings.layout_name |
| Medya/ilişki alanları | Yalnızca üst card ilişkisi |
| Alt öğe/kapsayıcı davranışı | Kapsayıcıdır; yalnızca card altına yerleştirilebilir; kart bölgesi alt öğelerine izin verilmez |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Ana gövde içeriği için birleştirilebilir Kart bölge bloğudur. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/card_body.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/card_body.blade.php |
| Renderer kök sözleşmesi | <div class="wb-card-body"> köküne sahiptir |
| Testler / kapsam | PublicEditorialBlocksRenderingTest, PageBuilderExperienceTest, BlockTypePhaseThreeContractsTest |
Kart Altbilgisi — card_footer
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | card_footer |
| Etiket | Kart Altbilgisi |
| Kategori | layout |
| Çevrilebilir alanlar | Yok |
| Ortak/ayar alanları | settings.layout_name |
| Medya/ilişki alanları | Yalnızca üst card ilişkisi |
| Alt öğe/kapsayıcı davranışı | Kapsayıcıdır; yalnızca card altına yerleştirilebilir; kart bölgesi alt öğelerine izin verilmez |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Altbilgi veya eylem içeriği için birleştirilebilir Kart bölge bloğudur. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/card_footer.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/card_footer.blade.php |
| Renderer kök sözleşmesi | <div class="wb-card-footer"> köküne sahiptir |
| Testler / kapsam | PublicEditorialBlocksRenderingTest, PageBuilderExperienceTest, BlockTypePhaseThreeContractsTest |
İstatistik Kartı — stat-card
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | stat-card |
| Etiket | İstatistik Kartı |
| Kategori | content |
| Çevrilebilir alanlar | title, subtitle, content metin çeviri satırları üzerinden |
| Ortak/ayar alanları | Kanonik url blok satırında ortak kalır |
| Medya/ilişki alanları | Yok |
| Alt öğe/kapsayıcı davranışı | Kapsayıcı değildir |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Blok mevcut isteğe bağlı URL alanını korur ve URL bulunduğunda artık basit bir genel bağlantı işler. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/stat-card.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/stat-card.blade.php |
| Renderer kök sözleşmesi | İstatistik kartı köküne kendisi sahiptir |
| Testler / kapsam | StatCardTest, BlockTranslationIntegrityTest |
Görsel — image
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | image |
| Etiket | Görsel |
| Kategori | content |
| Çevrilebilir alanlar | caption, alt text görsel çeviri satırları üzerinden |
| Ortak/ayar alanları | Paylaşılan media_id; paylaşılan kanonik url; settings.viewer_enabled; settings.viewer_group |
| Medya/ilişki alanları | media_id üzerinden doğrudan görsel medya ilişkisi |
| Alt öğe/kapsayıcı davranışı | Kapsayıcı değildir; geçmişten kalan alt satırlar korunur ancak yeni alt öğe yerleştirme desteklenmez |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Altyazı ve alt text yerel ayarlara aittir; medya, isteğe bağlı bağlantı URL'si ve görüntüleyici gruplaması ise paylaşılmaya devam eder. Açık bağlantılar önceliklidir; aksi takdirde etkinleştirilmiş olan aynı gruba sahip Resim blokları, sayfa kompozisyonunu değiştirmeden mevcut CMS Galeri Görüntüleyiciyi paylaşır. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/image.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/image.blade.php |
| Renderer kök sözleşmesi | Medya mevcut olduğunda anlamsal <figure> köküne sahiptir ve gruplandırılmış bir Galeri Görüntüleyiciye kaydolabilir |
| Testler / kapsam | MediaVisualBlockContractsTest, PublicMediaBlocksTest, BlockTranslationIntegrityTest, PublicOverlayRegistryTest |
Galeri — gallery
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | gallery |
| Etiket | Galeri |
| Kategori | content |
| Çevrilebilir alanlar | Galeri öğesi başına alt_text, caption, overlay_title ve overlay_text, block_gallery_item_translations üzerinden |
| Ortak/ayar alanları | Paylaşılan gallery sunum ayarları artı isteğe bağlı görüntüleyici title ve sıralı block_media gallery öğesi ilişkileri |
| Medya/ilişki alanları | gallery_item rolüne sahip sıralı block_media satırları; dile ait galeri öğesi metinleri block_gallery_item_translations üzerinde tutulur; blokta eski kayıtlı title/subtitle değerleri hâlâ bulunabilir ancak genel işleme tarafından yok sayılır |
| Alt öğe/kapsayıcı davranışı | Kapsayıcı değildir; geçmişten kalan alt satırlar korunur ancak yeni alt öğe yerleştirme desteklenmez |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Galeri artık bir medya toplama bloğudur. Normal yönetici formu, eski seçili varlıklar grid yerine kompakt bir liste satırı düzenleyicisi kullanır. Yuvalanmış Add Gallery Items seçicisi, paylaşılan yönetici #wb-overlay-root sözleşmesinde kalır, böylece WebBlocks UI yığılmış modal yaşam döngüsüne sahip olur ve uzun kompakt sonuç listeleri doğal satır yüksekliğini korurken modal gövdesi kaydırma kabı olarak kalır. Genel değişkenler farklıdır: grid eşit hücreleri korur, masonry, doğal image yüksekliğinde CSS columns'yi kullanır ve collage, öne çıkan ilk kompozisyonu korur. Eski kaydedilen masonary değerleri hâlâ kabul edilir ve standart masonry yoluna göre normalleştirilir. Galeri artık giriş başlığına veya paragraf çıktısına sahip değil; editörler bölüm kopyası gerektiğinde Galeri'den önce content_header artı plain_text veya rich-text'yi yerleştirmelidir. İsteğe bağlı görüntüleyici title yalnızca ışık kutusu modeli header'yi etiketler. Eski ayarlara dayalı geri dönüş öğeleri, eski content için okunabilir durumda kalır. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/gallery.blade.php ile birlikte resources/views/admin/blocks/types/partials/gallery-items-editor.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/gallery.blade.php |
| Renderer kök sözleşmesi | Galeri sarmalayıcı köküne kendisi sahiptir ve lightbox etkinleştirildiğinde #wb-overlay-root altında bir görüntüleyici modalı kaydeder |
| Testler / kapsam | MediaVisualBlockContractsTest, PublicMediaBlocksTest, PageBuilderExperienceTest, SiteCloneServiceTest, SiteExportImportTest, SitePromotionTest, ReconstructionIntegrityTest, SharedSlotRevisionTest |
İndirme — download
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | download |
| Etiket | İndirme |
| Kategori | content |
| Çevrilebilir alanlar | title, subtitle metin çeviri satırları üzerinden |
| Ortak/ayar alanları | Ortak media_id; ortak variant |
| Medya/ilişki alanları | media_id üzerinden doğrudan indirme medyası ilişkisi |
| Alt öğe/kapsayıcı davranışı | Kapsayıcı değildir; geçmişten kalan alt satırlar korunur ancak yeni alt öğe yerleştirme desteklenmez |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Blok seçilen indirme medyasını ve düğme varyantını ortak tutarken görünen etiketi ve yardımcı metni mevcut metin çevirisi yoluna taşır. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/download.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/download.blade.php |
| Renderer kök sözleşmesi | Medya mevcut olduğunda CTA sarmalayıcı köküne kendisi sahiptir |
| Testler / kapsam | MediaVisualBlockContractsTest, PublicMediaBlocksTest, AudioContentApiTest |
Dosya — file
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | file |
| Etiket | Dosya |
| Kategori | content |
| Çevrilebilir alanlar | title, content metin çeviri satırları üzerinden |
| Ortak/ayar alanları | Ortak media_id; ortak kanonik url |
| Medya/ilişki alanları | media_id üzerinden doğrudan medya ilişkisi, harici URL geri dönüşüyle birlikte |
| Alt öğe/kapsayıcı davranışı | Kapsayıcı değildir; geçmişten kalan alt satırlar korunur ancak yeni alt öğe yerleştirme desteklenmez |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Blok halihazırda gelen Dosya renderer'ını özel bir yönetim formuyla ürünleştirir ve ortak dosya kaynağı sahipliğini Medya ile harici URL geri dönüşü arasında açık tutar. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/file.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/file.blade.php |
| Renderer kök sözleşmesi | Dosya kartı köküne kendisi sahiptir |
| Testler / kapsam | MediaVisualBlockContractsTest, PublicMediaBlocksTest, AudioContentApiTest |
Video — video
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | video |
| Etiket | Video |
| Kategori | content |
| Çevrilebilir alanlar | title, content metin çeviri satırları üzerinden |
| Ortak/ayar alanları | Ortak media_id; ortak kanonik url |
| Medya/ilişki alanları | media_id üzerinden doğrudan medya ilişkisi, güvenli harici URL geri dönüşüyle birlikte |
| Alt öğe/kapsayıcı davranışı | Kapsayıcı değildir; geçmişten kalan alt satırlar korunur ancak yeni alt öğe yerleştirme desteklenmez |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Blok eksik yönetim formunu ve kaydetme yolunu ekler; böylece yüklenen video medyası, güvenli harici sağlayıcı URL'leri, çevrilen görünür metinler ve genel geri dönüş davranışı artık aynı sözleşmeyi tanımlar. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/video.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/video.blade.php |
| Renderer kök sözleşmesi | Video kartı köküne kendisi sahiptir |
| Testler / kapsam | MediaVisualBlockContractsTest, PublicMediaBlocksTest, AudioContentApiTest |
Ses — audio
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | audio |
| Etiket | Ses |
| Kategori | content |
| Çevrilebilir alanlar | title, content metin çeviri satırları üzerinden |
| Ortak/ayar alanları | Ortak media_id; ortak kanonik url |
| Medya/ilişki alanları | media_id üzerinden doğrudan medya ilişkisi, harici URL geri dönüşüyle birlikte |
| Alt öğe/kapsayıcı davranışı | Kapsayıcı değildir; geçmişten kalan alt satırlar korunur ancak yeni alt öğe yerleştirme desteklenmez |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Yönetici, İçerik Planı ve artımlı blok yazmaları, other türüne ve audio/* MIME türüne sahip audio ortamını kabul eder; uyumsuz medya reddedilir. Yerelleştirilmiş kopya ve boş olmayan denetimlerin güvenli oluşturulması yerel olarak kalır. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/audio.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/audio.blade.php |
| Renderer kök sözleşmesi | Ses kartı köküne kendisi sahiptir |
| Testler / kapsam | MediaVisualBlockContractsTest, PublicMediaBlocksTest, AudioContentApiTest |
Tablo — table
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | table |
| Etiket | Tablo |
| Kategori | content |
| Çevrilebilir alanlar | title, content metin çeviri satırları üzerinden |
| Ortak/ayar alanları | Ortak variant; renderer ayrıca settings.rows geri dönüşünü de denetler |
| Medya/ilişki alanları | Yok |
| Alt öğe/kapsayıcı davranışı | Kapsayıcı değildir; geçmişten kalan alt satırlar korunur ancak yeni alt öğe yerleştirme desteklenmez |
| Mevcut durum | mostly clear |
| Bilinen eksikler / notlar | Blok çevrilen başlık ve satır metni sahipliğini mevcut metin çevirisi mimarisiyle hizalar ve artık genel çıktıda geçmişten kalan rastgele alt öğe ağaçlarını yok sayar; eski settings.rows geri dönüş yolu belgelenmeye devam eder. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/table.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/table.blade.php |
| Renderer kök sözleşmesi | Tablo sarmalayıcı köküne kendisi sahiptir |
| Testler / kapsam | PublicRichContentTest, BlockTypePhaseThreeContractsTest, PageBuilderExperienceTest |
Alıntı — quote
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | quote |
| Etiket | Alıntı |
| Kategori | content |
| Çevrilebilir alanlar | Bugün itibarıyla registry'de yok |
| Ortak/ayar alanları | Kanonik title, subtitle, content, variant |
| Medya/ilişki alanları | Yok |
| Alt öğe/kapsayıcı davranışı | Kapsayıcı değildir; geçmişten kalan alt satırlar korunur ancak yeni alt öğe yerleştirme desteklenmez |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Blok yönetimdeki blok ağaçlarında mevcut kayıtlı alt satırları korurken genel çıktıda Alıntı'yı bir yerleşim/kapsayıcı sarmalayıcısı olarak ele almayı bırakır. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/quote.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/quote.blade.php |
| Renderer kök sözleşmesi | Alıntı köküne kendisi sahiptir |
| Testler / kapsam | PublicRichContentTest, PageBuilderExperienceTest |
Hero — hero
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | hero |
| Etiket | Hero |
| Kategori | content |
| Çevrilebilir alanlar | title, subtitle, content metin çeviri satırları üzerinden |
| Ortak/ayar alanları | Paylaşılan media_id; paylaşılan variant; settings.layout; settings.title_tag; settings.background_position; settings.background_overlay |
| Medya/ilişki alanları | Doğrudan media_id aracılığıyla isteğe bağlı arka plan image; eylemler için alt button_link blokları |
| Alt öğe/kapsayıcı davranışı | Konteyner; button_link alt öğeleri (eski button'ye de izin verilir), sabit sayı yoktur |
| Mevcut durum | transitional |
| Bilinen eksikler / notlar | Hero artık yayınlanmış, kaynak destekli bir çekirdek sözleşmedir. Giriş kopyası yerel ayara aittir, eylem düğmeleri kendi etiketlerine ve URL'lerine sahip sıradan button_link alt öğeleridir ve isteğe bağlı Ortam Kitaplığı arka plan resimleri, yerel WebBlocks UI arka plan ortamı ilkel aracılığıyla oluşturulur. Eski content geri dönüşleri, standart olarak çevrilmiş alanların boş olduğu durumlarda okunabilir durumda kalır. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/hero.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/hero.blade.php |
| Renderer kök sözleşmesi | Promosyon <section> köküne sahiptir |
| Testler / kapsam | PublicHeroBlockRenderingTest, PageBuilderExperienceTest, BlockTypePhaseThreeContractsTest |
Sütunlar — columns
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | columns |
| Etiket | Sütunlar |
| Kategori | content |
| Çevrilebilir alanlar | title, subtitle, content metin çeviri satırları üzerinden |
| Ortak/ayar alanları | Ortak variant |
| Medya/ilişki alanları | Alt column_item blokları |
| Alt öğe/kapsayıcı davranışı | Kapsayıcıdır; yalnızca column_item alt öğeleri |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Sütunlar artık yayınlanmış, birinci sınıf bir yapılandırılmış içerik bloğudur. Giriş metni dile aitken varyant, alt öğe sırası ve alt öğe URL'leri ortak kalır. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/columns.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/columns.blade.php |
| Renderer kök sözleşmesi | Yapılandırılmış content <section> köküne sahiptir Rozet etiketi olarak |
| Testler / kapsam | PublicColumnsRenderingTest, PageBuilderExperienceTest, BlockTypePhaseThreeContractsTest |
Sütun Öğesi — column_item
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | column_item |
| Etiket | Sütun Öğesi |
| Kategori | content |
| Çevrilebilir alanlar | title, eyebrow, metin çeviri satırları aracılığıyla subtitle, content |
| Ortak/ayar alanları | Paylaşılan kanonik url, settings.icon_slug, settings.icon_tone, settings.icon_size, settings.badge_tone |
| Medya/ilişki alanları | Üst columns ilişkisi |
| Alt öğe/kapsayıcı davranışı | Kapsayıcı değildir |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Sütun Öğesi, simge liderliğindeki düz ve card çeşitleri için gönderilen WebBlocks UI wb-icon-card kompozisyonunu kullanır. Yerel ayar, paylaşılan URL'lerin, simge bilgisinin, simge tonunun, simge boyutunun veya rozet tonunun üzerine yazmadan güncelleme öğesi kopyasını düzenler. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/column_item.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/column_item.blade.php |
| Renderer kök sözleşmesi | Üst öğe tarafından belirlenen öğe kökü, Sütunlar varyantına göre değişir |
| Testler / kapsam | PublicColumnsRenderingTest, PageBuilderExperienceTest, BlockTypePhaseThreeContractsTest, PublicIconBadgeSupportTest |
CTA — cta
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | cta |
| Etiket | CTA |
| Kategori | content |
| Çevrilebilir alanlar | title, subtitle, content metin çeviri satırları üzerinden |
| Ortak/ayar alanları | Paylaşılan media_id; paylaşılan variant; settings.background_position; settings.background_overlay |
| Medya/ilişki alanları | Doğrudan media_id aracılığıyla isteğe bağlı arka plan image; eylemler için alt button_link blokları |
| Alt öğe/kapsayıcı davranışı | Konteyner; button_link alt öğeleri (eski button'ye de izin verilir), sabit sayı yoktur |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | CTA artık yerel ayara ait kopya, sıradan button_link alt öğeleri olarak eylem düğmeleri, isteğe bağlı Medya Kitaplığı arka plan resimleri ve kök sahibi bir genel oluşturucu içeren yayınlanmış bir promosyon sözleşmesidir. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/cta.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/cta.blade.php |
| Renderer kök sözleşmesi | Promosyon <section> köküne sahiptir |
| Testler / kapsam | PublicHeroBlockRenderingTest, PageBuilderExperienceTest, BlockTypePhaseThreeContractsTest |
Özellik Izgarası — feature-grid
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | feature-grid |
| Etiket | Özellik Izgarası |
| Kategori | content |
| Çevrilebilir alanlar | title, subtitle, content metin çeviri satırları aracılığıyla; çocuk feature-item title, rozet etiketi ve content |
| Ortak/ayar alanları | Paylaşılan alt yapı, sıra, bağlantılar, simge bilgileri, simge tonları ve rozet tonları Rozet etiketi olarak |
| Medya/ilişki alanları | Eskiyle uyumlu column_item desteğiyle birlikte alt feature-item blokları |
| Alt öğe/kapsayıcı davranışı | Kapsayıcıdır; izin verilen alt öğeler feature-item ve column_item bloklarıdır |
| Mevcut durum | transitional |
| Bilinen eksikler / notlar | Özellik Izgarası artık yayınlanmış bir uyumluluk takma adıdır; çünkü gerçekten üründe var olan yönetim ve işleme yollarına sahiptir, ancak yine de bilinçli olarak Sütunlar kart sözleşmesine devreder. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/feature-grid.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/feature-grid.blade.php |
| Renderer kök sözleşmesi | Sütunlar kart sunumuna devreder ve hâlâ genel amaçlı public sarmalayıcıyı kullanır |
| Testler / kapsam | PublicHeroBlockRenderingTest, PageBuilderExperienceTest, BlockTypePhaseThreeContractsTest, PublicIconBadgeSupportTest |
Özellik Öğesi — feature-item
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | feature-item |
| Etiket | Özellik Öğesi |
| Kategori | content |
| Çevrilebilir alanlar | title, eyebrow, metin çeviri satırları aracılığıyla content |
| Ortak/ayar alanları | Paylaşılan kanonik url, settings.icon_slug, settings.icon_tone, settings.icon_size, settings.badge_tone |
| Medya/ilişki alanları | Üst feature-grid ilişkisi |
| Alt öğe/kapsayıcı davranışı | Kapsayıcı değildir |
| Mevcut durum | transitional |
| Bilinen eksikler / notlar | Özellik Öğesi artık Özellik Izgarası için yayınlanmış bir destekleyici alt sözleşmedir ve mevcut Sütun Öğesi kartlarını ve content simge oluşturmayı paylaşmaya devam etmektedir. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/feature-item.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/feature-item.blade.php |
| Renderer kök sözleşmesi | Sütun Öğesi kart sunumuna devreder |
| Testler / kapsam | PublicHeroBlockRenderingTest, PageBuilderExperienceTest, BlockTypePhaseThreeContractsTest, PublicIconBadgeSupportTest |
Yerleşim
Bölüm — section
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | section |
| Etiket | Bölüm |
| Kategori | layout |
| Çevrilebilir alanlar | Yok |
| Ortak/ayar alanları | Paylaşılan media_id; settings.layout_name; settings.spacing; settings.background_position; settings.background_overlay |
| Medya/ilişki alanları | Doğrudan media_id yoluyla isteğe bağlı arka plan resmi; alt bloklar yapısal içerik olarak kalır |
| Alt öğe/kapsayıcı davranışı | Kapsayıcıdır; açık bir alt öğe beyaz listesi yoktur |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Blok Bölüm layout odaklı kalır: paylaşılan layout ayarları standart kalır, isteğe bağlı arka plan ortamı standart Ortam Kitaplığı sözleşmesini kullanır, anlamsal <section> köküne sahiptir ve kullanıcıya yönelik kopyayı isteğe bağlı ayarlara taşımaz. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/section.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/section.blade.php |
| Renderer kök sözleşmesi | Köküne sahiptir <section> |
| Testler / kapsam | PublicEditorialBlocksRenderingTest, PublicLayoutStructureTest, PageBuilderExperienceTest, BlockTypePhaseThreeContractsTest |
Kapsayıcı — container
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | container |
| Etiket | Kapsayıcı |
| Kategori | layout |
| Çevrilebilir alanlar | Yok |
| Ortak/ayar alanları | settings.layout_name; settings.width; settings.flow |
| Medya/ilişki alanları | Yalnızca alt bloklar |
| Alt öğe/kapsayıcı davranışı | Kapsayıcıdır; açık bir alt öğe beyaz listesi yoktur |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Konteyner, akış ayarlanmadığında veya none olduğunda layout nötrdür; yalnızca açık Flow: Stack dikey alt akışı ekler. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/container.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/container.blade.php |
| Renderer kök sözleşmesi | Köküne sahiptir container <div> |
| Testler / kapsam | PublicEditorialBlocksRenderingTest, PublicLayoutStructureTest, PageBuilderExperienceTest, BlockTypePhaseThreeContractsTest |
Yığını — stack
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | stack |
| Etiket | Yığını |
| Kategori | layout |
| Çevrilebilir alanlar | Yok |
| Ortak/ayar alanları | settings.layout_name; settings.spacing |
| Medya/ilişki alanları | Yalnızca alt bloklar |
| Alt öğe/kapsayıcı davranışı | Kapsayıcıdır; açık bir alt öğe beyaz listesi yoktur |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Dikey alt akış yalnızca gönderilen wb-stack ve wb-stack-* sınıflarıyla eşleşir. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/stack.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/stack.blade.php |
| Renderer kök sözleşmesi | Köküne sahiptir stack <div> |
| Testler / kapsam | StackSplitCatalogTest, StackSplitContractTest |
Bölünmüş — split
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | split |
| Etiket | Bölünmüş |
| Kategori | layout |
| Çevrilebilir alanlar | Yok |
| Ortak/ayar alanları | settings.layout_name; settings.gap; settings.items_alignment; settings.width |
| Medya/ilişki alanları | Tam olarak iki doğrudan alt blok |
| Alt öğe/kapsayıcı davranışı | Konteyner; açık bir çocuk türü beyaz listesi yoktur ancak doğrudan çocuk sayısı iki ile sınırlıdır |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | İlk doğrudan alt öğe büyüyor ve ikincisi içerik boyutunda kalıyor. Bir Yığın her iki tarafa da yerleştirilebilir. Sabitlenmiş kullanıcı arayüzünde henüz yanıt veren bir split-stack değiştiricisi yok. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/split.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/split.blade.php |
| Renderer kök sözleşmesi | Köküne sahiptir split <div> |
| Testler / kapsam | StackSplitCatalogTest, StackSplitContractTest |
Küme — cluster
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | cluster |
| Etiket | Küme |
| Kategori | layout |
| Çevrilebilir alanlar | Yok |
| Ortak/ayar alanları | settings.layout_name; settings.gap; settings.alignment; settings.items_alignment; settings.wrap; settings.width |
| Medya/ilişki alanları | Yalnızca alt bloklar |
| Alt öğe/kapsayıcı davranışı | Kapsayıcıdır; açık bir alt öğe beyaz listesi yoktur |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Ortak yerleşim ayarları açık ve renderer'a ait kalır; buna navbar'a özgü mantık eklenmeden, mevcut navbar uyumlu tam genişlik, between, center ve nowrap birleştirme yolu da dahildir. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/cluster.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/cluster.blade.php |
| Renderer kök sözleşmesi | Köküne sahiptir cluster <div> |
| Testler / kapsam | PublicEditorialBlocksRenderingTest, PublicLayoutStructureTest, PageBuilderExperienceTest, BlockTypePhaseThreeContractsTest |
Izgara — grid
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | grid |
| Etiket | Izgara |
| Kategori | layout |
| Çevrilebilir alanlar | Yok |
| Ortak/ayar alanları | settings.layout_name; settings.columns; settings.gap; settings.alternate_media_text_sections; settings.alternate_start |
| Medya/ilişki alanları | Yalnızca alt bloklar |
| Alt öğe/kapsayıcı davranışı | Kapsayıcıdır; açık bir alt öğe beyaz listesi yoktur |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Paylaşılan grid ayarları standart kalır. Alternatif ortam/metin ızgaraları, gönderilen wb-grid-* sarmalayıcıyı tutar ve algılanan görsel içeriğe göre Slider artı metin Bölümü yapıları da dahil olmak üzere doğrudan ortam/metin alt çiftlerini yeniden sıralar. Aynı ebeveynin altındaki kardeş alternatif Izgaralar, aralarında başka bloklar görünse bile bir diziyi paylaşırlar; ilk alternatif Izgara başlangıç yönünü kontrol eder. Rozet etiketi olarak |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/grid.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/grid.blade.php |
| Renderer kök sözleşmesi | Köküne sahiptir grid <div> |
| Testler / kapsam | PublicEditorialBlocksRenderingTest, PublicLayoutStructureTest, PageBuilderExperienceTest, BlockTypePhaseThreeContractsTest |
Desen
İçerik Başlığı — content_header
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | content_header |
| Etiket | İçerik Başlığı |
| Kategori | pattern |
| Çevrilebilir alanlar | title, eyebrow, metin çeviri satırları aracılığıyla subtitle, meta |
| Ortak/ayar alanları | Paylaşılan media_id; settings.alignment, settings.icon_slug, settings.icon_tone, settings.icon_size, settings.badge_tone, settings.background_position, settings.background_overlay |
| Medya/ilişki alanları | Doğrudan media_id yoluyla isteğe bağlı arka plan resmi; meta, content yapılandırılmış listesi olarak saklanır |
| Alt öğe/kapsayıcı davranışı | Kapsayıcı değildir |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | İçerik Başlığı bir content-kabuk pattern bloğudur. Yerel ayara ait title, rozet etiketi, giriş ve meta kopyasını saklar, title'yi her zaman H1 olarak işler, işleme sırasında eski kayıtlı başlık düzeyi değerlerini yok sayar ve hizalamayı, simge bilgisini, simge tonunu, simge boyutunu, rozet tonunu ve isteğe bağlı arka plan medyasını paylaşılan tutar. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/content_header.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/content_header.blade.php |
| Renderer kök sözleşmesi | <header> köküne sahiptir |
| Testler / kapsam | PublicEditorialBlocksRenderingTest, PageBuilderExperienceTest, BlockTypePhaseThreeContractsTest, BlockTranslationIntegrityTest, PublicIconBadgeSupportTest |
Uyarı — alert
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | alert |
| Etiket | Uyarı |
| Kategori | pattern |
| Çevrilebilir alanlar | title, content metin çeviri satırları üzerinden |
| Ortak/ayar alanları | settings.variant |
| Medya/ilişki alanları | Yok |
| Alt öğe/kapsayıcı davranışı | Kapsayıcı değildir |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Ortak varyant ile çevrilen metinler sorunsuz biçimde örtüşür. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/alert.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/alert.blade.php |
| Renderer kök sözleşmesi | Uyarı köküne kendisi sahiptir |
| Testler / kapsam | PublicEditorialBlocksRenderingTest, BlockTranslationIntegrityTest |
Gezinme
Link List — link-list
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | link-list |
| Etiket | Link List |
| Kategori | navigation |
| Çevrilebilir alanlar | title, subtitle, content metin çeviri satırları üzerinden |
| Ortak/ayar alanları | İsteğe bağlı settings.row_layout (indeks/yığılmış) ve settings.list_frame (birleştirilmiş/kartlar) |
| Medya/ilişki alanları | Alt link-list-item blokları |
| Alt öğe/kapsayıcı davranışı | Kapsayıcı; yalnızca link-list-item alt öğeleri |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | 3. Faz, alt öğe davranışını değiştirmeden mevcut çevrilmiş giriş metnini artık genel bağlantı listesinin üzerinde gösteriyor. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/link-list.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/link-list.blade.php |
| Renderer kök sözleşmesi | Alt satırlar mevcut olduğunda .wb-link-list köküne sahiptir ve seçilen stiller için wb-link-list--stacked ve wb-link-list--cards'yi ekler |
| Testler / kapsam | LinkListBlockTest, PublicEditorialBlocksRenderingTest, BlockTranslationIntegrityTest, BlockTypePhaseThreeContractsTest |
Link List Item — link-list-item
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | link-list-item |
| Etiket | Link List Item |
| Kategori | navigation |
| Çevrilebilir alanlar | Gerekli title, rozet etiketi olarak isteğe bağlı eyebrow, isteğe bağlı subtitle, metin çeviri satırları aracılığıyla isteğe bağlı content |
| Ortak/ayar alanları | Gerekli paylaşılan url, isteğe bağlı paylaşılan media_id küçük resmi, isteğe bağlı settings.icon_slug, settings.icon_tone, settings.icon_size, settings.badge_tone |
| Medya/ilişki alanları | Doğrudan blok media_id ilişkisi aracılığıyla isteğe bağlı küçük resim ortamı; üst link-list ilişkisi |
| Alt öğe/kapsayıcı davranışı | Kapsayıcı değildir |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Çevrilen satır kopyasıyla paylaşılan URL tutarlı. İsteğe bağlı simgeler, etkin content katalog bilgilerini kullanır ve yalnızca güvenli simge, ton ve boyut sınıfları aracılığıyla oluşturulur. İsteğe bağlı bir görüntü küçük resmi, satırın tek ön sütununda wb-link-list-thumb olarak oluşturulur ve her ikisi de ayarlandığında simgenin yerini alır. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/link-list-item.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/link-list-item.blade.php |
| Renderer kök sözleşmesi | Satır bağlantısı köküne sahiptir, bir küçük resim veya simge oluşturulduğunda wb-link-list-item--media'yi ekler ve content boş olduğunda açıklama öğesini atlar |
| Testler / kapsam | LinkListBlockTest, LinkListThumbnailTest, PageBuilderExperienceTest, PublicEditorialBlocksRenderingTest, BlockTranslationIntegrityTest, PublicIconBadgeSupportTest |
TOC — toc
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | toc |
| Etiket | TOC |
| Kategori | navigation |
| Çevrilebilir alanlar | Yok |
| Ortak/ayar alanları | Yalnızca kanonik title |
| Medya/ilişki alanları | Geçerli bağlantılara sahip aynı yuvada yayınlanan header blokları |
| Alt öğe/kapsayıcı davranışı | Kapsayıcı değildir; geçmişten kalan alt satırlar korunur ancak yeni alt öğe yerleştirme desteklenmez |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | TOC bir sistem bloğu türüdür. Tüm sayfayı değil, yalnızca yerleştirildiği yuvayı belge sırasına göre tarar ve artık rastgele alt bloklara genel TOC content muamelesi yapmaz. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/toc.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/toc.blade.php |
| Renderer kök sözleşmesi | Başlıklar mevcut olduğunda oluşturulan TOC sarmalayıcısına sahiptir |
| Testler / kapsam | PublicRichContentTest, PageBuilderExperienceTest, TocHeadingScanTest |
Breadcrumb — breadcrumb
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | breadcrumb |
| Etiket | Breadcrumb |
| Kategori | navigation |
| Çevrilebilir alanlar | Yok |
| Ortak/ayar alanları | Ortak settings.home_label; settings.include_current |
| Medya/ilişki alanları | Geçerli sayfa, site ve dil (locale) breadcrumb bağlamı |
| Alt öğe/kapsayıcı davranışı | Kapsayıcı değildir |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | 3. Faz, sunulan breadcrumb ayarlarını ortak BlockRequest yolu üzerinden korur; böylece form davranışı artık kalıcılık ve render işlemiyle uyumludur. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/breadcrumb.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/breadcrumb.blade.php |
| Renderer kök sözleşmesi | <nav.wb-breadcrumb> köküne sahiptir |
| Testler / kapsam | PublicEditorialBlocksRenderingTest, PageBuilderExperienceTest |
Header Actions — header-actions
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | header-actions |
| Etiket | Header Actions |
| Kategori | navigation |
| Çevrilebilir alanlar | Yok |
| Ortak/ayar alanları | Paylaşılan settings.show_mode_toggle; settings.show_accent_toggle; settings.show_search; settings.show_language_switcher |
| Medya/ilişki alanları | Arama rotası ve istemci tarafı UI kancaları |
| Alt öğe/kapsayıcı davranışı | Kapsayıcı değildir |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Sistem yardımcı bloğu; tasarım gereği çeviri sahipliği yoktur. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/header-actions.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/header-actions.blade.php |
| Renderer kök sözleşmesi | Yalnızca iç eylem kümesine sahiptir |
| Testler / kapsam | PublicEditorialBlocksRenderingTest |
Navbar — sticky-navbar
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | sticky-navbar |
| Etiket | Navbar |
| Kategori | navigation |
| Çevrilebilir alanlar | Yok |
| Ortak/ayar alanları | settings.layout_name; settings.sticky_mode |
| Medya/ilişki alanları | İç içe navbar alt blokları |
| Alt öğe/kapsayıcı davranışı | Kapsayıcı; izin verilen alt öğeler: container, cluster, header, plain_text, rich-text, button_link, navbar-brand, navbar-navigation, header-actions, search-form |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | 3. Faz, kalıcı sticky-navbar slug'ını Block::ownsPublicRoot() ile hizalar; böylece Navbar artık fazladan genel bir blok sarmalayıcısı almaz. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/sticky-navbar.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/sticky-navbar.blade.php |
| Renderer kök sözleşmesi | Genel oluşturucu dış <nav.wb-navbar> kökünün sahibidir Paylaşılan ARIA etiketi olarak |
| Testler / kapsam | PublicEditorialBlocksRenderingTest, PublicLayoutStructureTest, BlockTypePhaseThreeContractsTest |
Navbar Brand — navbar-brand
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | navbar-brand |
| Etiket | Navbar Brand |
| Kategori | navigation |
| Çevrilebilir alanlar | title, subtitle metin çeviri satırları üzerinden |
| Ortak/ayar alanları | Ortak settings.url; settings.target; settings.aria_label |
| Medya/ilişki alanları | media_id üzerinden ortak logo medyası; site ana sayfa URL'si geri dönüşü |
| Alt öğe/kapsayıcı davranışı | Kapsayıcı değildir |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | 3. Faz, yönetim tarafındaki kaydetme davranışını yayınlanan renderer sözleşmesiyle hizalar: açıkça kaydedilmiş URL önceliklidir; yoksa mevcutsa geçerli site ana sayfa yolu kullanılır, son güvenli geri dönüş olarak da / kullanılır. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/navbar-brand.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/navbar-brand.blade.php |
| Renderer kök sözleşmesi | Yalnızca iç marka bağlantısına sahiptir |
| Testler / kapsam | PublicEditorialBlocksRenderingTest, PageBuilderExperienceTest, BlockTranslationIntegrityTest, BlockTypePhaseThreeContractsTest |
Navbar Navigation — navbar-navigation
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | navbar-navigation |
| Etiket | Navbar Navigation |
| Kategori | navigation |
| Çevrilebilir alanlar | Yok |
| Ortak/ayar alanları | Canonical title; settings.menu_key; settings.active_indicator; settings.active_matching |
| Medya/ilişki alanları | Ortak NavigationItem menü ağacı |
| Alt öğe/kapsayıcı davranışı | Kapsayıcı değildir |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Paylaşılan menü bağlama, ARIA etiketi, etkin gösterge ve etkin eşleştirme, ürüne ait mevcut davranışlardır. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/navbar-navigation.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/navbar-navigation.blade.php |
| Renderer kök sözleşmesi | Yalnızca iç navigation sarmalayıcısına sahiptir ve aktif gösterge ayarlarını WebBlocks UI gezinme çubuğu aktif sınıflarıyla eşler |
| Testler / kapsam | PublicEditorialBlocksRenderingTest |
Sidebar Brand — sidebar-brand
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | sidebar-brand |
| Etiket | Sidebar Brand |
| Kategori | navigation |
| Çevrilebilir alanlar | title, subtitle metin çeviri satırları üzerinden |
| Ortak/ayar alanları | Ortak settings.url; settings.target; settings.aria_label |
| Medya/ilişki alanları | media_id üzerinden ortak logo medyası; site ana sayfa URL'si geri dönüşü |
| Alt öğe/kapsayıcı davranışı | Kapsayıcı değildir |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | 3. Faz, Sidebar Brand'e Navbar Brand ile aynı yalnızca-logo erişilebilir ad geri dönüş sırasını ve aynı temkinli ortak URL geri dönüş sözleşmesini verir. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/sidebar-brand.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/sidebar-brand.blade.php |
| Renderer kök sözleşmesi | Yalnızca iç marka bağlantısına sahiptir |
| Testler / kapsam | PublicEditorialBlocksRenderingTest, PageBuilderExperienceTest, BlockTranslationIntegrityTest, BlockTypePhaseThreeContractsTest |
Sidebar Navigation — sidebar-navigation
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | sidebar-navigation |
| Etiket | Sidebar Navigation |
| Kategori | navigation |
| Çevrilebilir alanlar | title metin çeviri satırları üzerinden |
| Ortak/ayar alanları | Ortak settings.menu_key; settings.layout_name; settings.show_icons; settings.active_matching |
| Medya/ilişki alanları | CMS NavigationItem ağacı veya manuel alt bloklar |
| Alt öğe/kapsayıcı davranışı | Kapsayıcı; yalnızca sidebar-nav-item ve sidebar-nav-group alt öğeleri |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Ortak menü modu ayarları ve manuel alt öğe modunun her ikisi de açıkça tanımlıdır. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/sidebar-navigation.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/sidebar-navigation.blade.php |
| Renderer kök sözleşmesi | <nav.wb-sidebar-nav> köküne sahiptir |
| Testler / kapsam | PublicEditorialBlocksRenderingTest, BlockTranslationIntegrityTest |
Sidebar Nav Item — sidebar-nav-item
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | sidebar-nav-item |
| Etiket | Sidebar Nav Item |
| Kategori | navigation |
| Çevrilebilir alanlar | title metin çeviri satırları üzerinden |
| Ortak/ayar alanları | Ortak settings.url; settings.target; settings.icon; settings.active_mode; settings.manual_active |
| Medya/ilişki alanları | Ortak simge kataloğu slug'ı; üst kenar çubuğu ilişkisi |
| Alt öğe/kapsayıcı davranışı | Kapsayıcı değildir |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Ortak bağlantı davranışı ile çevrilmiş etiket iyi örtüşür. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/sidebar-nav-item.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/sidebar-nav-item.blade.php |
| Renderer kök sözleşmesi | Kenar çubuğu bağlantısı köküne sahiptir |
| Testler / kapsam | PublicEditorialBlocksRenderingTest, BlockTranslationIntegrityTest |
Sidebar Nav Group — sidebar-nav-group
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | sidebar-nav-group |
| Etiket | Sidebar Nav Group |
| Kategori | navigation |
| Çevrilebilir alanlar | title metin çeviri satırları üzerinden |
| Ortak/ayar alanları | Ortak settings.icon; settings.initially_open; settings.layout_name |
| Medya/ilişki alanları | Alt sidebar-nav-item blokları; simge kataloğu slug'ı |
| Alt öğe/kapsayıcı davranışı | Kapsayıcı; yalnızca sidebar-nav-item alt öğeleri |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | 3. Faz, yayınlanan WebBlocks UI nav-group sarmalayıcı sözleşmesini korurken iç içe manuel alt bağlantılar artık href, target, simge ve etkin durum çıktısı için aynı kenar çubuğu öğesi semantiğini yeniden kullanır. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/sidebar-nav-group.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/sidebar-nav-group.blade.php |
| Renderer kök sözleşmesi | .wb-nav-group köküne sahiptir |
| Testler / kapsam | PublicEditorialBlocksRenderingTest, PageBuilderExperienceTest, BlockTranslationIntegrityTest, BlockTypePhaseThreeContractsTest |
Search Form — search-form
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | search-form |
| Etiket | Search Form |
| Kategori | navigation |
| Çevrilebilir alanlar | title, subtitle, content metin çeviri satırları üzerinden |
| Ortak/ayar alanları | Ortak variant; settings.show_button |
| Medya/ilişki alanları | Arama rotası, site ve dil (locale) bağlamı |
| Alt öğe/kapsayıcı davranışı | Kapsayıcı değildir |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Ortak düğme görüntüleme ayarları ve çevrilmiş etiketler açıkça tanımlıdır. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/search-form.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/search-form.blade.php |
| Renderer kök sözleşmesi | <form role="search"> köküne sahiptir |
| Testler / kapsam | SearchFormTest, PublicEditorialBlocksRenderingTest, BlockTranslationIntegrityTest |
Sidebar Footer — sidebar-footer
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | sidebar-footer |
| Etiket | Sidebar Footer |
| Kategori | navigation |
| Çevrilebilir alanlar | title, subtitle, content metin çeviri satırları üzerinden |
| Ortak/ayar alanları | Ortak settings.variant |
| Medya/ilişki alanları | Yok |
| Alt öğe/kapsayıcı davranışı | Kapsayıcı değildir |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Ortak varyant ile çevrilmiş metin doğrudan ve nettir. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/sidebar-footer.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/sidebar-footer.blade.php |
| Renderer kök sözleşmesi | İç altbilgi bloğu köküne sahiptir |
| Testler / kapsam | PublicEditorialBlocksRenderingTest, BlockTranslationIntegrityTest |
Formlar
Contact Form — contact_form
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | contact_form |
| Etiket | Contact Form |
| Kategori | form |
| Çevrilebilir alanlar | title, content, submit_label, success_message iletişim formu çeviri satırları üzerinden |
| Ortak/ayar alanları | Ortak settings.recipient_email; settings.send_email_notification; settings.store_submissions |
| Medya/ilişki alanları | contact_messages gönderimleri bloğa ve sayfaya geri bağlanır |
| Alt öğe/kapsayıcı davranışı | Kapsayıcı değildir |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Oluşturucu, normal ziyaretçi girişi olmayan ve manuel olarak oluşturulmaması gereken, CMS'ye ait gizli oluşturulmuş bir anti-spam kontrol alanı yayıyor. Doldurulmuş kontrol alanı gönderimleri, depolama veya bildirim gerektirmeden genel başarıyı döndürür. Yasal iletiler bildirimden önce saklanır, puanlanan spam yönetici incelemesi için saklanır, alıcı geri dönüşü blok, site, CONTACT_RECIPIENT_EMAIL, ardından MAIL_FROM_ADDRESS'dir ve İletişim sayfalarında yedek olarak Güvenilir HTML/raw formları/mailto: kullanılmamalıdır. Internal Content API content planları submit_label ve success_message'yi korur ve Almanca yerel ayar oluşturma, özel kopya olmadığında Almanca varsayılan form etiketlerini kullanır. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/contact_form.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/contact_form.blade.php |
| Renderer kök sözleşmesi | section.wb-card köküne sahiptir ve /contact-messages adresine gönderim yapan, CSRF korumalı yerel bir form üretir |
| Testler / kapsam | ContactFormModuleTest, InternalContentApiTest, ContactMailDiagnoseCommandTest |
Gelişmiş
HTML (Trusted) — html
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | html |
| Etiket | HTML (Trusted) |
| Kategori | advanced |
| Çevrilebilir alanlar | Yok |
| Ortak/ayar alanları | Kanonik güvenilir HTML content |
| Medya/ilişki alanları | Genel katman (overlay) ve gövde sonu kayıtları ayıklanmış parçaları alabilir |
| Alt öğe/kapsayıcı davranışı | Kapsayıcı değil; geçmişten kalan alt satırlar korunur ancak yeni alt öğe yerleşimi desteklenmez |
| Mevcut durum | mostly clear |
| Bilinen eksikler / notlar | 3. Faz, Trusted HTML'i genel bir alt öğe kapsayıcı sarmalayıcısı olarak ele almayı bırakır. Güvenilir işaretleme, görünür kökün ötesinde ortak katman (overlay) veya gövde sonu çıktısını yine de etkileyebilir. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/html.blade.php |
| Genel renderer kaynağı | resources/views/pages/partials/blocks/html.blade.php |
| Renderer kök sözleşmesi | Güvenilir işaretlemeyi bir <div> ile sarar; görünür kökün dışında overlay veya body-end içeriği de üretebilir. |
| Testler / kapsam | PublicEditorialBlocksRenderingTest, PublicRichContentTest, PageBuilderExperienceTest |
Yayınlanan ek sözleşmeler
Kaydırıcı — slider
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | slider |
| Etiket | Kaydırıcı |
| Kategori | layout |
| Çevrilebilir alanlar | Yok |
| Ortak/ayar alanları | settings.layout_name; settings.height; settings.min_height; settings.aspect_ratio; settings.transition; settings.interval_ms; settings.autoplay; settings.pause_on_hover; settings.show_arrows; settings.show_dots; settings.loop; settings.swipe; settings.keyboard; settings.overlay; settings.content_position; settings.content_width; settings.text_color; settings.background_fit |
| Medya/ilişki alanları | Alt slide blokları birincil ilişkidir. Slider'ın kendisi doğrudan medya sahipliğini desteklemez. |
| Alt öğe/kapsayıcı davranışı | Konteyner özellikli. İzin verilen alt tür slide'dir. |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Yok |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/slider.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/slider.blade.php |
| Renderer kök sözleşmesi | Genel <section data-wb-slider> köküne, dahili parçaya, kontrollere ve navigation noktasına sahiptir. |
| Testler / kapsam | SliderContentPositionTest |
Slayt — slide
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | slide |
| Etiket | Slayt |
| Kategori | layout |
| Çevrilebilir alanlar | Yok |
| Ortak/ayar alanları | media_id; settings.layout_name; settings.aria_label; settings.background_position; settings.background_overlay; settings.content_position; settings.content_width; settings.text_color; settings.background_fit; mobile_media_id |
| Medya/ilişki alanları | İsteğe bağlı slide arka plan ortamı, doğrudan blok media_id ilişkisi aracılığıyla sahiplenir. Alt bloklar görünür content ilişkisidir.; mobile_media_id, block_media.mobile_image aracılığıyla bir görüntü Medya Kitaplığı kaydı atar. Geçersiz kılmayı clear'ye null gönder. |
| Alt öğe/kapsayıcı davranışı | Konteyner özellikli. Geçerli yardımcıda alt türler açıkça kısıtlanmamıştır. |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Yok |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/slide.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/slide.blade.php |
| Renderer kök sözleşmesi | Genel <article class="wb-slide"> köküne sahiptir ve görünür kopyayı/kullanıcı arayüzünü iç içe geçmiş alt bloklara devreder. 768 piksele kadar görüntü alanı genişliklerinde, genel bir mobil görüntü, resim/kaynak veya arka plan görüntüsü aracılığıyla varsayılan görseli geçersiz kılar; mevcut olmayan veya kullanılamayan geçersiz kılmalar, varsayılan görüntüyü kullanır. |
| Testler / kapsam | SliderContentPositionTest |
Navigasyon Otomatik — navigation-auto
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | navigation-auto |
| Etiket | Navigasyon Otomatik |
| Kategori | navigation |
| Çevrilebilir alanlar | Yok |
| Ortak/ayar alanları | settings.menu_key |
| Medya/ilişki alanları | Geçerli site ve yerel ayar bağlamı, oluşturulan menü ağacını oluşturma sırasında çözüyor. |
| Alt öğe/kapsayıcı davranışı | Konteyner değil. Menü öğeleri alt bloklardan değil Navigasyon kayıtlarından gelir. |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Yok |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/navigation-auto.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/navigation-auto.blade.php |
| Renderer kök sözleşmesi | Genel <nav class="wb-stack wb-gap-2" data-wb-menu-key="..."> köküne sahiptir ve görünür menü ağacını, wb-link bağlantılarının iç içe geçmiş <ul> listeleri olarak işler. |
| Testler / kapsam | ManagedCtaApiTest |
Derecelendirmesi — rating
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | rating |
| Etiket | Derecelendirmesi |
| Kategori | system |
| Çevrilebilir alanlar | başlığı; altyazı |
| Ortak/ayar alanları | settings.scale; settings.allow_change; settings.show_summary; settings.data_scope |
| Medya/ilişki alanları | Geçerli sayfa, site, blok, ziyaretçi karması ve kaynak URL'si rating satırlarına kaydedilir. |
| Alt öğe/kapsayıcı davranışı | Mevcut sözleşmede kapsayıcı değil. |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Yok |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/rating.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/rating.blade.php |
| Renderer kök sözleşmesi | Genel section.wb-card.wb-rating köküne sahiptir, isteğe bağlı yerelleştirilmiş başlık/altyazı kopyası, salt okunur wb-rating-stars ortalaması ve her gönderimi /content-ratings'ye gönderen JS olmayan wb-rating-input yıldız formu oluşturur. |
| Testler / kapsam | KatılımYönetimTesti |
Yorumlar — comments
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | comments |
| Etiket | Yorumlar |
| Kategori | system |
| Çevrilebilir alanlar | Yok |
| Ortak/ayar alanları | settings.form_enabled; settings.show_approved; settings.show_author_name; settings.sort_order; settings.data_scope |
| Medya/ilişki alanları | Geçerli sayfa, site, blok, ziyaretçi karması ve kaynak URL'si yorum satırlarına kaydedilir. |
| Alt öğe/kapsayıcı davranışı | Mevcut sözleşmede kapsayıcı değil. |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Yok |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/comments.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/comments.blade.php |
| Renderer kök sözleşmesi | Genel section.wb-card köküne sahiptir, onaylı comments'yi işler ve /comment-entries'ye gönderi yapan yerel CSRF korumalı bir yorum formu yayar. |
| Testler / kapsam | KatılımYönetimTesti |
Sayfa Listesi — page-list
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | page-list |
| Etiket | Sayfa Listesi |
| Kategori | content |
| Çevrilebilir alanlar | Yok |
| Ortak/ayar alanları | settings.scope; settings.page_type; settings.path_prefix; settings.sort; settings.limit; settings.layout; settings.columns; settings.show_thumbnail; settings.show_description; settings.exclude_current; settings.clickable_card |
| Medya/ilişki alanları | Blok medya yok. Küçük resimler, oluşturma sırasında listelenen her sayfa çevirisinden çözümlenir. |
| Alt öğe/kapsayıcı davranışı | Konteyner değil. Satırlar alt bloklardan değil, sayfa sorgusundan gelir. |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Kart açıklamaları ve küçük resimler, kart yerine arama ve sosyal amaçlı yazılan SEO açıklamasını ve Açık Grafik görselini yeniden kullanır. Özel list_excerpt ve list_image sayfa ayarları planlanmıştır. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/page-list.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/page-list.blade.php |
| Renderer kök sözleşmesi | Genel köküne sahiptir: wb-card makalelerinden oluşan bir wb-grid veya layout kartlarındaki tam kart bağlantı noktaları veya layout bağlantılarındaki wb-link-list-item bağlantı noktalarından bir wb-link-list. Sorgu hiçbir sayfa döndürmediğinde hiçbir şey oluşturmaz. |
| Testler / kapsam | PageListBlockRenderTest |
Uygulaması — application
İçerik ve davranış
| Alan | Sözleşme |
|---|---|
| Slug | application |
| Etiket | Uygulaması |
| Kategori | content |
| Çevrilebilir alanlar | Yok |
| Ortak/ayar alanları | settings.application_handle; settings.application_settings; settings.width; settings.loading; settings.aspect_ratio; settings.min_height; settings.show_loading_state; settings.show_failure_state |
| Medya/ilişki alanları | Doğrudan CMS Medya ilişkisi yok. Yürütülebilir application varlıkları editoryal medya değil, kayıt defterine ait dosyalardır. |
| Alt öğe/kapsayıcı davranışı | Konteyner değil. application çalışma zamanı kendi dahili DOM'sine sahiptir. |
| Mevcut durum | clear |
| Bilinen eksikler / notlar | Uygulama kodu ve kayıt yönetimi, editoryal yerleşimden ayrı kalır; blok etkinleştirilmiş bir tanımı seçer ve ayarlarını doğrular. |
Kaynaklar ve testler
| Kaynak | Sözleşme |
|---|---|
| Yönetim formu kaynağı | resources/views/admin/blocks/types/application.blade.php |
| Genel (public) renderer kaynağı | resources/views/pages/partials/blocks/application.blade.php |
| Renderer kök sözleşmesi | .wb-application köküne sahiptir. Satır içi tanımlar güvenli bir bağlama öğesi alır; iframe tanımları CMS'ye ait bir iframe sarmalayıcısı alır. Eksik veya geçersiz tanımlar asla çevredeki sayfayı bozmaz. |
| Testler / kapsam | GömülüUygulamalarTest |
Doğrulama ve Kalıcılık Genel Bakışı
Yayınlanan blok türlerinin her birinin bugün kendi özel istek sınıfı yoktur.
WebBlocks\Cms\Http\Requests\Admin\BlockRequest, paylaşılan düzenleme isteği yoludur- İstek içindeki alanları mevcut kanonik depolamaya normalleştiren slug'a özgü dallar
WebBlocks\Cms\Support\Blocks\BlockPayloadWriternormalleştirilmiş blok yükünü sürdürürWebBlocks\Cms\Support\Blocks\BlockTranslationWriteryerele ait alanları kayıtlı aileler için çeviri satırlarına taşırWebBlocks\Cms\Support\Blocks\BlockTranslationResolverçevrilmiş veya geri dönüş değerlerini bir oluşturulabilir blok örneği
Uyumluluk Davranışı
Standart çevrilmiş içerik veya sıralı medya yoksa eski Gallery ve Table ayarları okunabilir kalabilir. Geçmiş alan yedekleri bu alanları tercih edilen oluşturma biçimi yapmaz. Güncel blok tablosundaki alanları kullanın.
Taslak katalog satırları ve yalnızca renderer uyumluluğu sağlayan handle değerleri yayınlanmış çekirdek sözleşmeler değildir. Keşif ve salt okunur sözleşme penceresi bu satırlar için dağıtılmış sözleşme bulunmadığını bildirebilir.
1.94.2'ye Kadar Medya ve Düzenleyici Eklemeleri
CMS 1.91.0'dan itibaren Slayt, Resim, Kahraman, Bölüm, Kart, CTA, İçerik Başlığı ve Bağlantı Listesi Öğesi, planlarda ve mevcut blok güncellemelerinde isteğe bağlı mobile_media_id'yi destekler. İlişki block_media.role = mobile_image'yi kullanır, yerel ayarlar arasında paylaşılır ve 768 piksele kadar varsayılan görüntüyü, kullanılamadığında geri dönüşle değiştirir. Ayrı mobil alternatif metin veya altyazı sunmaz. Bkz. Medya Görüntüsü Çeşitleri.
1.91.1'den itibaren, Slide ve Slider dokuz içerik konumu sunar: merkez, merkez sol, merkez sağ, sol üst, orta üst, sağ üst, sol alt, orta alt ve sağ alt. Bu değerler yönetici, API ve oluşturucu tarafından paylaşılır.
1.93.0'dan itibaren, Zengin Metin düzenleyicisinde alan başına geri alma/yineleme, seçimi geri yükleme, odak modu ve kelime sayma özellikleri bulunmaktadır. Yapıştırılan başlıklar ve tablo hücresi metni, güvenli gövde paragrafları olarak kalır; anlamsal başlıklar, tablolar ve medya özel bloklara aittir. Bu, yeni bir depolanan Zengin Metin çeşidi eklemez veya yürütülebilir işaretlemeye izin vermez. Bkz. Zengin Metin.