WebBlocks CMS Envanteri
Amaç
Bu, WebBlocks CMS için kompakt, yapay zekaya yönelik tasarım ve yazma sözleşmesidir. Internal Content API aracılığıyla bir sayfa tasarımı önermeden veya uygulamadan önce bunu okuyun.
Gönderilen her çekirdek blok için beş soruyu yanıtlıyor:
- CMS yöneticisinde hangi içerik düzenlenebilir durumda kalır?
- Hangi paylaşılan ayarlar ve değişkenler destekleniyor?
- Hangi çocuk ve medya ilişkileri geçerlidir?
- Oluşturucu hangi kararlı genel HTML'yi yayıyor?
- Ham sayfa HTML olmadan blok hangi görsel sonucu üretebilir?
Bu belge kaynak destekli davranışı özetlemektedir. Live API keşfi, yüklemeye özel kimlikler, etkin eklentiler, özel blok türleri, yerel ayarlar, düzenler, medya kayıtları, gezinme menüleri ve yetenekler için yetkili olmaya devam ediyor.
Denetim Temel Çizgisi
- Depo:
fklavyenet/webblocks-cms - Şube:
main - Denetlenen taahhüt:
741a44bc0fe00bf38cae0753bd9edb02978b0dbe - Denetlenmiş sürüm belgeleri:
1.40.2 - Denetim tarihi:
2026-07-14 - Depo şekli: yalnızca paket Composer paketi
- Yayınlanan temel katalog satırları:
51 - Taslak eski katalog satırları:
7 - Aşağıdaki politika uygulandıktan sonra yapay zeka tarafından yazılabilir yapılandırılmış temel satırlar:
50 - Aşağıdaki politika uygulandıktan sonra AI tarafından yazılabilir ham HTML satırları:
0
Denetimden bu yana yapılan değişiklikler
Yukarıdaki temel çizgi hâlâ son tam denetimdir. Bu girişler düzeltildi
her bloğu yeniden denetlemek yerine daha sonra kaynağa karşı kullanın, bu nedenle her şeyi değerlendirin
bu listenin dışında 1.40.2 dönemi olarak bulun ve bunu canlı API keşfi yoluyla onaylayın.
card(1.40.5):variantKart stili mevcuttur. Bu belge daha önce desteklenen Kart görsel değişken alanının bulunmadığını belirtti, bu yanlıştı1.40.5'den itibaren.link-list(1.40.10):settings.row_layoutvesettings.list_frame.link-list-item(1.40.8): isteğe bağlımedia_idküçük resmi.1.91.0: sekiz yerel medya bloğunda isteğe bağlı mobil görüntü ilişkileri.1.91.1: dokuz Slayt ve Kaydırıcı içerik konumunun tümü.1.93.0: Zengin Metin geri alma/yineleme, odak modu, kelime sayımı ve güvenli yapıştırma davranışı.1.94.0–1.94.2: yönetilen eklenti başlangıç doğrulaması, karantina, tutulan paketler ve aktif hesap kurtarma kontrolleri.
Tarihsel depo notu: Yalnızca ön paket CMS ağacı, geniş bir ürün özelliği keşfedilebilirlik matrisi olan docs/feature-inventory.md'yi içeriyordu. Yalnızca paket veri havuzu ağacı oluşturulduğunda kaldırıldı ve blok başına AI yazma envanteri değildi. Çalışma zamanı sözleşmesi artık resources/contracts/inventory.md'de yaşıyor.
İncelenen kaynak aileler:
src/Support/Blocks/CoreBlockTypeCatalogSyncer.phpsrc/Support/BlockTypes/BlockTypeContractRegistry.phpsrc/Support/Blocks/BlockTranslationRegistry.phpsrc/Models/Block.phpsrc/Http/Requests/Admin/BlockRequest.phpsrc/Support/InternalContentApi/InternalContentPlanService.phpsrc/Support/InternalContentApi/InternalContentApiOperations.phpsrc/Http/Controllers/InternalContentApi/InternalContentResourceController.phpsrc/Http/Controllers/InternalContentApi/InternalSharedSlotController.phpsrc/Http/Controllers/InternalContentApi/InternalApiDiscoveryController.phproutes/admin.phpresources/views/admin/blocks/types/*.blade.phpresources/views/admin/blocks/settings/*.blade.phpresources/views/pages/partials/blocks/*.blade.phppublic/cms/css/public.css- odaklanmış paket testleri ve güncel ürün dokümantasyonu
Pazarlık Edilemez Yapay Zeka Yazma Kuralları
- Yapılandırılmış blokları kullanın. Güvenilir HTML'de bir sayfayı, bölümü, kart koleksiyonunu, gezinme kabuğunu, formu veya görsel bileşeni saklamayın.
htmlyalnızca insanların kullanabileceği bir kaçış kapısıdır. API keşfi onu kullanılamaz olarak tanımlayabilir ancak hiçbir API mutasyonu bir HTML bloğunu oluşturamaz, güncelleyemez, değiştiremez, taşıyamaz, yeniden sıralayamaz, klonlayamaz, tanıtamaz, yayınlayamaz veya silemez.- Zengin Metin,
<style>,<script>, olay işleyici nitelikleri, iframe işaretlemesi, SVG işaretlemesi, kodlanmış işaretleme veya icat edilen ayarlar aracılığıyla HTML kısıtlamasını atlamayın. - Yalnızca burada belgelenen ve canlı keşifle onaylanan alanları, numaralandırma değerlerini, medya rollerini ve alt ilişkileri kullanın.
- Yönetici tarafından düzenlenebilir bir alanı, desteklenen yazma sözleşmesinin bir parçası olarak değerlendirin. Yalnızca oluşturucu veya eski uyumluluk yolu tarafından tanınan bir değer, normal bir AI yazma alanı değildir.
- Desteklenen sözleşmeyle görsel bir bölge ifade edilemiyorsa durun ve bir yetenek açığını bildirin. Sessizce ilgisiz bloklarla yaklaşmayın ve HTML'ye geri dönmeyin.
- CSS Sitesi, sabit genel kancalar aracılığıyla tipografiyi, aralığı, rengi, sınırları, gölgeleri ve duyarlı sunumu iyileştirebilir. Gizli bir içerik deposu haline gelmemeli veya eksik anlamsal işaretlemeyi yeniden yapılandırmamalıdır.
- Temel tasarım davranışı için veritabanı kimliklerini, oluşturulan blok kimliklerini, kardeş konum seçicilerini veya
:nth-child()'yi hedeflemeyin. Blok tipi nitelikleri, yerelwb-*sınıflarını, sayfa gövdesi sınıflarını ve belgelenmiş ayarları tercih edin. - Görünür her başlığı, paragrafı, etiketi, düğmeyi, rozeti, resmi, resim yazısını, menüyü ve form ayarını yerel CMS alanı veya ilgili kayıt aracılığıyla düzenlenebilir tutun.
- Önce doğrulayın, yalnızca açık kullanıcı onayından sonra uygulayın, önce taslaklar oluşturun ve ayrı olarak yetkilendirilmedikçe canlı sistem güncelleme eylemlerini ve canlı görsel testleri insan operatöre bırakın.
- Kartı, ilgili kopyayı gruplandırmanın varsayılan yolu değil, isteğe bağlı sunum olarak değerlendirin. Bir Kartı yalnızca ürün, eklenti, fiyat planı, indirme veya form gibi bağımsız olarak işlem yapılabilir, tekrarlanabilir veya sınırlı bir varlık için kullanın.
- Blokları seçmeden önce karakter, yoğunluk, tipografi, geometri, görüntü, köşeler ve kontrastı kapsayan site düzeyinde bir tasarım yönü belirtin. Her bölümü ayrı ayrı seçmek yerine blok ağacının ve CSS sitesinin bu yönü uygulamasını sağlayın.
- Sayfa ritmini bilinçli olarak değiştirin. Dar, düzenli, geniş ve tam genişlikli bölgeleri birleştirin; Eşit ağırlıklı bölümleri tekrarlamak yerine alternatif sessiz metin, baskın görüntüler ve yapılandırılmış koleksiyonlar.
HTML Blok API Politikası
Hedef ürün sözleşmesi:
| Yüzey | html davranışı |
|---|---|
| CMS yöneticisi | İnsan operatörler, incelenen Güvenilir HTML'yi oluşturabilir ve düzenleyebilir. |
| Genel oluşturucu | Mevcut yayınlanmış HTML blokları oluşturulmaya devam ediyor. |
| API keşfi | Bloğu api_readable: true, api_writable: false, authoring: human_only olarak bildirin ve kısıtlamayı açıklayın. Yazılabilir bir yük örneği sunmayın. |
| İçerik doğrulama/uygulama | Kararlı kod block_type_not_api_writable ile her yeni veya değiştirilen html verisini reddedin. |
| Artımlı sayfa/paylaşılan alan bloğu oluşturma | Normalleştirme veya kalıcılıktan önce html'yi reddedin. |
| Mevcut blok PATCH | Hedef blok türü html olduğunda, gönderilen alan aksi takdirde güvenli kabul edilecek olsa bile reddet. |
| Yeniden sıralama, taşıma, silme, yuva değiştirme, aşamalı güncelleme ve tanıtım | Etkilenen alt ağacı veya değiştirme kapsamı mevcut bir HTML bloğu içeren tüm mutasyonları reddedin. Yan etki olarak silmeyin. |
| API belirteci yetenekleri | Hiçbir yetenek, ürün düzeyindeki kısıtlamayı geçersiz kılamaz. |
| Uç noktaları okuyun | Seçilen okuma politikasına göre mevcut bloğu inceleme için iade edebilir; okuma erişimi hiçbir zaman yazma erişimini ima etmemelidir. |
Bu politika, kodda tek bir ürün politikası sınıfı olan WebBlocks\Cms\Support\BlockTypes\BlockTypeApiAuthoringPolicy tarafından uygulanır. Her API yüzeyi, kuralı tekrarlamak yerine buna başvurur: hem blok normalleştiriciler, mevcut blok PATCH, sayfa ve Shared Slot artımlı oluşturma, sayfa/Shared Slot yeniden sıralama, alt ağaç silme, Shared Slot tümünü temizleme, sayfa ve Shared Slot yayınlama, taslak yuvası değiştirme, aşamalı güncelleme oluşturma ve yükseltme, Shared Slot atama, ve API sayfasını silme. Reddetmeler herhangi bir işlem veya yazmadan önce gerçekleşir, block_type_not_api_writable kararlı koduyla HTTP 422'yi döndürür ve hiçbir kısmi değişiklik bırakmaz. Hiçbir belirteç özelliği bunu geçersiz kılmaz.
“CMS Yönetilebilirliği” Ne Demektir?
Bir tasarım yalnızca aşağıdakilerin tümü doğru olduğunda CMS tarafından yönetilebilir:
- Görünür içerik yerel çeviri alanlarında, ayarlarda, Medya Kitaplığı ilişkilerinde, Gezinme kayıtlarında, Ticaret kayıtlarında veya alt bloklarda depolanır.
- Normal blok düzenleyici, sonucu korumak için gereken alanları ortaya çıkarır.
- Genel işaretleme, sayfa içeriğinden değil, bir paket veya eklenti oluşturucudan gelir.
- Sunumda belgelenmiş değişkenler, ayarlar, tema belirteçleri ve kararlı CSS kancaları kullanılır.
- İçeriği yeniden sıralamak veya düzenlemek, HTML veya CSS'nin düzenlenmesini gerektirmez.
- Mobil davranış, içerikteki yinelenen mobil işaretleme yerine oluşturucudan, WebBlocks UI veya kararlı site CSS'den gelir.
Oluşturucu, normal yönetici formunun göstermediği eski veya dahili bir değeri tanıyabilir. Böyle bir değer, önerilen bir AI yazma alanı olarak değil, bir uyumluluk girişi olarak belgelenir.
Tasarım Karar Tablosu
| Görsel ihtiyaç | Tercih edilen sözleşme | Durdurma koşulu |
|---|---|---|
| Ana sayfa grubu | Alt bloklu section | Görünür kopyayı Bölüm ayarlarına koymayın. |
| Genişlik kısıtlaması | container | Kabı kart veya yüzey olarak kullanmayın. |
| Dikey içerik ritmi | stack | Kabı yalnızca dikey akış elde etmek için kullanmayın. |
| Ana içerik artı kısa bir eylem veya değer | split | Tam olarak iki doğrudan çocuk kullanın; Bir tarafın birden fazla bloğa ihtiyacı olduğunda yuva yığını. |
| Yatay eylemler veya kompakt öğeler | cluster | Tek bir düğme satırı için Izgarayı kullanmayın. |
| Duyarlı tekrarlanan hücreler | grid yapılandırılmış çocuklu | Semantik tabloyu taklit etmek için Grid'i kullanmayın. |
| Sayfa başlığı, giriş, rozet, simge, meta veriler | content_header | Her zaman bir H1'e sahiptir; sıradan iç içe geçmiş başlıklar için kullanmayın. |
| Pazarlamaya giriş | hero | Hero sol, orta, bölünmüş ve tam çerçeve düzenlerini destekler; bölünmüş ön plan medyasını oluştururken tam çerçeve çerçevesiz bir fotoğraf bandı oluşturur. Tasarım ikinci bir düzenlenebilir ön plan görüntüsü veya isteğe bağlı olarak iç içe geçmiş içerik gerektirdiğinde bir boşluk bildirin. |
| Dönüşüm bandı | cta | Mevcut CTA, yönetilen eski düğme alt öğeleri dışındaki normal yapılandırılmış alt öğeleri kabul etmemektedir. |
| Tekrarlanan özellik veya istatistik öğeleri | columns ve column_item | Rastgele yuvalanmış içeriğe ihtiyaç duyulduğunda grid ve şekillendirilebilir card'yi tercih edin. |
| Şekillendirilebilir kart | card plus Kart bölgeleri | Yalnızca bağımsız olarak sınırlandırılmış/işlem yapılabilir içerik için kullanın; varyantlar varsayılan, düz, sessiz, vurgulu ve vurguludur. |
| Tek anlamsal görüntü | image | Koleksiyonlar için Galeri'yi ve desteklenen arka planlar için arka plan medya alanlarını kullanın. |
| Resim koleksiyonu | gallery | Ayrı bir HTML ışık kutusu eklemeyin. |
| Kaydırıcı/atlıkarınca | slider artı slide | İçerik yalnızca bir resim koleksiyonu olduğunda Galeri'yi kullanın. |
| Navigasyon | Gezinme kayıtları artı Gezinme Çubuğu/Kenar Çubuğu blokları | Gezinme bağlantılarını HTML'ye sabit kodlamayın. |
| İletişim formu | contact_form | Ham <form> işaretlemesini veya mailto:'yi normal form olarak kullanmayın. |
| Derecelendirmeler/yorumlar | rating ve comments | HTML'deki etkileşim deposunu veya formlarını çoğaltmayın. |
| Desteklenmeyen tek seferlik kompozisyon | Yetenek açığı raporu | Hiçbir zaman varsayılan olarak html'yi kullanmayın. |
Kanonik İçerik Planı Şekli
Yuvalanmış children dizilerini kullanın. İçerik planında veritabanı ilişki kimliklerini göndermeyin.
{
"type": "section",
"settings": {
"spacing": "lg"
},
"children": [
{
"type": "container",
"settings": {
"width": "lg"
},
"children": [
{
"type": "plain_text",
"translations": {
"content": "Editable copy"
}
}
]
}
]
}
İçerik planı kuralları:
- Seçilen plan yerel ayarı için yerel ayara ait kopyayı doğrudan
translationsaltına yerleştirin. - URL'yi, hedefi, sunum değişkenini ve diğer paylaşılan seçenekleri
settingsaltına yerleştirin. - Doğrudan Medya Kitaplığı atamasını
media_id'ye yerleştirin. slide,image,hero,section,card,cta,content_headervelink-list-itemayrıca isteğe bağlı üst düzeymobile_media_idreferanslamayı da kabul eder bir görüntü Medya Kitaplığı kaydı. Rol ileblock_media'de saklanırmobile_image, yerel ayarlar arasında paylaşılır ve yönetici ortamı aracılığıyla düzenlenebilir seçici vePATCH /blocks/{block}. 768 piksel genişliğe kadar olan ekranlarda yerini alır varsayılan görüntü; bulunmayan, silinmiş veya özel bir mobil görüntü, varsayılan. Temizlemek içinnullgönderin; PATCH'te bunu atlamak onu korur. Ön plan görsellerinde<picture><source media="(max-width: 768px)">kullanılır; arka plan blokları duyarlı bir CSS arka planı kullanır. Başka bir ürün kullanın aynı görsel: alternatif metin, altyazılar, konum, sığdırma, kaplamalar ve bağlantılar kalır Paylaşıldı. Resim bloğunun Galeri Görüntüleyicisi varsayılanı açmaya devam ediyor tam çözünürlüklü görüntü. Galeri öğeleri, marka logoları, video ve ses bu alanı kabul edin.- Galeri öğelerini
gallery_itemsveyagallery_media_ids'ye yerleştirin. - Yalnızca yuvalanmış
childrenkullanın;id,parent_id,block_id,slot_type_idveyablock_type_idgöndermeyin. - API şu anda geniş şekilli bir
settingsnesnesini kabul etmektedir. Bu müsamahakarlık, ayarları icat etme izni değildir; yalnızca aşağıda listelenen tuşları kullanın.
Genel Görüntüleme Kabuğu
Normal ana yuva işleme şunları sağlar:
<main class="wb-public-main" id="main-content">
<div class="wb-container wb-container-lg">
<div class="wb-stack wb-gap-6">
<!-- page blocks -->
</div>
</div>
</main>
kök sahibi olarak işaretlenen bloklar, data-wb-public-block-type'yi kendi anlamsal köklerine yerleştirir. Diğer üst düzey bloklar normalde şunları alır:
<div class="wb-public-block" data-wb-public-block-type="block-handle">
<!-- renderer output -->
</div>
Alt çizgiler data-wb-public-block-type'de kısa çizgilere normalleştirilir; örneğin content_header, content-header olur.
Hızlı Katalog Dizini
Mevcut yayınlanan çekirdek katalog 55 satır içerir:
| Grubu | Kollar |
|---|---|
| Düzen ve kompozisyon | section, container, stack, split, cluster, grid, card, card_header, card_body, card_footer, slider, slide |
| Editörlük ve pazarlama | header, plain_text, rich-text, content_header, hero, cta, columns, column_item, feature-grid, feature-item, stat-card, image, gallery, download, file, video, audio, code, button_link, table, quote, page-list, application |
| Navigasyon | link-list, link-list-item, navigation-auto, toc, breadcrumb, header-actions, sticky-navbar, navbar-brand, navbar-navigation, sidebar-brand, sidebar-navigation, sidebar-nav-item, sidebar-nav-group, search-form, sidebar-footer |
| Desen, form ve etkileşim | alert, contact_form, rating, comments |
| Yalnızca insan gelişmiş | HTML |
Yerleşim ve Kompozisyon Blokları
section — Bölüm
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Amaç | Başlıca anlamsal sayfa bandı ve alt gruplandırma. |
| Yönetici tarafından düzenlenebilir içerik | Görünür kopya yok. İsteğe bağlı settings.layout_name yalnızca düzenleyici meta verileridir. |
| Ayarlar | spacing: empty, sm, lg; flow: normal, offset-up, overlap-previous; isteğe bağlı arka plan media_id; background_position: center, top, bottom, left, right; background_overlay: soft, medium, strong, none. |
| Çocuklar | Desteklenen herhangi bir yayınlanmış alt tür; API planları için en az bir işlenebilir alt öğe gereklidir. |
| HTML | Kök sahibi <section class="wb-section [wb-section-sm or wb-section-lg] [wb-public-section--offset-up or wb-public-section--overlap-previous] wb-stack" data-wb-public-block-type="section">…</section>. Arka plan medyası, pakete ait sınıf/stil kancaları ekler. Akış değiştiriciler küçük ekranlarda sıfırlanır. |
| Örnek görünüm | Kısıtlanmış bir Konteyner içeren tam genişlikte temalı bir grup veya tekdüze dikey ritmi bozan kasıtlı olarak kaydırılmış bir bant. |
| Kaçının | Ayarlarda görünen metin, boş krom, Bölümün kart olarak kullanılması veya birkaç ardışık bölümün üst üste binmesi. |
container — Konteyner
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Amaç | Genişlik kısıtlaması ve isteğe bağlı alt akış. |
| Yönetici tarafından düzenlenebilir içerik | Görünür kopya yok; isteğe bağlı yalnızca düzenleyici layout_name. |
| Ayarlar | width: empty, sm, md, lg, xl, full; flow: stack or none. |
| Çocuklar | Desteklenen herhangi bir yayınlanmış alt tür; API planlarının gerektirdiği en az bir çocuk. |
| HTML | Kök sahibi <div class="wb-container [wb-container-*] [optional wb-stack]" data-wb-public-block-type="container">…</div>; wb-stack, açık flow: stack gerektirir. |
| Örnek görünüm | Maksimum genişliğe sahip ortalanmış sayfa içeriği; nötr varsayılan, doğrudan Navbar'ın içindeki bir Küme ile oluşturulur. |
| Kaçının | Genişliği bir yüzey, kart veya tema rolü olarak ele almak. |
stack — Yığın
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Amaç | Doğrudan alt bloklar arasında dikey akış ve tutarlı ritim. |
| Yönetici tarafından düzenlenebilir içerik | Görünür kopya yok; isteğe bağlı yalnızca düzenleyici layout_name. |
| Ayarlar | spacing: empty/default, 1, 2, 3, 4, 6, 8. |
| Çocuklar | Desteklenen herhangi bir yayınlanmış alt tür; API planlarının gerektirdiği en az bir çocuk. |
| HTML | Kök sahibi <div class="wb-stack [wb-stack-{n}]" data-wb-public-block-type="stack">…</div>. |
| Örnek görünüm | Yukarıdan aşağıya doğru düzenlenmiş bir ürün adı, açıklaması ve destekleyici not. |
| Kaçının | Sayfa genişliği kontrolü, yatay eylemler veya eşit sütunlar. |
split — Bölünmüş
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Amaç | İlk çocuğun büyüdüğü ve ikincisinin içerik boyutunda kaldığı iki taraflı kompozisyon. |
| Yönetici tarafından düzenlenebilir içerik | Görünür kopya yok; isteğe bağlı yalnızca düzenleyici layout_name. |
| Ayarlar | gap: empty/default, 0, 1, 2, 3, 4, 6, 8; items_alignment: center/default, start, end, stretch; width: auto/default or full; responsive: stack or preserve. New admin/API blocks default to stack while existing empty settings preserve the legacy row. |
| Çocuklar | Tam olarak iki doğrudan çocuk. Bir tarafın birden fazla bloğa ihtiyacı olduğunda her iki tarafa da bir Yığın koyun. |
| HTML | İzin verilenler listesine eklenen wb-* sınıflarıyla kök sahibi <div class="wb-split …" data-wb-public-block-type="split">…</div>. Duyarlı yığın, pakete ait .wb-public-split--stack-mobile'yi ekler ve 48rem ve altında tam genişlikte bir sütuna dönüşür. |
| Örnek görünüm | Solda ürün kimliği ve sağda fiyat artı satın alma işlemi. |
| Kaçının | Tekrarlanan eşit sütunlar, düğme gruplarını sarmalama veya ikiden fazla doğrudan alt öğe. |
cluster — Küme
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Amaç | Yatay veya satır içi kompozisyon, özellikle eylemler ve gezinme çubuğu iç kısımları. |
| Yönetici tarafından düzenlenebilir içerik | Görünür kopya yok; isteğe bağlı yalnızca düzenleyici layout_name. |
| Ayarlar | gap: empty, none, xs, sm, md, lg; alignment: start/default, center, end, between; items_alignment: center/default, start, end, stretch; wrap: wrap/default or nowrap; width: auto/default or full. |
| Çocuklar | Desteklenen herhangi bir yayınlanmış alt tür; API planlarının gerektirdiği en az bir çocuk. |
| HTML | İzin verilenler listesine eklenen wb-* sınıflarıyla kök sahibi <div class="wb-cluster …" data-wb-public-block-type="cluster">…</div>. |
| Örnek görünüm | Duyarlı, iki düğmeli bir CTA satırı veya marka/gezinme/eylemler satırı. |
| Kaçının | Büyük tekrarlanan kart ızgaraları. |
grid — Izgara
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Amaç | Duyarlı çok sütunlu düzen. |
| Yönetici tarafından düzenlenebilir içerik | Görünür kopya yok; isteğe bağlı yalnızca düzenleyici layout_name. |
| Ayarlar | columns: 2, 3, 4; ratio: equal, lead-left, lead-right (asymmetric ratios apply only to two columns); gap: empty, 3, 4, 6; alternate_media_text_sections: boolean; alternate_start: media_left or text_left. |
| Çocuklar | Desteklenen herhangi bir yayınlanmış alt tür; API planlarının gerektirdiği en az bir çocuk. |
| HTML | Kök sahibi <div class="wb-grid wb-grid-{n} [wb-gap-{n}] [wb-public-grid--lead-*]" data-wb-public-block-type="grid">…</div>. Potansiyel müşteri oranları, normal tek sütunlu mobil sınır noktasının 2:1 veya 1:2 üzerinde oluşturulur. Alternatif mod, kökü değiştirmeden doğrudan alt sırayı değiştirebilir. |
| Örnek görünüm | Bir özellik satırındaki üç Kart bloğu veya sola ve sağa değişen eşleştirilmiş Görüntü/içerik grupları. |
| Kaçının | Anlamsal tablolar veya kompakt bir eylem satırı. |
card — Kart
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Amaç | Şekillendirilebilir çerçeveli yüzey. |
| Yönetici tarafından düzenlenebilir içerik | Normal görünür ana kopya yok; isteğe bağlı yalnızca düzenleyici layout_name. Eski bölge dışı Kart satırları eski kopyayı oluşturmaya devam edebilir. |
| Ayarlar | Paylaşılan variant sütununda isteğe bağlı Kart stili: flat, muted, highlight, accent; boş bir variant varsayılan kartı oluşturur. İsteğe bağlı arka plan resmi media_id, background_position, background_overlay. İsteğe bağlı url ve target, şekillendirilebilir Kartın tamamını tek bir anlamsal bağlantı haline getirir. |
| Çocuklar | Doğrudan çocuklar card_header, card_body, card_footer ile sınırlıdır; API planlarının gerektirdiği en az bir çocuk. |
| HTML | Tam kart URL'si yapılandırıldığında kök sahibi <article class="wb-card">…</article> veya <a class="wb-card wb-no-decoration">…</a>. Bağlantılı Kartlar iç içe geçmiş etkileşimli kontroller içermemelidir. |
| Örnek görünüm | Tek bir yerel Kart kabuğunun içinde resim veya simge başlığı, düzenlenebilir gövde içeriği ve eylem altbilgisi. |
| Kaçının | Kartların içine yerleştirilmiş veya yeni içerik için eski ana kopyayı kullanan kartlar. |
card_header — Kart Başlığı
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Amaç | Kartın içindeki başlık bölgesi. |
| Yönetici tarafından düzenlenebilir içerik | Doğrudan kopya yok; alt bloklar içeriği tutar. İsteğe bağlı yalnızca düzenleyici layout_name. |
| Ayarlar | Aktif içerik simgesi kataloğundan icon_slug; icon_tone: default, soft, brand, accent, highlight, bold, quiet; icon_size: default, sm, lg, xl. |
| Çocuklar | Yapılandırılmış içerik çocukları. Kart bölgesi bloklarını iç içe yerleştirmeyin. Normal yerleştirme doğrudan Kartın altındadır. |
| HTML | Kök sahibi <div class="wb-card-header" data-wb-public-block-type="card-header">[icon]…</div>. |
| Örnek görünüm | Katalog simgesi ve iç içe geçmiş Üstbilgi/Düz Metin içeren kart başlığı satırı. |
| Kaçının | Kartın dışına yerleştirme. |
card_body — Kart Gövdesi
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Amaç | Kartın içindeki ana içerik bölgesi. |
| Yönetici tarafından düzenlenebilir içerik | Doğrudan kopya yok; alt bloklar içeriği tutar. İsteğe bağlı yalnızca düzenleyici layout_name. |
| Ayarlar | Yalnızca düzenleyiciye yönelik layout_name dışında halka açık görsel ayar yoktur. |
| Çocuklar | Yapılandırılmış içerik çocukları; API planları en az bir tane gerektirir. Kart bölgesi bloklarını iç içe yerleştirmeyin. |
| HTML | Kök sahibi <div class="wb-card-body" data-wb-public-block-type="card-body">…</div>. |
| Örnek görünüm | Kart kopyalama, Resim, Zengin Metin veya küçük bir düğme kümesi. |
| Kaçının | Kartın dışına yerleştirme. |
card_footer — Kart Alt Bilgisi
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Amaç | Kartın içindeki destek veya eylem bölgesi. |
| Yönetici tarafından düzenlenebilir içerik | Doğrudan kopya yok; alt bloklar içeriği tutar. İsteğe bağlı yalnızca düzenleyici layout_name. |
| Ayarlar | Yalnızca düzenleyiciye yönelik layout_name dışında halka açık görsel ayar yoktur. |
| Çocuklar | Yapılandırılmış içerik çocukları; API planları en az bir tane gerektirir. Kart bölgesi bloklarını iç içe yerleştirmeyin. |
| HTML | Kök sahibi <div class="wb-card-footer" data-wb-public-block-type="card-footer">…</div>. |
| Örnek görünüm | Yuvalanmış bir Küme tarafından hizalanmış bir veya iki Button Link alt öğesi. |
| Kaçının | Kartın dışına yerleştirme. |
slider — Kaydırıcı
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Amaç | Yerleştirilen kabı dolduran şekillendirilebilir atlıkarınca. |
| Yönetici tarafından düzenlenebilir içerik | Görünür ana kopya yok; isteğe bağlı yalnızca düzenleyici layout_name. |
| Ayarlar | height: auto, fill, viewport, large, medium, small, custom; isteğe bağlı min_height; aspect_ratio: 16/9, 4/3, 1/1; interval_ms: 1000–30000; boolean'lar autoplay, pause_on_hover, show_arrows, show_dots, loop, swipe, keyboard; overlay: none/default, soft, medium, dark, strong; content_position: center/default, center-left, center-right, top-left, top-center, top-right, bottom-left, bottom-center, bottom-right; content_width: medium/default, narrow, wide, full; text_color: auto/default, light, dark; background_fit: cover/default or contain. Transition is currently normalized to slide. |
| Çocuklar | Yalnızca slide; en az bir Slayt gereklidir. |
| HTML | Görüntü alanı, izleme, isteğe bağlı oklar ve noktalarla kök sahibi <section class="wb-slider …" data-wb-slider data-wb-public-block-type="slider">. |
| Örnek görünüm | Düzenlenebilir alt içeriğe sahip tam genişlikte kahraman atlıkarınca, kart içeren kaydırıcı veya arka plan medya panelleri. |
| Kaçının | Statik resim galerileri. |
slide — Slayt
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Amaç | Slider'ın içindeki bir panel. |
| Yönetici tarafından düzenlenebilir içerik | Doğrudan görünür kopya yok; isteğe bağlı yalnızca düzenleyici layout_name ve paylaşılan aria_label. |
| Ayarlar | Arka plan resmi media_id; background_position; background_overlay (none, soft, medium, strong — WebBlocks UI 2.22.0'dan bu yana her biri ayrı bir ince kumaş oluşturuyor; medium, strong'nin üzerine çökmeden önce); content_position: center/default, center-left, center-right, top-left, top-center, top-right, bottom-left, bottom-center, bottom-right; content_width; text_color; background_fit. |
| Çocuklar | Desteklenen herhangi bir yapılandırılmış alt tür; yalnızca arka planda bir Slayt'a izin verilir. Normal ebeveyn Slider'dır. |
| HTML | Kök sahibi <article class="wb-slide …" data-wb-public-block-type="slide">[img.wb-slide-media]<div class="wb-slide-content">…</div></article>. |
| Örnek görünüm | Yuvalanmış Başlık, Düz Metin ve Düğme Bağlantısı içeriğine sahip arka plan ürün fotoğrafı. |
| Kaçının | Atlıkarınca semantiği amaçlanmadığında bağımsız üst düzey kullanım. |
Yazım ve Pazarlama Blokları
header — Başlık
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | translations.title. |
| Ayarlar ve çeşitleri | settings.variant: h1–h6; alignment: left, center, right; anchor: safe same-page ID. |
| Çocuklar/medya | Hiçbiri. |
| HTML | İsteğe bağlı hizalama sınıfı ve id ile <h1>'den <h6>'ye kadar kök sahibi. |
| Örnek görünüm | TOC tarafından indekslenebilecek anlamsal bölüm başlığı. |
| Kaçının | Meta veriler içeren sayfa girişi; İçerik Başlığını kullanın. |
plain_text — Düz Metin
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | translations.content, çıkışlı düz metin olarak. |
| Ayarlar ve çeşitleri | alignment: left, center, right. |
| Çocuklar/medya | Hiçbiri. |
| HTML | Genel ambalaj artı <p class="[wb-text-*]">…</p>. |
| Örnek görünüm | Kısa paragraf, etiket veya destekleyici cümle. |
| Kaçının | Listeler, bağlantılar, başlıklar veya biçimlendirilmiş gövde kopyası. |
rich-text — Zengin Metin
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | Güvenli Zengin Metin düzenleyicisi ve temizleyici aracılığıyla translations.content; düzenleyici geçmişi, bir kelime sayacı ve isteğe bağlı odaklama moduyla geri almayı/yinelemeyi destekler. |
| Ayarlar ve çeşitleri | Hiçbiri. Desteklenmeyen biçimlendirme, nitelikler ve sınıflar kaldırılır; yapıştırılan başlıklar ve tablo hücreleri, metinlerini paragraf olarak korur ve yürütülebilir dosya/medya işaretlemesi kaldırılır. |
| Çocuklar/medya | Hiçbiri. |
| HTML | Genel ambalaj artı <div class="wb-rich-text">[sanitized editorial markup]</div>. |
| Örnek görünüm | Güvenli satır içi vurgu, bağlantılar ve basit listeler içeren birkaç paragraf. |
| Kaçının | Düzen işaretlemesi, <style>, komut dosyaları, iframe'ler, formlar, düğmeler, tablolar veya tam sayfa. |
content_header — İçerik Başlığı
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | Giriş olarak translations.title, translations.subtitle, isteğe bağlı rozet etiketi olarak translations.eyebrow, meta veri öğeleri olarak translations.meta. |
| Ayarlar ve çeşitleri | alignment: left, center, right; icon_slug; icon_tone; icon_size: default, sm, lg, xl; badge_tone: neutral, info, success, warning, danger; isteğe bağlı arka plan görüntüsü ve kaplama ayarları. |
| Çocuklar/medya | Çocuk yok; doğrudan görüntü media_id arka plan ortamıdır. |
| HTML | Kök sahibi<header class="wb-content-header …">isteğe bağlı simge/rozet kümesiyle, sabit<h1 class="wb-content-title">, alt başlık ve meta veri satırı. |
| Örnek görünüm | İsteğe bağlı ürün rozeti/simgesi, kısa tanıtım metni ve iki meta veri etiketi içeren sayfa başlığı. |
| Kaçının | H1'in anlamsal olarak yanlış olduğu iç içe bölümler. |
hero — Kahraman
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | Kaş olarak translations.title, translations.subtitle, translations.content. Eylem düğmeleri, kendi yönetici formlarına sahip ayrı alt button_link bloklarıdır. |
| Ayarlar ve çeşitleri | variant: default, muted, soft, accent; layout: left, centered, split, or full-bleed; title_tag: h1, h2, h3; isteğe bağlı arka plan görüntüsü ve kaplama ayarları. |
| Çocuklar/medya | Eylemler, sabit bir sayıya sahip olmayan alt button_link bloklardır. Sol/ortalanmış/tam çerçeve düzenlerinde media_id arka plan ortamıdır; bölünmüş durumda kopyanın yanında bir ön plan görüntüsü olarak görüntülenir. |
| HTML | Eski düzenler <section class="wb-card wb-promo [wb-card-*]">'ye aittir; bölme .wb-promo--split ve .wb-promo-media'yi ekler. Tam taşma, kart sınıfını kasıtlı olarak düşürür ve hizalanmış bir .wb-public-hero__copy ile .wb-public-hero--full-bleed'yi kullanır. |
| Örnek görünüm | Kapsamlı bir tanıtım, ön plan görüntüsü/kopya bölümü veya çerçevesiz görüntü alanı çapında fotoğrafik kahraman ve eylemler. |
| Sert sınırlama | İkinci ön plan resmi, ürün fiyatı/güven şeridi bölgesi veya rastgele iç içe geçmiş içerik yok. |
| Eylemler | button_link alt öğelerini ekleyin; .wb-promo-actions'nin içinde oluştururlar. primary_cta / secondary_cta {label, url} nesneleri, bu çocukların ilk ikisini yazan bir kısayol olarak kabul edilmeye devam ediyor. Promosyon kökünün dışında işleyen Button Link'li kardeş Kümeye ulaşmayın. allowed_child_handles ayrıca yayınlanmış katalog satırı olmayan ve unreachable_child_handles'de kalan eski button'yi de listeler. |
cta – CTA
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | Kaş olarak translations.title, translations.subtitle, translations.content. Eylem düğmeleri, kendi yönetici formlarına sahip ayrı alt button_link bloklarıdır. |
| Ayarlar ve çeşitleri | variant: default, muted, soft, accent; isteğe bağlı arka plan görüntüsü ve kaplama ayarları. CTA başlığı H2 olarak görüntüleniyor. |
| Çocuklar/medya | Eylemler, sabit bir sayıya sahip olmayan alt button_link bloklardır; doğrudan görüntü media_id arka plan ortamıdır. |
| HTML | .wb-promo-copy ve isteğe bağlı eylem satırı ile kök sahibi <section class="wb-card wb-promo [wb-card-*]">. |
| Örnek görünüm | Sayfanın sonuna yakın kısa dönüşüm bandı. |
| Eylemler | Hero ile aynı: button_link alt öğelerini ekleyin veya primary_cta / secondary_cta kısaltmasını kullanın. |
| Sınırlama | settings.layout=centered, oluşturucu uyumludur ancak normal CTA yönetici formu tarafından gösterilmez ve önerilen bir AI yazma alanı değildir. |
columns — Sütunlar
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | translations.title, translations.subtitle, translations.content; alt öğe başlığı, rozet, içerik, URL, simge ve ses tonları. |
| Ayarlar ve çeşitleri | settings.variant: cards, plain, stats. New Internal Content API plans default an omitted variant to plain; cards kasıtlı olmalıdır. Boş bir değişkene sahip mevcut depolanan bloklar, eski cards oluşturucu geri dönüşünü korur. |
| Çocuklar/medya | Yalnızca column_item. Çocuk sayımı yığın, 2 sütunlu, 3 sütunlu veya 4 sütunlu düzeni seçer. |
| HTML | İsteğe bağlı giriş ve duyarlı öğe tablosuyla kök sahibi <section class="wb-stack wb-gap-4">. |
| Örnek görünüm | Üç avantaj kartı, dört kompakt özellik veya basit bir metrik satır. |
| Yönetilebilirlik uyarısı | İstatistik oluşturucu, değer olarak alt subtitle'yi kullanabilir, ancak normal Sütun Öğesi yönetici formları bu subtitle'yi göstermez. Yapay zeka tarafından oluşturulan ve ona bağlı olan istatistikler tam olarak yönetilemez ve form sözleşmesi uyumlu hale getirilene kadar bundan kaçınılmalıdır. |
column_item — Sütun Öğesi
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | translations.title, translations.content, isteğe bağlı translations.eyebrow rozeti; paylaşılan settings.url, icon_slug, icon_tone, icon_size, badge_tone. |
| Ayarlar ve çeşitleri | Sunum, ana Sütunlar değişkeni tarafından kontrol edilir: kartlar, düz veya istatistikler. |
| Çocuklar/medya | Hiçbiri; yalnızca Sütunlar altında tasarlanmıştır. |
| HTML | Kartlar: .wb-card > .wb-card-body; plain: .wb-icon-card; stats: .wb-stat. Optional safe link wraps cards/plain output. |
| Örnek görünüm | İsteğe bağlı rozetli simge ve kopyalama özelliği kartı. |
| Kaçının | Bağımsız kullanım veya bir istatistik değeri için yalnızca oluşturucuya özel altyazıya güvenme. |
Nitelikler, ilkeler, faydalar, süreç özetleri ve bağımsız nesneleri temsil etmeyen diğer kopyalar için plain'yi kullanın. cards'yi yalnızca her öğenin kendine ait anlamlı bir sınırı olduğunda kullanın. Öğelerin sayısı, özellikle de tanıdık üçlü set, hiçbir zaman tek başına kartları seçmek için bir neden değildir.
feature-grid — Özellik Tablosu
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | translations.title, subtitle, content; alt özellik alanları. |
| Ayarlar ve çeşitleri | Bağımsız sunum çeşidi yok. Oluşturucu, Sütun kartları sunumunu zorlar ve üç sütunu tercih eder. |
| Çocuklar/medya | feature-item ve column_item uyumluluğu. |
| HTML | Sütunlara yetki verir ve bir kart ızgarası oluşturur. Block::ownsPublicRoot tarafından kök sahibi olarak listelenmediğinden, üst düzey çıktı, temsilci Bölüm kökü çevresinde genel bir sarmalayıcı alabilir. |
| Örnek görünüm | Eski üçlü özellikli kartlar. |
| Tavsiye | Yeni sayfalar için Sütunlar/Sütun Öğesi veya Izgara/Kart'ı tercih edin; Özellik Izgarasını yalnızca özel düzenleyicisi değerli olduğunda ve devredilen sözleşme kabul edildiğinde kullanın. |
feature-item — Özellik Öğesi
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | translations.title, translations.content, isteğe bağlı rozet etiketi; paylaşılan URL, simge bilgisi/tonu, rozet tonu. |
| Ayarlar ve çeşitleri | Her zaman Sütun Öğesi kartları sunumuna yetki verir. |
| Çocuklar/medya | Hiçbiri; Özellik Izgarası altında amaçlanan. |
| HTML | .wb-card > .wb-card-body > .wb-icon-card with optional icon and badge. |
| Örnek görünüm | Bir simge odaklı özellik kartı. |
| Tavsiye | Yeni genel amaçlı kompozisyonlar için kanonik Kart bölgelerini veya Sütun Öğesini tercih edin. |
stat-card — İstatistik Kartı
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | translations.subtitle etiketi, translations.title değeri, translations.content ayrıntısı; paylaşılan URL'yi seçin. |
| Ayarlar ve çeşitleri | Hiçbiri. |
| Çocuklar/medya | Hiçbiri. |
| HTML | Genel sarmalayıcı artı .wb-stat, .wb-stat-label, .wb-stat-value, .wb-stat-meta ve isteğe bağlı Daha fazla bilgi edinin bağlantısı. |
| Örnek görünüm | “Gönder” etiketi ve destekleyici detayı ile “24 saat” değeri. |
| Kaçının | Keyfi olarak iç içe geçmiş içeriğe ihtiyaç duyulan dekoratif pazarlama kartı. |
image — Resim
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | Yerel ayara ait resim alt_text ve başlık; paylaşılan isteğe bağlı URL. |
| Ayarlar ve çeşitleri | viewer_enabled, bağlantısız bir görseli CMS Galeri Görüntüleyiciye dahil eder; viewer_group, bağımsız olarak yerleştirilmiş Görüntü bloklarını tek bir göz atılabilir görüntüleyici setinde birleştirir. Odak noktası ve oluşturulan değişkenler Medya kaydına aittir. |
| Çocuklar/medya | Doğrudan görüntü media_id; çocuk yok. |
| HTML | Kök sahibi<figure class="wb-stack wb-gap-2">duyarlı<img>çıktı, isteğe bağlı bağlantılı veya wb-gallery-trigger görüntüsü ve<figcaption>. Etkinleştirilen gruplar, standart yer paylaşımı kökü altında mevcut bir galeri görüntüleme modelini kaydeder. |
| Örnek görünüm | Düzenlenebilir başlık içeren ürün veya editoryal görsel. |
| Kaçının | Arka plan uygulaması veya dekoratif düzen HTML. Koleksiyonun kendisinin tek bir ızgara olarak işlenmesi gerektiğinde Galeri'yi kullanın; Bağımsız olarak oluşturulan görsellerin düzeni değiştirmeden tek bir izleyiciyi paylaşması gerektiğinde izleyici gruplarını kullanın. |
gallery — Galeri
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | Yerele ait alt_text, caption, overlay_title, overlay_text ile sipariş edilen Galeri öğeleri; isteğe bağlı paylaşılan görüntüleyici başlığı. Galeri giriş metni kasıtlı olarak ayrıdır. |
| Ayarlar ve çeşitleri | variant: grid, masonry, collage; columns: 2–5; gap: none, sm, md, lg; aspect_ratio: auto, square, 4:3, 16:9, portrait; captions_mode: hidden, below, overlay, on-hover; overlay_mode: none, gradient, solid; lightbox_enabled: boolean. |
| Çocuklar/medya | gallery_items veya gallery_media_ids referans görüntüsü Medya kayıtları; çocukları engellemek yok. |
| HTML | Galeri öğeleri, duyarlı medya, altyazılar ve standart yer paylaşımı kökü altında isteğe bağlı kayıt defterine ait görüntüleyiciyle kök sahibi .wb-gallery.wb-gallery--{variant}. |
| Örnek görünüm | Eşit ürün ızgarası, doğal yükseklikte editoryal duvar işçiliği veya öne çıkan kolaj. |
| Kaçının | Galeriye başlık/açıklama ekleme; ondan önce İçerik Başlığı veya Zengin Metin oluşturun. |
download — İndir
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | translations.title düğme etiketi ve translations.subtitle yardımcı kopyası. |
| Ayarlar ve çeşitleri | settings.variant: primary, secondary, ghost. |
| Çocuklar/medya | Doğrudan belge/diğer media_id; çocuk yok. |
| HTML | <a class="wb-btn …" download> ve isteğe bağlı yardımcı paragraf ile kök sahibi .wb-stack.wb-gap-2. |
| Örnek görünüm | Dosya açıklamasını içeren “Kılavuzu indir” düğmesi. |
| Kaçının | Yalnızca harici dosya kartları; Dosya'yı kullanın. |
file — Dosya
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | translations.title, translations.content; paylaşılan URL geri dönüşü. |
| Ayarlar ve çeşitleri | Hiçbiri. |
| Çocuklar/medya | Doğrudan belge/diğer media_id; medya güvenli harici URL üzerinden kazanır. |
| HTML | Başlığı, açıklamayı, indirme/açma düğmesini ve dosya meta verilerini içeren kök sahibi sessiz Kart. |
| Örnek görünüm | İndirilebilir PDF kaynak kartı. |
| Kaçının | Yalnızca düğmeyle yapılan basit indirmeler. |
videosu — Video
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | translations.title, translations.content; paylaşılan güvenli URL geri dönüşü. |
| Ayarlar ve çeşitleri | Kaynak, yerel videoyu, YouTube/Vimeo iframe'ini veya açık video düğmesini belirler. |
| Çocuklar/medya | Doğrudan video media_id; çocuk yok. |
| HTML | <video>, izin verilenler listesindeki bir sağlayıcı <iframe> veya güvenli bir bağlantı içeren kök sahibi sessiz Kart. |
| Örnek görünüm | Düzenlenebilir başlık ve açıklama içeren demo video yüklendi. |
| Kaçının | Keyfi iframe HTML. |
audio — Ses
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | translations.title, translations.content; paylaşılan güvenli HTTP URL'si geri dönüşü. |
| Ayarlar ve çeşitleri | Hiçbiri. |
| Çocuklar/medya | Yönetici ve oluşturucu seçilen ses ortamını destekler; çocuk yok. |
| HTML | Kopya ve yerel <audio controls> ile kök sahibi sessiz Kart. |
| Örnek görünüm | Ses dersi veya örnek oynatıcı. |
| API açığı | Denetlenen içerik planı doğrudan medya izin verilenler listesinde audio atlanıyor, dolayısıyla media_id ataması, yönetici ve oluşturucu bunu desteklese bile reddediliyor. İncelenen güvenli URL'yi yalnızca uygun olduğunda kullanın veya AI medya atamasından önce API sözleşmesini düzeltin. |
code — Kod
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | translations.title, translations.subtitle dosya adı/dil etiketi, translations.content kod gövdesi. |
| Ayarlar ve çeşitleri | settings.language, sterilize edilmiş data-language haline gelir. |
| Çocuklar/medya | Hiçbiri. |
| HTML | Genel ambalaj artı <pre><code data-language="…">…</code></pre>. |
| Örnek görünüm | Kopyalanabilir görünümlü komut veya kaynak pasajı. |
| Kaçının | Düzyazı, düzen veya çalıştırılabilir komut dosyaları. |
button_link — Düğme Bağlantısı
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | Düğme etiketi olarak translations.title; settings.url paylaştı. Genel oluşturma zamanında, oluşturma yerel ayarını bir dahili yol takip eder (çözümlendiğinde hedef sayfanın çevrilmiş yoluna yeniden yazılır); saklanan değer paylaşılan ve ham kalır. |
| Ayarlar ve çeşitleri | settings.target: _self or _blank; paylaşılan variant: birincil/varsayılan veya ikincil. URL, güvenli bir tam HTTP(S) URL'sini, site yolunu, bağlantıyı, mailto: veya tel: hedefini kabul eder. |
| Çocuklar/medya | Hiçbiri. Bu, bağımsız bir editoryal eylemdir ve Hero ve CTA tarafından kullanılan, katalog dışı yönetilen button alt öğesinden farklıdır. |
| HTML | Genel sarmalayıcı artı <a class="wb-btn wb-btn-primary"> veya ikincil sınıf eşdeğeri; _blank, rel="noopener noreferrer"'yi ekler. Boş veya güvenli olmayan URL hiçbir bağlantı yaymaz. |
| Örnek görünüm | Yönetilen bir birincil veya ikincil eylem ya da bir Küme tarafından düzenlenen birden fazla eylem. |
| Kaçının | HTML'deki sabit kodlu sabitleyiciler veya eylemin bu tanıtım kökü içinde işlenmesi gerektiğinde Hero/CTA'nın dahili yönetilen eylem alt öğesi için onun yerine kullanılması. |
table — Tablo
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | translations.title; translations.content yeni satırla ayrılmış, dikey çizgiyle ayrılmış satırlar olarak. |
| Ayarlar ve çeşitleri | settings.variant: header-row/default or plain. Legacy settings.rows remains readable but is not recommended for new API content. |
| Çocuklar/medya | Hiçbiri. |
| HTML | .wb-table-wrap > table.wb-table, isteğe bağlı <thead> ve <tbody>'yi içeren genel sarmalayıcı. |
| Örnek görünüm | Küçük karşılaştırma veya spesifikasyon tablosu. |
| Kaçının | Sayfa düzeni ızgaraları veya etkileşimli veri kümeleri. |
quote — Alıntı
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | translations.content alıntısı, translations.title ve translations.subtitle atıf parçaları. |
| Ayarlar ve çeşitleri | settings.variant: default or testimonial. |
| Çocuklar/medya | Hiçbiri. |
| HTML | <blockquote class="wb-stack wb-gap-2"> içeren genel paketleyici; referans, sessiz bir Kart kabuğu ekler. |
| Örnek görünüm | Editoryal alıntı veya müşteri referansı. |
| Kaçının | Genel amaçlı belirtme çizgileri. |
Gezinme Blokları
link-list — Bağlantı Listesi
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | translations.title, translations.subtitle, translations.content; alt bağlantı kopyası. |
| Ayarlar ve çeşitleri | settings.row_layout: index (default), stacked puts each row description under its title. settings.list_frame: joined (default), cards gives each row its own card. Independent; her ikisi de API aracılığıyla yazılabilir. |
| Çocuklar/medya | Yalnızca link-list-item. |
| HTML | İsteğe bağlı giriş yığını ve .wb-link-list'nin yanı sıra seçilen stiller için wb-link-list--stacked / wb-link-list--cards içeren genel sarmalayıcı. |
| Örnek görünüm | Başlık, meta veriler, açıklama, simgeler ve rozetleri içeren kaynak dizini. |
link-list-item — Bağlantı Listesi Öğesi
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | Gerekli translations.title, isteğe bağlı subtitle, content ve eyebrow rozeti; gerekli URL'yi paylaştı. |
| Ayarlar ve çeşitleri | icon_slug, icon_tone, icon_size, badge_tone. |
| Çocuklar/medya | İsteğe bağlı görüntü media_id küçük resmi; Bağlantı Listesi altında tasarlanmıştır. |
| HTML | <a class="wb-link-list-item"> with an optional leading thumbnail or icon (adding wb-link-list-item--media), title/meta/badge, and optional description. |
| Örnek görünüm | Dokümantasyon/kaynak satırı "Yeni" olarak işaretlendi. |
| Koruma koruması | Yalnızca güvenli bir URL ve başlıkla yayınlanır. |
page-list — Sayfa Listesi
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | Sayfa kopyası yok. Başlıklar, açıklamalar ve küçük resimler listelenen her sayfanın çevirisinden gelir: name, ardından list_excerpt, ardından seo_description'ye, ardından og_image_media_id. |
| Ayarlar ve çeşitleri | scope (page_type, path_prefix, subtree_of_current), page_type, path_prefix, sort, limit (1-48), layout (cards/links), columns, show_thumbnail, show_description, exclude_current, clickable_card. |
| Çocuklar/medya | Hiç biri. Satırlar bir sayfa sorgusundan gelir; küçük resimler her sayfa çevirisinin Açık Grafiği görüntüsünden çözümlenir. |
| HTML | wb-card makalelerinin wb-grid'si (veya clickable_card etkinleştirildiğinde tek bağlantılı Kart kökleri) veya wb-link-list-item bağlantılarının wb-link-list'si. |
| Örnek görünüm | Her biri başlığından bağlantı veren üç sütunlu rehber kartları dizini. |
| Koruma koruması | Sorgu hiçbir sayfa döndürmediğinde veya kapsam yapılandırılmadığında hiçbir şey yayınlamaz. Yayınlanma durumu, site, yerel oluşturma çevirisi, Shared Slot kaynak sayfaları ve barındırma sayfası sorguda filtrelenir ve ayar değildir. |
application — Uygulama Bloğu
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | Editör kopyası yok. Kararlı application_handle ile veritabanına kayıtlı Gömülü Uygulamayı seçer. |
| Ayarlar ve çeşitleri | application_settings, seçilen tanım şemasına göre doğrulanır. CMS'ye ait sunum ayarları width, loading, aspect_ratio, min_height, show_loading_state ve show_failure_state'dir. |
| Çocuklar/medya | Hiç biri. Yürütülebilir varlıklar kayıtlı uygulama tanımına aittir ve blok içerik veya Medya aracılığıyla sağlanamaz. |
| HTML | Satır içi uygulamalar, oluşturulan bir .wb-application__mount'yi alır; iframe uygulamaları CMS'ye ait, korumalı alana alınmış bir iframe alır. Hazır tanımlarla bildirilen CSS ve JavaScript, sayfa başına bir kez yüklenir. |
| API yazma | İçerik doğrulama/uygulama ve doğrudan engelleme ayarları yaması aracılığıyla yazılabilir. GET /webadmin/api/applications ile tutamaçları ve /applications/{application}/schema ile şemaları keşfedin; bu okumalar applications.read gerektirir. Kayıt defteri mutasyonu açığa çıkmaz. |
| Koruma koruması | Eksik, geçersiz veya yinelenen tanımlar varlıkları yüklemez veya yürütmez. Bloğun çevrilmiş genel hata durumu etkinleştirilmedikçe hiçbir şey oluşturmazlar. |
navigation-auto — Otomatik Navigasyon
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | Sayfa kopyası yok; Seçilen CMS Gezinme menüsü. |
| Ayarlar ve çeşitleri | Bilinen menü konumlarından menu_key. Alt bilgi/yasal anahtarlar yığılmış bağlantılar oluşturur; birincil/varsayılan, kümelenmiş düğme stili bağlantıları oluşturur. |
| Çocuklar/medya | Navigasyon kayıtları çocukları engellemez. |
| HTML | Genel sarmalayıcı artı anlamsal <nav> ve <ul> ağacı. |
| Örnek görünüm | Bir yuvadaki uyumluluk gezinme menüsü. |
| Tavsiye | Yeni paylaşılan başlıklar için Gezinme Çubuğu'nda gezinmeyi tercih edin. |
| Sözleşme sicil boşluğu | Bu yayınlanan tanıtıcıda bir yönetici formu ve oluşturucu var ancak denetim temelinde BlockTypeContractRegistry'de giriş yok. Keşif bunu onaylayana kadar tam bir canlı API sözleşmesi çıkarmayın. |
toc — TOK
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | İsteğe bağlı paylaşılan başlık. |
| Ayarlar ve çeşitleri | Hiçbiri. |
| Çocuklar/medya | Geçerli bağlantılarla ve H2/H3 değişkenleriyle aynı yuvadaki yayınlanmış Başlık bloklarını belge sırasına göre okur. |
| HTML | Oluşturulmuş bir nav.wb-section-nav bağlantı listesine sahip genel sarmalayıcı — wb-link-list değil, bağımsız bir WebBlocks UI ilkeldir. |
| Canlı davranış | Kaydırma konumu vurgulaması, genel düzenin zaten yüklediği aynı webblocks-ui.js'de, gönderilen WBSectionNav modülünden ücretsiz olarak gelir; oluşturucunun kendisine ait bir JavaScript'si yoktur. |
| Örnek görünüm | Uzun bir dokümantasyon sayfası için “İçindekiler” listesi. |
| Koruma koruması | Uygun başlık olmadığında hiçbir şey yayınlamaz. |
breadcrumb — İçerik haritası
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | Paylaşılan home_label; Geçerli sayfa başlığı sayfadan geliyor. |
| Ayarlar ve çeşitleri | include_current: boolean. |
| Çocuklar/medya | Sayfa/site/yerel ayar bağlamını kullanır. |
| HTML | Genel ambalaj artı <nav class="wb-breadcrumb"><ol class="wb-breadcrumb-list">…</ol></nav>. |
| Örnek görünüm | Ana Sayfa / Kategori / Geçerli sayfa. |
header-actions — Başlık Eylemleri
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | Kopya yok. |
| Ayarlar ve çeşitleri | Boolean'lar show_search, show_mode_toggle, show_accent_toggle, show_language_switcher. Genel ön ayar/vurgu kontrolleri şu anda site düzeyindeki Genel Tema modeli tarafından bastırılmaktadır. |
| Çocuklar/medya | Hiçbiri. |
| HTML | Genel sarmalayıcı artı kompakt .wb-topbar-actions simge kontrolleri. |
| Örnek görünüm | Gezinme çubuğunun sağ tarafında arama ve açık/koyu/otomatik mod eylemleri. |
| Kaçının | İş CTA'ları. |
sticky-navbar — Gezinme Çubuğu
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | Doğrudan kopya yok; isteğe bağlı yalnızca düzenleyici layout_name. |
| Ayarlar ve çeşitleri | sticky_mode: sticky/default, static, fixed. |
| Çocuklar/medya | İzin verilen alt öğeler: kapsayıcı, küme, başlık, plain_text, zengin metin, button_link, navbar-marka, navbar-navigasyon, başlık eylemleri, arama formu. API planlarının gerektirdiği en az bir alt öğe. |
| HTML | Kök sahibi <nav class="wb-navbar …" data-wb-public-block-type="sticky-navbar">…</nav>. |
| Örnek görünüm | Paylaşılan başlık: Gezinti Çubuğu → Kapsayıcı → Küme (arasında) → Marka + gezinme/eylemler. |
| Kaçının | İkinci bir özel başlık kabuğu. |
navbar-brand — Navbar Markası
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | translations.title, translations.subtitle; paylaşılan URL, hedef, aria etiketi. |
| Ayarlar ve çeşitleri | url; target: _self or _blank; aria_label. |
| Çocuklar/medya | Logo için isteğe bağlı resim media_id. |
| HTML | İsteğe bağlı görüntü ve kimlik kopyasıyla genel ambalaj artı <a class="wb-navbar-brand">. |
| Örnek görünüm | Logo, site adı ve kısa slogan. |
navbar-navigation — Gezinme Çubuğu Navigasyonu
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | ARIA etiketi olarak paylaşılan başlık; Seçilen Navigasyon menüsü. |
| Ayarlar ve çeşitleri | menu_key; active_indicator: underline, pill, dot, background, none; active_matching: path, section, current-page, exact, off. |
| Çocuklar/medya | CMS Navigasyon Öğesi ağacı. |
| HTML | Genel sarmalayıcı artı masaüstü .wb-navbar-links, mobil WebBlocks UI açılır menüsü, aktif sınıflar ve grup açılır menüleri. |
| Örnek görünüm | Otomatik hamburger menüsüyle duyarlı birincil navigasyon. |
sidebar-brand — Kenar Çubuğu Markası
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | translations.title, translations.subtitle; paylaşılan URL, hedef, aria etiketi. |
| Ayarlar ve çeşitleri | Navbar Markasıyla aynı güvenli bağlantı sözleşmesi. |
| Çocuklar/medya | Logo için isteğe bağlı resim media_id. |
| HTML | Genel paket artı logo ve kimlik kopyasıyla <a class="wb-sidebar-brand">. |
| Örnek görünüm | Kenar çubuğunun üst kısmındaki belge logosu/başlığı. |
sidebar-navigation — Kenar Çubuğu Gezinmesi
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | ARIA etiketi olarak translations.title; isteğe bağlı yalnızca düzenleyici layout_name. |
| Ayarlar ve çeşitleri | İsteğe bağlı menu_key; show_icons: boolean; active_matching: path, current-page, exact. |
| Çocuklar/medya | CMS Navigasyon kayıtları veya manuel sidebar-nav-item / sidebar-nav-group; manuel API planlarında en az bir alt öğe gereklidir. |
| HTML | Genel sarmalayıcı artı <nav class="wb-sidebar-nav"> ve WebBlocks UI kenar çubuğu yapıları. |
| Örnek görünüm | Etkin bölüm göstergeli belge kenar çubuğu. |
sidebar-nav-item — Kenar Çubuğu Gezinme Öğesi
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | Gerekli translations.title; paylaşılan URL ve hedef. |
| Ayarlar ve çeşitleri | Katalogdan icon; active_mode: exact, path, current-page, manual; manual_active: boolean. |
| Çocuklar/medya | Hiçbiri; Kenar Çubuğu Gezinmesi veya Kenar Çubuğu Gezinme Grubu altında tasarlanmıştır. |
| HTML | <a class="wb-sidebar-link"> or nested .wb-nav-group-item, with optional icon and active state. |
| Örnek görünüm | Manuel dokümantasyon bağlantısı. |
sidebar-nav-group — Kenar Çubuğu Gezinme Grubu
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | Gerekli translations.title; isteğe bağlı yalnızca düzenleyici layout_name. |
| Ayarlar ve çeşitleri | icon; initially_open: boolean. |
| Çocuklar/medya | Yalnızca sidebar-nav-item. |
| HTML | .wb-nav-group with button toggle, arrow, icon, and .wb-nav-group-items. |
| Örnek görünüm | Dokümanların kenar çubuğundaki daraltılabilir "Kılavuzlar" grubu. |
search-form — Arama Formu
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | translations.title etiketi, translations.content yer tutucu, translations.subtitle gönderme etiketi. |
| Ayarlar ve çeşitleri | settings.variant: primary or secondary; show_button: boolean. |
| Çocuklar/medya | Hiçbiri; çözülebilir bir site arama rotası gerektirir. |
| HTML | Genel sarmalayıcı artı <form role="search" class="wb-cluster …">, yerel giriş ve isteğe bağlı WebBlocks düğmesi. |
| Örnek görünüm | Bir başlık veya sayfadaki site arama alanı. |
sidebar-footer — Kenar Çubuğu Alt Bilgisi
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | translations.title, translations.content, translations.subtitle altbilgi notu. |
| Ayarlar ve çeşitleri | settings.variant: info, success, warning, danger. |
| Çocuklar/medya | Hiçbiri. |
| HTML | Genel sarmalayıcı artı .wb-sidebar-footer, tonlu .wb-callout ve isteğe bağlı sessiz not. |
| Örnek görünüm | Küçük belge bildirimi veya sürüm notu. |
Desen, Form ve Etkileşim Blokları
alert — Uyarı
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | translations.title, gerekli translations.content. |
| Ayarlar ve çeşitleri | settings.variant: info, success, warning, danger. |
| Çocuklar/medya | Hiçbiri. |
| HTML | Genel ambalaj artı <div class="wb-alert wb-alert-{tone}"> ve isteğe bağlı başlık. |
| Örnek görünüm | Satır içi uyarı, başarı notu veya bilgi mesajı. |
| Kaçının | Pazarlama promosyonları. |
contact_form — İletişim Formu
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | Yerel ayara ait title, content, submit_label, success_message, consent_label. |
| Ayarlar ve çeşitleri | recipient_email; send_email_notification; store_submissions, yerel sözleşmede ürüne ait olmaya devam ediyor; consent_required (boolean, varsayılan false). |
| Onayı | consent_required'yi ayarlayın ve gerekli izin onay kutusunu oluşturmak için yerel ayara bir consent_label verin. İfade, tebliğ olduğu için tercüme edilmiştir. Kabul edilen bir gönderim, consent_accepted_at ve ifadelerin bir kopyasını saklar; dolayısıyla bloğun daha sonra düzenlenmesi, geçmişteki bir ziyaretçinin kabul etmiş olarak kaydettiği şeyi değiştiremez. Çözümlenen yerel ayar için herhangi bir ifade içermeyen gerekli bir onay, etiketlenmemiş bir onay kutusu yerine hiçbir onay kutusu oluşturmaz. consent_required, PATCH'e kapalı: canlı bir formdan yasal bildirimin kaldırılması operatörün kararıdır. |
| Site bildirim politikası | İletişim formları ve katılımcı eklentiler Site.notification_settings'yi paylaşır, GET /webadmin/api/sites/{site}/notifications (content.read) aracılığıyla okunur ve PATCH (site-settings.write, site kapsamlı) aracılığıyla değiştirilir. Alanlar: notification_mode (full, alert_only), notification_frequency (immediate, batched, daily), batch_minutes (1–60), daily_summary (boolean), summary_hour (site saat diliminde 0–23). Çıkarılan PATCH alanları korunur; geçersiz, boş ve bilinmeyen değerler reddedilir. Bunlar site ayarlarıdır, PATCH alanlarını asla engellemeyin. |
| Bildirim gizliliği | alert_only yalnızca güvenilir site kopyasına, sayımlara ve normal kimlik doğrulamalı CMS gelen kutusu bağlantılarına sahiptir. Ziyaretçi adı/adresi, konu/gövde, IP, tarayıcı bilgisi, kaynak URL/yönlendiren, ziyaretçi Yanıtı, özel başlıklar veya ekler yok. Ayrı minimal postalanabilirler hiçbir zaman ziyaretçi modellerini almaz. full, ayrıntılı gruplar da dahil olmak üzere ayrıntılı bildirimleri saklar. Günlük özetler, seçilen içerik modunun full olduğu durumlar da dahil olmak üzere her zaman sayıları ve korumalı bağlantıları içerir. Eklentiler sitenin gizlilik modunu geçersiz kılamaz. |
| Bildirim zamanlaması | Yeni siteler varsayılan olarak alert_only, batched olarak ayarlanmıştır, on dakika, daily özeti 09:00'da etkinleştirilmiştir. Yükseltme geçişleri, özetler devre dışı bırakılarak mevcut tam/anında davranışı korur. Toplu iletişim postası ilk uyarıyı hemen gönderir ve ardından site/kanal/alıcı başına sonraki mesajları birleştirir. Canlı Sohbet toplu olarak görüşme başına dağıtılır, böylece her görüşme ilk çevrimdışı uyarısını anında alır. daily site/alıcı/gün başına birleştirilmiş özet gönderir; daily_summary etkinleştirildiğinde, mevcut beklemedeki çalışma daily hatırlatılır. Okunan kişi mesajları yanıtlanana/arşivlenene kadar yanıt bekliyor; spam/karantinaya alınmış/arşivlenmiş ve devre dışı bırakılan iletiler hariçtir. |
| Teslimat ve eklenti uzantısı | webblocks:notifications:dispatch, Laravel zamanlayıcıya her dakika kaydedilir; ana bilgisayarlar bunu çalıştırmalı ve birden fazla çalışanı çalıştırırken atomik kilitleri destekleyen paylaşılan bir önbellek kullanmalıdır. Kayıt, benzersiz kaynak anahtarlarıyla yalnızca site/kanal/kaynak tanımlayıcılarını ve durumu saklar; Teslimattan önce poliçe tekrar okunur. Hatalar geneldir ve hiçbir zaman otomatik olarak yeniden denenmez. Kesintiye uğrayan girişimler 15 dakika sonra başarısız olur. Terminal olayları ve boşta gönderim durumu 30 gün sonra budanır. GET, site kapsamlı mesaj sonuçlarını ve en son günlük özet sonuçlarını ortaya çıkarır; Site ayarları paneli ve mevcut gelen kutuları teslimat durumunu gösterir. Etkinleştirilen eklentiler, eklenti tanıtıcısı ile SiteNotificationChannel adaptörünü SiteNotificationChannels aracılığıyla kaydeder; site kapsamlı kaynaklara, alıcılara, uygunluk durumuna, ayrıntılı postalara ve bekleyen sayımlara sahiptir; devre dışı bırakılan eklentiler gönderilmez. |
| Panel bildirimleri | CMS 1.96.0’dan itibaren ortak yönetim başlığı, WebBlocks UI wb-btn wb-btn-ghost wb-btn-icon eylemi ve wb-btn-badge sayacıyla Dashboard bildirim paneline bağlanır. Görsel sayı 99+ ile sınırlıdır; erişilebilir etiket tam sayıyı korur. Site operasyon yöneticileri erişebildikleri sitelerin toplam okunmamış (new) ve yanıt bekleyen (new + read) ileti sayılarını görür. Erişilebilir bir site zamanlanmış e-posta gerektiriyorsa ve kayıtlı durum doğrulanmamış, gecikmiş, başarısız veya kullanılamaz ise zamanlama uyarısı gösterilir. CMS 1.97.0’dan itibaren başlık rozeti yalnızca okunmamış iletileri sayar; okunmuş fakat yanıt bekleyen iletiler ve zamanlayıcı/şema uyarıları ayrı Dashboard durumudur ve rozete eklenmez. Okunmamış ileti yoksa zil görünür kalır, sayı gösterilmez. Site satırının Actions hücresi, yanıt bekleyen iletileri açtığını açıklayan çevrilmiş araç ipucu ve erişilebilir etiketle standart WebBlocks UI görüntüleme simgesini kullanır. Kayıtlı iş, e-posta tercihi, alıcı ayarı, teslim sonucu ve zamanlayıcı kanıtından bağımsız görünür. Özete ziyaretçi adları, adresleri, konuları, içerikleri veya IP’leri girmez. Okumalar e-posta göndermez, olayları tüketmez, iletileri okundu yapmaz ve zamanlayıcı sağlığı oluşturmaz. Sayılar her panel sayfası yüklenişinde yenilenir; bu ortak gelen kutusunun güncel durumudur, kullanıcıya özel bildirim geçmişi veya otomatik sorgulama değildir. Site bağlantıları GET /webadmin/contact-messages?site={id} kullanır; kapsamlı site seçicisi doğrulanır ve güvenli gelen kutusu dönüş URL’lerinde korunur. Yanıtlanmış, arşivlenmiş, spam ve karantinaya alınmış iletiler dışlanır; gelen kutusu şeması yoksa boş kutu yerine geçiş uyarısı gösterilir. Live Chat, zamanlanmış e-posta olmadan da çalışan ayrı izin ve site kapsamlı eklenti paneli göstergesini korur. |
| Zamanlayıcı durumu ve önkoşullar | CMS 1.95.1, her dakikada gerçekten çalışan zamanlanmış geri çağrıyı CMS veritabanındaki bildirim komutu başlangıç/tamamlanma/hata kayıtlarından ayrı kaydeder. Site politikasından türetilen required, toplu/günlük teslim veya günlük özet için true olur. CMS 1.95.2’den itibaren Dashboard, eski yalnızca anlık teslim siteleri dahil operasyon yöneticilerinin erişebildiği tüm sitelere bağlantılar içeren tek bir sağlık bildirimi gösterir. Uyarı düzeyi erişilebilir herhangi bir sitenin zamanlanmış bildirim gerektirip gerektirmediğine bağlıdır; erişilemeyen siteler bunu etkilemez. Günlük özetsiz, yalnızca anlık teslim politikaları, bu bildirimler için zamanlamanın isteğe bağlı olduğunu açıklayan bir bilgi kartını korur; Site ayarları ve kapsamlı bildirim GET API’si, genel/zamanlayıcı/çalışan durumu ve UTC zamanlarıyla scheduler_health gösterir. Eksik kanıt unverified kalır; 300 saniyeden eski kanıt delayed olur; işleme hataları ve kullanılamayan şema açıkça belirtilir; tamamlanmamış güncel çalıştırma running olabilir. Elle dağıtım ve sağlık okumaları zamanlayıcı yaşam sinyali oluşturmaz. Salt okunur webblocks:scheduler:status --json komutu yalnızca doğrulanmış sağlıklı durumda başarılı çıkar. Zamanlayıcının çalışması SMTP/gelen kutusu teslimini veya her düğümün sağlığını garanti etmez. Kurulum aracı ve konuk kurulum bildirimi çalışan e-postayı, kanonik APP_URL’yi, sunucunun sahip olduğu her dakikalık zamanlayıcıyı ve çoklu çalışanlar için ortak atomik kilit önbelleğini açıklar; CMS cron kurmaz. Etkin bildirim eklentileri ayarlarında ve sağlık kontrollerinde aynı SchedulerHealth servisini kullanabilir. |
| Çocuklar/medya | Yok. |
| HTML | Yerel section.wb-card etrafındaki genel sarmalayıcı, CSRF korumalı form, oluşturucu tarafından oluşturulan anti-spam alanı, WebBlocks girişleri, metin alanı, isteğe bağlı izin onay kutusu, doğrulama hataları ve gönder düğmesi. |
| Örnek görünüm | İsteğe bağlı bildirimle birlikte İletişim Mesajlarında saklanan, tümüyle yönetilen iletişim formu. |
| Kaçının | Ham form HTML, özel bal küpü alanları veya mailto: değişimi. |
rating — Derecelendirme
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | İsteğe bağlı, yerel ayara duyarlı başlık ve destekleyici metin (title, subtitle), metin çevirilerini kullanır. Eski settings.title görüntüleme için yedek değerdir; normal etiketler ürün tarafından çevrilir. |
| Ayarlar ve çeşitleri | scale: fixed 5; allow_change: boolean; show_summary: boolean; data_scope (CMS 1.97.0): block (varsayılan; ayrı geri bildirim alanlarını korur) veya page (aynı kayıtlı site/sayfa; blok değişiminden sonra korunur). Düzenleyici ve block PATCH, kapsamı destekler. |
| Çocuklar/medya | content_ratings'yi kullanır; çocuk yok. |
| HTML | İsteğe bağlı H3, kısmen doldurulmuş .wb-rating-stars, özet ve JS içermeyen .wb-rating-input gönderme düğmeleriyle kök sahibi <section class="wb-card">. |
| Örnek görünüm | Ortalama ve yanıt sayısıyla birlikte beş yıldızlı sayfa derecelendirmesi. |
| Notu | Herkese açık özete yalnızca etkin, 5 puanlık oylar girer. Sayfa kapsamı, blok değişiminde ziyaretçi oturumu karmasını sabit tutar, yazmaları sayfa kilidi altında sıralar ve mevcut oturumun korunmuş blok kapsamlı karmalarını tanır. Sahipsiz eski karmalar otomatik eşleştirilemez veya tekilleştirilemez; mevcut satırlar tanınan bir oy güncellenene kadar değişmez. Form, mevcut oturum oyunu aria-pressed ile işaretler ve allow_change false olduğunda tekrar girişi kapatır; sunucu da bunu uygular. GET ziyaretçi kimliği oluşturmaz. |
comments — Yorumlar
| Sözleşme alanı | Kaynak destekli davranış |
|---|---|
| Düzenlenebilir içerik | Blok yazarlı ziyaretçi kopyası yok; ürün çevirileri etiketler ve mesajlar sağlar. |
| Ayarlar ve çeşitleri | form_enabled, show_approved, show_author_name; sort_order: newest or oldest; data_scope (CMS 1.97.0): block (varsayılan) veya page. Sayfa kapsamı, ilk bloğu silinmiş olanlar dahil, aynı kayıtlı site/sayfadaki onaylı kayıtları içerir; komşu sayfalar ve siteler dışlanır. |
| Çocuklar/medya | Denetlenen comment_entries'yi kullanır; çocuk yok. |
| HTML | Kökünü yöneten <section class="wb-card wb-public-comments">; CMS 1.97.1’de ayrı etiketlenmiş Comments/liste ve Leave a comment/form bölgeleri, çevrilmiş ürün başlıkları ve onaylı sayı rozeti içerir. Yazar/tarih satırı dar alanda sarılır; kaçış uygulanmış çok satırlı metin sıkı aralık kullanır. Formda temaya uyumlu yumuşak bir yüzey, üç satırlı metin alanı ve telefonda genişleyen küçük bir ad alanı bulunur. Sayfa başına 25 kayıtlık sayfalama (comments_page_{block_id}, parça ve sorgu korunarak), yerel CSRF koruması, anti-spam alanları, hedefli doğrulama durumu ve gönderme eylemi korunur. Liste ve form görünürlüğü bağımsız kalır. |
| Örnek görünüm | Bir makalenin veya ürün kılavuzunun altında denetlenen yorumlar. |
| Kaçının | Özel yorum depolama veya ham form işaretlemesi. |
Yalnızca İnsanlara Yönelik Gelişmiş Blok
html — HTML (Güvenilir)
| Sözleşme alanı | Kaynak destekli davranış ve hedef politikası |
|---|---|
| Amaç | Henüz yapılandırılmış bir ürün sözleşmesi olmayan güvenilir işaretleme için insan kaçış kapısı incelendi. |
| Yönetici tarafından düzenlenebilir içerik | Güvenilir HTML içeriği. Mevcut çeviri kaydı bunu metin ailesi içeriği olarak ele alıyor. |
| Ayarlar ve çeşitleri | Hiçbiri. Tanınan kaplama/gövde ucu parçaları paket kayıtlarına çıkarılabilir. |
| Çocuklar/medya | Çocuk yok. |
| HTML | Genel sarmalayıcı artı güvenilir işaretlemeyi içeren düz bir iç <div>; çıkarılan parçalar görünür kökün dışında işlenebilir. |
| API yazma | Yasaktır. Oluşturma, güncelleme, değiştirme, topoloji mutasyonu, yıkıcı mutasyon, aşamalı mutasyon veya yayınlama mutasyonu yoktur. |
| Yapay zeka davranışı | Bir yetenek açığını bildirin ve yapılandırılmış bir blok/varyant/oluşturucu önerin. Hiçbir zaman yazılabilir bir HTML verisi oluşturmayın. |
Eski ve Yalnızca Oluşturucuya Yönelik Tutamaçlar
Blade kısmi durumunu, yeni API içeriği için bir tanıtıcının mevcut olduğunun kanıtı olarak değerlendirmeyin. Geçerli kaynak, uyumluluk oluşturucuları ve yayınlanmamış çekirdek yazma sözleşmeleri olmayan taslak satırları içeriyor.
Taslak katalog satırları şunları içerir:
text
card-grid
tabs
menu
faq-list
showcase-list
contact-info
Yalnızca oluşturucu, takma ad, kısmi veya uyumluluk tanıtıcıları aşağıdaki gibi örnekleri içerir:
accordion
faq
button
callout
list
map
metric-card
stats
testimonial
gallery-viewer
sidebar-nav-item-link
sidebar-navigation-menu-item
fallback
missing-renderer
Kurallar:
- Bunları hiçbir zaman yalnızca bir oluşturucu dosyası var diye yazmayın.
- Bunları yalnızca canlı kimlik doğrulamalı blok kataloğu tam tanıtıcıyı yayınlandığı ve geçerli kurulum için kullanılabilir olarak bildiriyorsa kullanın.
- Yukarıda belgelenen kanonik yapılı blokları tercih edin.
- Galeri görüntüleyici ve kenar çubuğu bağlantı oluşturucuları gibi dahili kısmi öğeler hiçbir zaman içerik planı blok türleri değildir.
Görsel Kompozisyon Tarifleri
Bunlar yönetilen blok ağaçlarıdır, sabit şablonlar değildir. Çalışma zamanında tüm tanıtıcıları onaylayın.
İçeriği karşılayan en az çerçeveli tarifle başlayın. Aynı tarifi bitişik sayfa bantlarında tekrarlamayın ve kaynakta üç kısa öğe var diye özellik kartı tarifini seçmeyin.
Ön plan medyasıyla editoryal tanıtım
section(spacing:lg)
└── container(width:xl)
└── hero(layout:split, foreground media)
├── button_link(primary)
└── button_link(secondary)
Geniş, anlamlı bir görüntü ve ölçülü yüzey stili kullanın. Görüntünün görünüm alanı çapında, çerçevesiz bir açılış bandı haline gelmesi gerektiğinde layout:full-bleed'yi seçin; görüntü anlamsal ön plan içeriği olduğunda split'yi koruyun.
Çerçevesiz ilkeler veya faydalar
section(spacing:lg)
└── container(width:xl)
└── columns(variant:plain)
├── column_item
├── column_item
└── column_item
Bu, deneyim, iletişim, özen, hız veya güvenilirlik gibi nitelikler için normal başlangıç noktasıdır. Yalnızca öğeler bağımsız olarak işlem yapılabilir veya sınırlı olduğunda Kartlara tanıtın.
Ayrı işlemler içeren Pazarlama sayfası girişi
section(background optional)
└── container(width:lg)
├── hero(variant:accent, layout:centered)
└── cluster(alignment:center, gap:sm)
├── button_link(primary)
└── button_link(secondary)
Bunu yalnızca eylem satırının Hero promosyon kökünün dışında olması gerektiğinde kullanın. Hero'nun kendisi, bölünmüş düzen de dahil olmak üzere her düzende Button Link çocuklarını kabul eder; amaçlanan kompozisyon bu olduğunda eylemleri Hero'nun içinde tutun.
Sınırlandırılmış varlık kartı ızgarası
section(spacing:lg)
└── container(width:lg)
├── header(h2)
└── grid(columns:3, gap:4)
├── card
│ └── card_body
│ ├── header(h3)
│ ├── plain_text
│ └── button_link
├── card
└── card
Her başlık, paragraf ve eylem bağımsız olarak düzenlenebilir durumda kalır. Bu tarifi ürünler, eklentiler, planlar, indirmeler veya hizmetler gibi kendi eylemleri olan sınırlı varlıklar için ayırın. Sabit kancalar aracılığıyla tutarlı, siteye özel Kart görünümü için CSS sitesini kullanın; HTML kartını enjekte etmeyin.
Alternatif görüntü ve kopya satırları
section
└── container
├── grid(columns:2, alternate_media_text_sections:true, alternate_start:media_left)
│ ├── image
│ └── card or content stack
└── grid(columns:2, alternate_media_text_sections:true)
├── image
└── card or content stack
Ön plan medyası için Görüntüyü kullanın. Arka plan özellikli bir bloğu yalnızca görüntü anlamsal olarak bir arka plan olduğunda kullanın.
Paylaşılan duyarlı gezinme çubuğu
sticky-navbar(sticky)
└── container(width:lg)
└── cluster(alignment:between, width:full)
├── navbar-brand
└── cluster
├── navbar-navigation
└── header-actions
Gezinme etiketleri ve URL'ler HTML'ye değil, CMS Gezinme kayıtlarına aittir.
Yönetilen resim kaydırıcısı
slider(height:viewport, autoplay:false, show_arrows:true, show_dots:true)
├── slide(background media)
│ └── container
│ ├── header
│ ├── plain_text
│ └── button_link
└── slide(background media)
└── container
└── card
└── card_body
└── rich-text
Tasarımdan CMS'ye İş Akışı
Görsel bir tasarım uygulamadan önce bir eşleştirme tablosu oluşturun:
| Tasarım bölgesi | İçerik sahibi | Blok ağacı | Çeşit/ayarlar | Sağlam CSS kancalar | Yetenek durumu |
|---|---|---|---|---|---|
| Örnek kahraman | Sayfa çevirileri ve Medya Kitaplığı | Bölüm → Kapsayıcı → Kahraman | vurgulu, ortalanmış, arka plan medyası | [data-wb-public-block-type="hero"], .wb-promo | Yalnızca arka plan medyası tanıtımının tasarımla eşleşmesi durumunda desteklenir |
Her bölge için:
- Düzenlenebilir her metin, medya, eylem, rozet, gezinme verisi ve dinamik kaydı tanımlayın.
- Her parçayı yönetici tarafından düzenlenebilir bir yerel alanla eşleyin.
- Ebeveyn/alt kuralları ve oluşturucuyu HTML doğrulayın.
- Belgelenen DOM ile görsel kompozisyonun mümkün olduğunu doğrulayın.
- CSS sitesini yalnızca kararlı DOM'un destekleyebileceği sunum için kullanın.
- Herhangi bir anlamsal alan, sarmalayıcı, yuva veya değişken eksikse bölgeyi desteklenmiyor olarak işaretleyin.
- Yeniden kullanılabilen en küçük CMS veya eklenti özelliğini önerin: bir oluşturucu değişkeni, yeni bir yapılandırılmış blok, mevcut bloklardan oluşan bir model veya Commerce ürün koleksiyonu gibi bir etki alanı bloğu.
- Kullanıcı bu uzlaşmayı açıkça onaylamadıkça, bilerek düşük kaliteli bir ikame uygulamayın.
Yetenek açığı rapor formatı:
Region: Storefront hero
Required editable content: title, body, two actions, foreground product image, offer badge, trust items
Current closest block: hero
Supported: title, eyebrow, body, background image, promo tone
Missing: foreground media slot, split DOM, trust-item collection, discoverable managed action child
Why CSS is insufficient: required semantic wrappers and editable fields do not exist
Recommended product change: add a reusable split/storefront Hero variant and structured trust-item children
HTML fallback: prohibited
CSS Kılavuzu
Stil katmanlarını şu sırayla kullanın:
- WebBlocks UI temel öğeler oluşturucu tarafından zaten yayınlanmıştır.
- Genel Tema belirteçleri ve moda duyarlı genel renk rolleri.
- Yerel blok ayarları ve çeşitleri.
- Sabit kancalar kullanan dar sahaya özel CSS.
- A yeniden kullanılabilir oluşturucu veya gerekli DOM eksik olduğunda sözleşme değişikliğini engelleyin.
Kararlı seçiciler şunları içerir:
body[data-wb-public-theme] {}
[data-wb-public-block-type="hero"] {}
[data-wb-public-block-type="card"] {}
.wb-promo {}
.wb-card {}
.wb-content-header {}
CSS sitesini şu amaçlarla kullanmayın:
- Sözde öğeler içeren temel metni ekleyin;
- oluşturulan blok kimliklerine bağlıdır;
- Kardeş sırasına göre anlam bilgisi;
- CMS tarafından yazılan içeriği yalnızca CSS içeriğiyle değiştirmek için gizleyin;
- Kırılgan mutlak konumlandırmayla eksik bir düzeni yeniden oluşturun;
- Açık/Koyu/Otomatik modunu bozan yalnızca ışık renklerini sabit kodlayın.
Denetim Temel Çizgisindeki Bilinen Kaynak Boşlukları
Bunlar davranışı icat etme izinleri değil, uygulama bulgularıdır:
- Çözüldü: Bu envanter artık
resources/contracts/inventory.mdolarak gönderiliyor ve araçlaraGET /webadmin/api/inventorytarafından sunuluyor. webblocks-cms-docs/docs/block-type-contracts.md, yayınlanmış 42 çekirdek türünü belirtirken mevcut katalogda 51 çekirdek türü tanımlanıyor.- Mevcut birçok belge hala
packages/webblocks-cms/...altında yalnızca ön paket oluşturucu yollarını gösteriyor; mevcut paket yollarıresources/views/...'de başlar. - Çözüldü: Güvenilir HTML artık API ile yazılamaz.
BlockTypeApiAuthoringPolicy, genel normalleştirme, mevcut blok PATCH ve Shared Slot yeniden sıralama, alt ağaç silme, tümünü temizleme ve yayınlama işlemleri dahil olmak üzere her API mutasyon yolunu engeller. - Çözüldü: Hero ve CTA, hem yöneticide hem de API'de
button_linkalt öğeleri için düz kapsayıcılardır.primary_cta/secondary_ctaalanları iki düğmeli bir kısayol olarak varlığını sürdürür. Yayınlanmamış eskibuttonkatalog satırı artık bir yazma engelleyici değildir. - Çözüldü: Sütun Öğesi düzenleyicisi artık Sütunlar
statsdeğişkeninin istatistik değeri olarak oluşturduğu altyazı alanını gösteriyor. - Ses'in normal bir yönetici medya seçicisi ve genel medya oluşturucusu vardır, ancak içerik planı doğrudan medya izin verilenler listesinde Ses'i içermez.
- Çözüldü: Simge normalleştirmenin bir sahibi var.
InternalContentApiOperations, standartPUBLIC_ICON_BLOCK_TYPESlistesinin yanı sıra paylaşılan bilgi/ton normalleştiricilerini içerir ve tam içerik planı bunlara yetki verir; böylece planlar ve artımlı blok uç noktaları, simgeleri aynı şekilde doğrular. - API blok ayarları henüz blok başına makine tarafından okunabilen bir ayarlar şeması tarafından yönetilmemektedir. Bilinmeyen ayarlar, hiçbir oluşturucu veya yönetici alanı bunları kullanmadığında bile normalizasyondan sağ çıkabilir.
- Çözüldü:
navigation-autoartıkBlockTypeContractRegistry'de belgelenmiş bir sözleşmeye sahip ve blok türleri ve içerik sözleşmesi aracılığıyla keşfedilebilir. - WebBlocks UI bir
wb-footer-*anatomisi sunar (wb-footer-grid,wb-footer-brand,wb-footer-nav,wb-footer-link,wb-footer-list,wb-footer-item,wb-footer-copy,wb-footer-meta,wb-footer-text,wb-footer-logo) hiçbir CMS oluşturucunun yaymadığı. Paylaşılan yuva altbilgisi bunun yerine genelwb-section/wb-container/wb-grid/wb-stack/wb-clusteroluşturur, böylece desene yalnızca elle yazılmış düzenlerden ulaşılabilir. 1.50.0'dan bu yana kozmetik.wb-slot-footer'ye kendi yüzeyini kazandırdı; altbilgi kompozisyonu bloğu, beklemede olmak yerine kasıtlı olarak ertelenmiş halde kalır. - Çözüldü:
GET /content-contract,media_librarybölümünü kayıtlı rota tablosundan türetiyor, bu nedenlesupported_operationsveunsupported_operations,openapi.json'nin yayınladığı şeyden sapamaz. Yükleme, uzaktan getirme, silme, değiştirme ve taşıma, her rotanın uyguladığı yetenekle desteklendiği şekilde yayınlanır. - Çözüldü: Onayın ziyaretçiye yönelik bir yarısı var. Sistem Ayarları başlığı geçişi, genel sayfalarda WebBlocks UI'nin Çerez Onay modelini oluşturur ve bunu mevcut
POST /privacy-consent/syncuç noktasına bağlar vecontact_form,settings.consent_required'nin yanı sıra her gönderimde kaydedilen çevrilmiş birconsent_labelelde eder. - Depoda kontrol paneli ve sayfa yönetimi ekran görüntüleri bulunur, ancak blok başına/varyant başına kanonik görsel fikstür galerisi yoktur. Dolayısıyla bu envanterdeki "Örnek görünüm" açıklamaları, ekran görüntüsüyle desteklenen altın referanslar değil, kaynaktan türetilmiştir. Bu galeri var olana kadar, belgelenmiş tarafsız kompozisyonları tercih edin ve yalnızca düzyazının görsel doğruluğunu iddia etmekten kaçının.
- Planlama için çözümlendi:
GET /content-contractartık karakter, yoğunluk, tipografi, geometri, görüntüler, köşeler, kontrast, ritim rolleri, Kart politikası ve bilinen kompozisyon boşluklarını kapsayan, makine tarafından okunabilir bir tasarım yönetimi sözleşmesi yayınlıyor. Kasıtlı olarak gizli bir stil kaydını sürdürmez; Yapay zeka araçları, planlarında/raporlarında yönü belirtir ve bunu desteklenen blok seçenekleri, tema belirteçleri ve kararlı site CSS aracılığıyla uygular.
Envanter İncelemesi ve Tazelik Kontrolleri
Ürün, bu çalışma zamanı sözleşmesinin sahibidir. Dokümantasyon deposu, oluşturulmuş bir sürümün anlık görüntüsünü farklı bir kaynak kimliğiyle tutar; Düzenlemeler ürün sözleşmesinde başlar.
CMS 1.94.3'ten itibaren composer test:inventory ve composer test:docs, resources/contracts/inventory-review.json'yi mevcut sözleşmeye ve çalışma zamanı kaynağı parmak izlerine göre doğrular. Değiştirilen, eklenen veya kaldırılan çalışma zamanı dosyaları ve ürün sürümü değişiklikleri, yeni ve açık bir inceleme gerektirir. CI ve ön-itme aynı kontrolü çalıştırın; sürüm hazırlığı çalışma ağacını kontrol eder ve yapı oluşturucu seçilen Git ağacını kontrol eder.
ADesteklenen alanları, numaralandırmaları, alt öğeleri, medyayı, oluşturmayı, düzenleyici davranışını, izinleri ve eklenti yaşam döngüsünü inceledikten sonra, bu metni güncelleyin ve incelemeyi composer inventory:review -- --reviewed --note="review summary" ile kaydedin. Kaynak değişikliğinden sonra değişmeyen bir sözleşme yalnızca açık bir --no-authoring-impact="reason" açıklamasıyla kabul edilir. İnceleme kayıtları hiçbir zaman CI veya sürüm komut dosyaları tarafından otomatik olarak yenilenmemelidir.
Mekanik kayıt, yayınlanan temel kataloğu, alt kuralları, oluşturucu kök sahipliğini, API yazma politikasını ve gerçek ürün yardımcılarından alınan mobil medya desteğini yakalar. PHPUnit bu kaydı mevcut yardımcılarla karşılaştırır ve kaynak kontrolü, yayınlanan her çekirdek blok için benzersiz bir envanter başlığı gerektirir. Parmak izleri ve mekanik karşılaştırmalar incelemeyi ve yapısal tutarlılığı zorunlu kılar; her cümlenin anlamını kanıtlamazlar. Düzgün ve etkisi olmayan açıklamalar katkıda bulunanın ve inceleyenin sorumluluğundadır.
Belge deposunun tools/inventory-snapshot.php'si, anlık görüntüyü ve onun inventory-source.json kaynağını yeniden oluşturur. Kontrolleri, manuel anlık görüntü düzenlemelerini reddeder ve ürün sürümünü, kaynak parmak izini, inceleme sağlama toplamını ve belge içeriğini seçilen ürün ödemesiyle karşılaştırır. Yalıtılmış dokümantasyon kontrolleri, çalışma zamanında ürüne ihtiyaç duymadan kayıtlı kaynağı doğrular. Anlık görüntü oluşturma ve CMS yayınlama ayrı işlemler olarak kalır.
İlgili Ayrıntılı Referanslar
webblocks-cms-docs/docs/ai-page-building-guide.mdwebblocks-cms-docs/docs/internal-content-api.mdwebblocks-cms-docs/docs/api-discovery.mdwebblocks-cms-docs/docs/block-type-contracts.mdwebblocks-cms-docs/docs/public-block-render-markup.mdwebblocks-cms-docs/docs/block-ui-renderer-contract.mdwebblocks-cms-docs/docs/public-theme-and-tones.mdwebblocks-cms-docs/docs/public-assets.mdwebblocks-cms-docs/docs/media-image-variants.md
Bu envanter, bir yapay zekanın sayfa tasarımı yeteneği seçimi için okuduğu ilk belge olmalıdır. Ayrıntılı referanslar uç nokta iş akışları, geçmiş uyumluluk ve tam oluşturucu notları için yararlı olmaya devam ediyor.
Eklenti başlatma ve kurtarma sözleşmesi
Katalog ve ZIP kurulumu, güncellemeleri ve panel/API aktivasyonu, eklenti kaynağını doğrular,
cms:plugin-probe aracılığıyla yeni bir PHP sürecinde sağlayıcı başlatma, komutlar ve yönlendirmeler.
Hiçbir geçiş beklemede olmasa bile doğrulama gereklidir. Başarısız veya zaman aşımına uğramış bir araştırma
mevcut paketi aktif bırakır; alt süreç tanılamaları yanıtlarda gösterilmez.
Varsayılan başlatma zaman aşımı 30 saniyedir (webblocks-plugins.install.boot_timeout_seconds).
Başarılı güncellemeler önceki paketi korur ve geçişlerin yapılıp yapılmadığını kaydeder. Veritabanı kurulum hataları eklentiyi devre dışı bırakır ve tablolarını ve paketlerini korur. Çalışma zamanı kaynağı/rota hataları eklentiyi karantinaya alır; açık bir devre dışı bırakma geçersiz kılmaları konfigürasyon tabanlı etkinleştirme. Yaşam döngüsü JSON kayıtları atomik değiştirmeyi kullanır.
/webadmin/plugin-recovery ve yüklü eklenti kaynağı olmadan giriş formu yüklemesi,
rotalar veya komutlar. Mevcut CMS oturum açma kontrolleri, aktif yönetici erişimi ve Super admin yetkilendirmesi ve CSRF
koruma geçerlidir. Kurtarma, bir eklentiyi devre dışı bırakabilir veya saklanan paketi geri yükleyebilir.
başka bir başlangıç araştırmasının ardından geçiş yapılmadı. Geri yükleme aynı zamanda varlıklarını da yeniden yayınlar.
Bu, CMS tarafından yönetilen paketler için kurtarmadır; keyfi ana bilgisayar sağlayıcılarını izole etmez
veya sandbox çalıştırılabilir PHP. Yakalanamayan sürecin sonlandırılması hala ayrı bir işlem gerektiriyor
işlem içi hata işleyicisi yerine kurtarma isteği.
Sistem Sağlığını Okuma Yetkisi
GET /webadmin/api/system/health, isteğe bağlı olarak etkinleştirilen system-health.read yetkisini ve kurulum genelinde geçerli bir sistem tokenını (allowed_site_ids: null) gerektirir; tokenın sahibi access-system yetkisine sahip etkin bir operatör olmalıdır. Kişisel ve site kapsamıyla sınırlı kimlik bilgileri kurulum sağlığını okuyamaz. İsteğe bağlı, doğrulanmış site_id parametresi site kontrollerini filtreler; kurulum genelindeki kontroller görünür kalır.
Uç nokta; güvenli mesaj anahtarları/parametreleri, sıralanmış sorunlar, kategori durumları (healthy, warning, critical, unknown, not_applicable), site özetleri, sistem bilgileri ve son işlem sonuçlarını döndürür. Site, yedekleme, depolama, eklenti, güncellemeye hazır olma ve geçmiş gözlemleri beş dakika önbellekte tutulur; zamanlayıcı kanıtları her istekte okunur. Bilinmeyen ve isteğe bağlı kontroller başarılı kontrollerden ayrı tutulur. Sağlık bilgilerini okumak veya yenilemek; içeriği değiştirmez, yedekleme kayıtlarını uzlaştırmaz, e-posta göndermez, temizlik veya güncelleme çalıştırmaz, sürüm meta verilerini getirmez ya da zamanlayıcı kanıtı üretmez. Eklenti raporlayıcıları mevcut sağlık raporlayıcısı sözleşmesini korur; ham raporlayıcı mesajları ve istisna ayrıntıları bu genel görünümden çıkarılır.
Mevcut operasyon rotaları kullanılabilir kalır. Eklentilerin Yardım hedefleri Sistem grubuna katılır; eklentilerin Bakım hedefleri sabit bakım grubu anahtarıyla birleştirilir. Çekirdek Yardım öğesi doğrudan dokümantasyona bağlanır. Sağlık durumu, inceleme için kanıttır; içerik yayımlama, yedek geri yükleme veya bir ana makineyi güncelleme yetkisi değildir. Arama kontrolleri, uygun yayımlanmış sayfa/dil kapsamlarını dizin kayıtlarıyla karşılaştırır; metnin güncelliğini kanıtlamaz. Yedeğin kullanılabilir olması geri yükleme bütünlüğünü kanıtlamaz. Güncellemeye hazır olma durumu normal site işleyişinden ayrı kalır.