İçeriğe geç

Canvas

Canvas, Blockstudio tarafından yönetilen tüm sayfaların Figma benzeri, uzaklaştırılmış bir genel görünümünü sunar. Her sayfa, tek bir yatay sırada canlı bir iframe çalışma yüzeyi olarak görüntülenir. İzleme dörtgeninizle kaydırın; sıkıştırma hareketiyle veya Ctrl+kaydırma ile yakınlaştırın.

Etkinleştirme

Canvas, gizli bir yönetim sayfası olarak kullanılabilir. Şuraya gidin:

Kod
/wp-admin/admin.php?page=blockstudio-canvas

Sayfaya yalnızca dev.canvas.enabled, true olduğunda ve geçerli kullanıcıda edit_posts yeteneği bulunduğunda erişilebilir.

Ayarlar

Temanızın blockstudio.json dosyasında Canvas’ı etkinleştirin ve davranışını yapılandırın:

JSON
{
  "dev": {
    "canvas": {
      "enabled": true,
      "adminBar": false
    }
  }
}
Özellik Tür Varsayılan Açıklama
enabled boolean false Canvas özelliğini etkinleştirir.
adminBar boolean true WordPress yönetim çubuğunu çalışma yüzeyi iframe’leri içinde gösterir. Daha sade bir önizleme için false olarak ayarlayın.

Her iki ayara filtreler aracılığıyla da erişilebilir:

PHP
add_filter('blockstudio/settings/dev/canvas/enabled', '__return_true');
add_filter('blockstudio/settings/dev/canvas/admin_bar', '__return_false');

Görünümler

Sağ üst köşedeki açılır menüyü kullanarak görünümler arasında geçiş yapın.

  • Sayfalar: Blockstudio tarafından yönetilen tüm sayfaları, tek bir sırada tam genişlikli çalışma yüzeyleri olarak gösterir.
  • Bloklar: Kayıtlı tüm Blockstudio bloklarını ızgara düzeninde gösterir; her biri varsayılan öznitelik değerleriyle görüntülenir.

Herkese Açık Envanter ve Belge API

Canvas, aynı kayıtlı içeriğe ihtiyaç duyan araçlar için sürümlendirilmiş, tüketiciden bağımsız bir PHP sözleşmesi sunar; böylece Blockstudio öğesinin keşif veya işleme mantığını yeniden oluşturmaya gerek kalmaz:

PHP
use Blockstudio\Canvas;

$all = Canvas::inventory();

$changed = Canvas::inventory([
  'blocks' => ['theme/hero'],
  'pages' => ['about'],
]);

$documents = Canvas::documents([
  'patterns' => ['theme/featured'],
  'templates' => ['front-page'],
]);

Geçerli sürüm Canvas::SCHEMA_VERSION olarak kullanılabilir. Envanter sonuçları şunları içerir:

  • inventory: normalleştirilmiş pages, blocks, patterns, templates, parts ve genel ui ailesi örnekleri
  • order: türler arası kararlı görüntüleme sırası
  • sources: her kaydın kaynağı belirtilerek seçilen kaynak yollarının tam listesi; bir sayfa kaydının source öğesi kararlı kaynak kimliğidir, path ise fiziksel işleme şablonunun yoludur
  • warnings ve errors: çıktı olarak üretilen metinler yerine yapılandırılmış sorunlar
  • deleted: artık mevcut olmayan, istenen tanımlayıcılar
  • selection: normalleştirilmiş seçim ve bunun hedefli olup olmadığı

Canvas::documents(), seçilen her kayıt için eksiksiz bir işleme belgesi ekler. Her belge gövdesini, birleştirilmiş HTML öğesini, bağımlılıkları dâhil blok adlarını, tam CSS, JavaScript, modülleri, etkileşim başlatma kodunu, paketlenmiş UI genel değişkenlerini ve Tailwind çıktısını içerir. Sayfa belgelerinde anlamsal bir <main> içerik sarmalayıcısı kullanılır; çağıranlar bunu ortak İşleme belgesi seçenekleriyle geçersiz kılabilir veya devre dışı bırakabilir. Seçilen her sayfa, geri yüklenmiş kendi ön yüz WordPress bağlamında işlenir. Böylece sorgu koşulları, body-class filtreleri, kısa kodlar, düzenler, yönlendirmeler ve wp_enqueue_scripts geri çağırımları, Canvas sonucunu isteyen yönetim veya REST isteği yerine ilgili sayfayı görür. Çağıranın sağladığı gövde sınıfları, sayfanın bağlamsal sınıflarıyla birleştirilir ve ön yüz kuyruk kayıtları belgeler arasında yalıtılır. Canvas, bu yaşam döngüsü geri çağırımlarını herkese açık WordPress işlev adlarıyla çözümler; bu nedenle Blockstudio, Composer aracılığıyla veya taşınmış bir uygulama ad alanında yüklendiğinde de aynı bağlam korunur.

Tam seçim anlambilimi

Seçim katı kurallara tabidir:

  • Tanınan tür anahtarı yoksa tüm türler yüklenir.
  • true, null veya "*", ilgili türdeki tüm kayıtları yükler.
  • Bir dize veya liste yalnızca tam kimlikleri, adları, kısa adları, yolları ya da kaynak yollarını yükler.
  • Boş bir dize/liste veya false, o türden hiçbir şey yüklemez.
  • Herhangi bir tür anahtarı bulunduğunda, belirtilmeyen türler keşfedilmez, eşitlenmez, işlenmez veya derlenmez.

Bu, yalnızca değişenleri isteyen sorguları büyük projeler için güvenli kılar. Mevcut bloklar ve sayfalar kurallı kayıt defterleri aracılığıyla çözümlenir. Bir ön yüz isteğinde yalnızca kalıcı sayfa izdüşümü yüklüyse, Canvas salt okunur bir kaynak keşfi yapar ve içeriği eşitlemeden eşleşen gönderi kimliklerini ve kalıcı bağlantıları birleştirir. Mantıksal bir keşif kaynağı önce kaynak tabanlı kayıt defterini doldurduğunda da aynı kimlik birleştirmesi uygulanır; böylece bağlamsal sayfa işleme eşleşen yönetilen WordPress gönderisini kullanmaya devam eder. Yeni canlı oturum topolojisi yalnızca değişen dizinin çevresinde keşfedilir; seçilen kalıp ve Site Editor şablon kaynakları ise ancak seçimden sonra derlenir.

REST yenileme uç noktası da mevcut blocks ve pages sorgu parametreleri için aynı kuralı uygular. Örneğin, ?blocks=theme/hero yalnızca o bloğu döndürür, hiçbir sayfa döndürmez; karma bir yanıt için her iki parametreyi de kullanın. Uç noktayı iki parametre olmadan çağırmak, eski tam yanıtı korur.

Canlı Mod

Canlı mod, dosya değişikliklerini algılamak ve Canvas’ı gerçek zamanlı güncellemek için Server-Sent Events (SSE) kullanır. Bir blok şablonunu, sayfa şablonunu veya stil sayfasını düzenlediğinizde, etkilenen çalışma yüzeyleri yaklaşık bir saniye içinde otomatik olarak yenilenir.

Açılır menüden canlı modu açıp kapatın. Etkin olduğunda yeşil, titreşimli bir gösterge görünür. Ayar, localStorage aracılığıyla oturumlar arasında korunur.

Canlı mod, blok ve sayfa dizinlerindeki .php, .json, .css, .scss, .js, .twig ve .html dosyalarındaki değişiklikleri izler. Bilinen düzenlemeler yalnızca kayıtlı oldukları bloğu veya sayfayı yeniler. Gerçekten yeni bir blok ya da sayfa oluşturulduğunda, dizin kapsamında tek bir topoloji taraması yapılır; böylece açık bir canlı oturum sırasında içerik oluşturmak, ilgisiz kaynakları yeniden taramadan çalışır.

Odak Modu

Odak moduna geçmek için herhangi bir çalışma yüzeyi etiketine tıklayın. Seçilen çalışma yüzeyi tam genişlikte görünümü doldurur ve dikey kaydırma sağlar. Genel görünüme dönmek için Escape tuşuna basın veya kapat düğmesine tıklayın.

Denetimler

Eylem Girdi
Kaydırma Kaydırma / izleme dörtgeninde iki parmakla sürükleme
Yakınlaştırma Ctrl+kaydırma veya sıkıştırma hareketi
Görünüme sığdır Açılır menü
100% boyutuna yakınlaştır Açılır menü
Çalışma yüzeyine odaklan Çalışma yüzeyi etiketine tıklama
Odaktan çık Escape / kapat düğmesi

Güvenlik

Canvas betiği ve sayfa verileri yalnızca tüm koşullar karşılandığında yüklenir:

  • dev.canvas.enabled ayarı true.
  • Mevcut kullanıcı edit_posts yeteneğine sahip.

Herkese açık ziyaretçiler tuval betiğini veya sayfa meta verilerini hiçbir zaman görmez.