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:
/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:
{
"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:
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:
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,partsve geneluiailesi örnekleriorder: 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ınsourceöğesi kararlı kaynak kimliğidir,pathise fiziksel işleme şablonunun yoludurwarningsveerrors: çıktı olarak üretilen metinler yerine yapılandırılmış sorunlardeleted: artık mevcut olmayan, istenen tanımlayıcılarselection: 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,nullveya"*", 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.enabledayarıtrue.- Mevcut kullanıcı
edit_postsyeteneğine sahip.
Herkese açık ziyaretçiler tuval betiğini veya sayfa meta verilerini hiçbir zaman görmez.