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:

  1. CMS yöneticisinde hangi içerik düzenlenebilir durumda kalır?
  2. Hangi paylaşılan ayarlar ve değişkenler destekleniyor?
  3. Hangi çocuk ve medya ilişkileri geçerlidir?
  4. Oluşturucu hangi kararlı genel HTML'yi yayıyor?
  5. 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): variant Kart 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_layout ve settings.list_frame.
  • link-list-item (1.40.8): isteğe bağlı media_id küçü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.php
  • src/Support/BlockTypes/BlockTypeContractRegistry.php
  • src/Support/Blocks/BlockTranslationRegistry.php
  • src/Models/Block.php
  • src/Http/Requests/Admin/BlockRequest.php
  • src/Support/InternalContentApi/InternalContentPlanService.php
  • src/Support/InternalContentApi/InternalContentApiOperations.php
  • src/Http/Controllers/InternalContentApi/InternalContentResourceController.php
  • src/Http/Controllers/InternalContentApi/InternalSharedSlotController.php
  • src/Http/Controllers/InternalContentApi/InternalApiDiscoveryController.php
  • routes/admin.php
  • resources/views/admin/blocks/types/*.blade.php
  • resources/views/admin/blocks/settings/*.blade.php
  • resources/views/pages/partials/blocks/*.blade.php
  • public/cms/css/public.css
  • odaklanmış paket testleri ve güncel ürün dokümantasyonu

Pazarlık Edilemez Yapay Zeka Yazma Kuralları

  1. 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.
  2. html yalnı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.
  3. 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.
  4. Yalnızca burada belgelenen ve canlı keşifle onaylanan alanları, numaralandırma değerlerini, medya rollerini ve alt ilişkileri kullanın.
  5. 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.
  6. 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.
  7. 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.
  8. Temel tasarım davranışı için veritabanı kimliklerini, oluşturulan blok kimliklerini, kardeş konum seçicilerini veya :nth-child()'yi hedeflemeyin. Blok tipi nitelikleri, yerel wb-* sınıflarını, sayfa gövdesi sınıflarını ve belgelenmiş ayarları tercih edin.
  9. 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.
  10. Ö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.
  11. 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.
  12. 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.
  13. 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 translations altına yerleştirin.
  • URL'yi, hedefi, sunum değişkenini ve diğer paylaşılan seçenekleri settings altına yerleştirin.
  • Doğrudan Medya Kitaplığı atamasını media_id'ye yerleştirin.
  • slide, image, hero, section, card, cta, content_header ve link-list-item ayrıca isteğe bağlı üst düzey mobile_media_id referanslamayı da kabul eder bir görüntü Medya Kitaplığı kaydı. Rol ile block_media'de saklanır mobile_image, yerel ayarlar arasında paylaşılır ve yönetici ortamı aracılığıyla düzenlenebilir seçici ve PATCH /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çin null gö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_items veya gallery_media_ids'ye yerleştirin.
  • Yalnızca yuvalanmış children kullanın; id, parent_id, block_id, slot_type_id veya block_type_id göndermeyin.
  • API şu anda geniş şekilli bir settings nesnesini 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.
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.
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ı.
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.
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.
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.
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.
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ı.
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.
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.
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.
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ığı.
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.
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ı.
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ı.
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:

  1. Düzenlenebilir her metin, medya, eylem, rozet, gezinme verisi ve dinamik kaydı tanımlayın.
  2. Her parçayı yönetici tarafından düzenlenebilir bir yerel alanla eşleyin.
  3. Ebeveyn/alt kuralları ve oluşturucuyu HTML doğrulayın.
  4. Belgelenen DOM ile görsel kompozisyonun mümkün olduğunu doğrulayın.
  5. CSS sitesini yalnızca kararlı DOM'un destekleyebileceği sunum için kullanın.
  6. Herhangi bir anlamsal alan, sarmalayıcı, yuva veya değişken eksikse bölgeyi desteklenmiyor olarak işaretleyin.
  7. 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.
  8. 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:

  1. WebBlocks UI temel öğeler oluşturucu tarafından zaten yayınlanmıştır.
  2. Genel Tema belirteçleri ve moda duyarlı genel renk rolleri.
  3. Yerel blok ayarları ve çeşitleri.
  4. Sabit kancalar kullanan dar sahaya özel CSS.
  5. 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:

  1. Çözüldü: Bu envanter artık resources/contracts/inventory.md olarak gönderiliyor ve araçlara GET /webadmin/api/inventory tarafından sunuluyor.
  2. 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.
  3. 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.
  4. Çö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.
  5. Çözüldü: Hero ve CTA, hem yöneticide hem de API'de button_link alt öğeleri için düz kapsayıcılardır. primary_cta / secondary_cta alanları iki düğmeli bir kısayol olarak varlığını sürdürür. Yayınlanmamış eski button katalog satırı artık bir yazma engelleyici değildir.
  6. Çözüldü: Sütun Öğesi düzenleyicisi artık Sütunlar stats değişkeninin istatistik değeri olarak oluşturduğu altyazı alanını gösteriyor.
  7. 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.
  8. Çözüldü: Simge normalleştirmenin bir sahibi var. InternalContentApiOperations, standart PUBLIC_ICON_BLOCK_TYPES listesinin 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.
  9. 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.
  10. Çözüldü: navigation-auto artık BlockTypeContractRegistry'de belgelenmiş bir sözleşmeye sahip ve blok türleri ve içerik sözleşmesi aracılığıyla keşfedilebilir.
  11. 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 genel wb-section/wb-container/wb-grid/wb-stack/wb-cluster oluş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.
  12. Çözüldü: GET /content-contract, media_library bölümünü kayıtlı rota tablosundan türetiyor, bu nedenle supported_operations ve unsupported_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.
  13. Çö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/sync uç noktasına bağlar ve contact_form, settings.consent_required'nin yanı sıra her gönderimde kaydedilen çevrilmiş bir consent_label elde eder.
  14. 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.
  15. Planlama için çözümlendi: GET /content-contract artı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.

  • webblocks-cms-docs/docs/ai-page-building-guide.md
  • webblocks-cms-docs/docs/internal-content-api.md
  • webblocks-cms-docs/docs/api-discovery.md
  • webblocks-cms-docs/docs/block-type-contracts.md
  • webblocks-cms-docs/docs/public-block-render-markup.md
  • webblocks-cms-docs/docs/block-ui-renderer-contract.md
  • webblocks-cms-docs/docs/public-theme-and-tones.md
  • webblocks-cms-docs/docs/public-assets.md
  • webblocks-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.