WebBlocks CMS Sayfa Dönüştürücü Yol Haritası

Sayfa Dönüştürücü, yapıştırılan veya yüklenen statik HTML'i birinci sınıf bloklardan oluşan yapılandırılmış CMS sayfalarına dönüştüren, önerilmiş yeniden kullanılabilir bir WebBlocks CMS yönetim özelliğidir.

Bu özellik; statik siteleri, elle yazılmış HTML sayfalarını, dokümantasyon sayfalarını, pazarlama sayfalarını ve eski içerikleri, sayfa gövdesinin tamamını tek bir Safe HTML bloğuna indirgemeden WebBlocks CMS'e taşımaya yardımcı olmalıdır.

Amaç, webblocksui.com için siteye özel bir içe aktarıcı oluşturmak değildir. Dönüştürücü, bir WebBlocks CMS kurulumunun yönettiği herhangi bir site için kullanılabilecek genel bir CMS yeteneği olmalıdır.

İlk çalışma zamanı temeli hazır: Admin -> Pages -> Page Converter, kapsamlandırılmış hedef/kaynak formunu görüntüler ve hedef yol çakışmaları dahil olmak üzere yapıştırılan veya yüklenen .html / .htm girdisini doğrular. Analizci, gönderilen HTML'i normalleştirir, en olası içerik alanını çıkarır ve güven puanları ve uyarılarla birlikte sıralı yapılandırılmış blok önerilerini gösterir. İnceleme ekranı bu önerileri imzalı bir dönüştürme planı yüküne serileştirir; ardından Create draft page, imzalı hedef ayrıntılarını yeniden doğrular ve desteklenen ana slot bloklarıyla bir yeni taslak sayfa oluşturabilir. Taslak oluşturma; header, plain_text, rich-text, code, table, quote, açık html geri dönüşü, button_link, Rich Text olarak list, Alert olarak callout, section, content_header, hero, cta ve imzalı card_header / card_body / card_footer alt öğelerine sahip açık card kabuklarını destekler. Bölüm benzeri <section> parçaları Section kapsayıcı blokları olarak korunur ve bunların kullanılabilir başlıkları, metinleri, bağlantıları, tanıtım içerikleri, kart ızgaraları ve bitişik details grupları, bölüm metni olarak saklanmak yerine alt öneriler olarak üretilir. Bitişik <details> grupları artık açık accordion_item alt öğelerine sahip tek bir imzalı accordion önerisine dönüşür ve hem accordion hem faq blok türleri yayında olduğunda taslak oluşturma bu öğeleri mevcut faq alt satır sözleşmesine yazar. Açık kullanılabilir bölge alt öğeleri olmayan kart önerileri ile kullanılabilir öğe sözleşmesi olmayan akordeon önerileri, güvensiz HTML'e düzleştirilmek yerine atlanır. image ve gallery gibi medyaya dayalı öneriler hâlâ atlanır ve medya içe aktarılmadan raporlanır.

Kompakt bir WebBlocks UI havalı fixture pilotu artık <main>, içerik başlığı/gövde sarmalayıcıları, tanıtım, kart ızgarası, düğmeler, kod, tablo, bitişik details ve uzak görsel medya içeren gerçekçi bir statik dokümantasyon/pazarlama parçasını kapsıyor. Fixture; analizin tek bir Safe HTML geri dönüşü yerine çok sayıda yapılandırılmış öneri üretmesini, imzalı bir plan ve taslak sayfa oluşturmasını, mevcut blok sözleşmesinin temsil edebildiği yerlerde açık kart bölgelerini ve alt bilgi düğme bağlantılarını korumasını ve medyaya dayalı parçaları dosya içe aktarmadan, sayfa yayınlamadan, gezinme oluşturmadan, ortak slotlara dokunmadan, uzak URL'ler getirmeden veya içeriğin üzerine yazmadan yalnızca uyarı verilen/atlanan durumda tutmasını güvence altına alır.

Dönüştürücü, tek bir Safe HTML bloğu yerine yapılandırılmış CMS bloklarını tercih etmelidir.

Kötü çıktı:

Tercih edilen çıktı:

Safe HTML, yalnızca henüz yapılandırılmış CMS bloklarıyla temsil edilemeyen parçalar için görünür ve incelenebilir bir geri dönüş olarak kullanılabilir.

Önerilen yönetim paneli konumu:

Araç, çıktısı bir CMS sayfa taslağı olduğu için Sayfalar bölümüne yakın olmalıdır. Bu, öncelikle operasyonel bir bakım aracı değil, editoryal/içerik aracıdır.

Olası ikincil giriş noktası:

Bununla birlikte, ana Sayfa Dönüştürücü akışı; kaynak girişi, analiz, inceleme, uyarılar ve nihai taslak oluşturma içerdiği için kendi ekranına sahip olmalıdır.

• super_admin: Sayfa Dönüştürücü'yü tüm siteler için kullanabilir.
• site_admin: Sayfa Dönüştürücü'yü atanmış siteler için kullanabilir.
• editor: daha sonra mümkün olabilir; MVP için temkinli kalın ve mevcut sayfa oluşturma izinlerine göre karar verin.

Oluşturulan sayfalar her zaman draft olarak başlamalıdır.

Dönüştürücü asla otomatik olarak yayınlamamalıdır.

• Sayfalar alanı altında yönetim ekranı.
• Kullanıcı erişimiyle sınırlı Hedef Site seçici.
• Hedef Dil (Locale) seçici.
• Hedef Sayfa Yerleşimi seçici.
• Sayfa başlığı alanı.
• Slug/yol alanı.
• Kaynak HTML metin alanı.
• .html ve .htm için kaynak HTML dosyası yükleme.
• Bellek içi bir dönüştürme planı oluşturan Analiz eylemi.
• Önerilen blokları, güveni, uyarıları ve geri dönüşleri gösteren inceleme ekranı.
• Nihai Create Draft Page eylemi.
• Yol çakışması doğrulaması.
• Yalnızca taslak olarak sayfa oluşturma.
• Yüksek güvenli eşlemeler için yapılandırılmış blok oluşturma.
• Açık Safe HTML geri dönüş raporlaması.
• Odaklı testler.
• Dokümantasyon ve changelog güncellemeleri.

• Uzak URL getirme.
• Web sitesi tarama (crawling).
• Çok sayfalı ZIP içe aktarma.
• Toplu dönüştürme.
• Ekran görüntüsü karşılaştırma.
• AI API entegrasyonu.
• Otomatik yayınlama.
• Mevcut bir sayfanın üzerine yazma veya değiştirme.
• Uzak URL'lerden medya dosyası indirme/içe aktarma.
• Eski sayfaların veya Safe HTML bloklarının yıkıcı temizliği.

Yönetici şunları seçer:

• Hedef Site
• Hedef Dil (Locale)
• Sayfa Yerleşimi
• Sayfa başlığı
• Sayfa slug/yolu
• Dönüştürme profili
• Kaynak HTML yapıştırma veya yüklenen dosya

Dönüştürücü, HTML'i analiz eder ve sayfa içeriğini veritabanına yazmadan bir dönüştürme planı üretir.

Örnek analiz özeti:

İnceleme ekranı, önerilen her bloğu gösterir:

İnceleme ekranı şunları net biçimde ayırmalıdır:

• yüksek güvenli yapılandırılmış bloklar
• orta güvenli öneriler
• yok sayılan parçalar
• geri dönüş Safe HTML parçaları
• güvensiz olduğu için ayıklanan içerik
• medya uyarıları

Araç, yalnızca açık onaydan sonra yeni bir taslak sayfa oluşturur.

İşlem transactional olmalı ve şunları oluşturmalıdır:

• sayfa kaydı
• sayfa çevirisi
• gerekli sayfa slotları
• blok ağacı
• blok çevirileri
• blok ayarları ve ilişkileri
• mevcut revizyon servislerinin desteklediği yerlerde revizyon meta verileri

Araç sayfayı yayınlamamalıdır.

Profiller, dönüştürücüyü siteye özel hale getirmeden farklı eşleme katılık düzeylerine olanak tanır.

Açılış sayfaları ve ürün sayfaları için en uygunudur.

Öncelik verdikleri:

• Hero
• Section
• Daha sonraki bir yapılandırılmış eşlemenin kaynağı güvenle temsil edebildiği yerlerde Columns ve Column Item
• Card
• Button Link
• CTA
• Image
• Gallery
• Quote

Dokümantasyon ve uzun biçimli içerik için en uygunudur.

Öncelik verdikleri:

• Content Header
• Header
• Rich Text
• Code
• Table
• List
• Callout
• Accordion
• TOC

Zaten WebBlocks UI sınıf adlarını kullanan sayfalar için en uygunudur.

Şunlar için sınıf farkındalıklı eşlemeye öncelik verir:

• wb-section
• wb-content-header
• wb-promo
• wb-card
• wb-grid
• wb-btn
• wb-alert
• wb-gallery
• wb-rich-text
• wb-link-list

Bu profil genel ve yeniden kullanılabilir kalmalıdır. ui.webblocksui.com gibi belirli bir alan adını varsaymamalıdır.

Kaynak HTML dağınık veya bilinmez olduğunda en uygunudur.

Öncelik verdikleri:

• daha az tahmin
• daha fazla zengin metin gruplaması
• açık uyarılar
• görünür geri dönüşler

Safe HTML varsayılan dönüştürme çıktısı değil, son çare olmalıdır.

• CMS'in bu parça için henüz birinci sınıf bir bloğu yoktur.
• İşaretleme, mevcut sürümde güvenle eşlenemeyecek kadar karmaşıktır.
• Dönüştürücünün güveni düşüktür.
• Yönetici, inceleme sırasında geri dönüşü açıkça kabul eder.

Her geri dönüş, inceleme ekranında şunlarla birlikte gösterilmelidir:

• kaynak parça önizlemesi
• neden
• güven puanı
• uyarı metni
• sayfadaki yaklaşık konum

Dönüştürücü, anlamlı yapılandırılmış blok eşlemeleri mevcutken tüm main içeriği için tek bir büyük Safe HTML bloğu oluşturmamalıdır.

Dönüştürücü, yapılandırılmış metin dönüştürmesini agresif biçimde temizlemelidir.

Ayıklanacak veya reddedilecekler:

• <script>
• onclick gibi olay öznitelikleri
• javascript: URL'leri
• iframe
• object
• embed
• açıkça desteklenmeyen tehlikeli satır içi stiller
• bilinmeyen çalıştırılabilir öznitelikler

SSRF risklerinden kaçınmak için uzak URL getirme MVP dışında bırakılmıştır. Daha sonra eklenirse şunları engellemelidir:

• localhost
• özel IP aralıkları
• link-local adresler
• metadata servisleri
• dahili ana bilgisayar adları
• engellenen adreslere yönlendirmeler

MVP tam medya içe aktarmayı denememelidir.

Görseller için:

• görsel referanslarını tespit et
• yalnızca mevcut CMS medya eşleştirmesi uygulanmışsa görsel yer tutucusu oluştur
• aksi halde bir medya uyarısı raporla
• manuel kullanım için alt/başlık önerilerini koru

Sonraki aşamalar şunları ekleyebilir:

• bir HTML arşiviyle birlikte yerel görsel dosyalarını yükleme
• mevcut medyayı dosya adı/karma (hash) ile eşleştirme
• ZIP paketlerinden görsel içe aktarma
• görsel bloklarını CMS medya kimlikleriyle yeniden yazma

Denetleyiciler ince kalmalı ve ayrıştırmayı/dönüştürmeyi servislere devretmelidir.

Taslak sayfa oluşturulurken:

• veritabanı transaction'ları kullan
• yalnızca yeni bir sayfa oluştur
• MVP'de asla mevcut sayfaların üzerine yazma
• sayfayı draft olarak oluştur
• seçilen dil (locale) için varsayılan çeviriyi oluştur
• seçilen yerleşim için gerekli slotları oluştur
• MVP'de yalnızca sayfaya ait blokları oluştur
• ortak slotları otomatik olarak oluşturma
• otomatik olarak yayınlama
• mevcut servisler desteklediğinde revizyon meta verilerini kaydet

MVP, mevcut sayfa oluşturma ve site erişim kurallarını izlemelidir.

Önerilen erişim:

• super_admin: tüm siteler
• site_admin: atanmış siteler
• editor: erteleyin veya yalnızca normal sayfa oluşturma izin veriyorsa izin verin

Tüm site seçiciler, kimliği doğrulanmış kullanıcının erişebildiği sitelerle kapsamlandırılmalıdır.

Dönüştürücü şunları doğrulamalıdır:

• seçilen site mevcut ve erişilebilir
• seçilen dil (locale) mevcut ve site için etkin
• seçilen yerleşim mevcut ve aktif
• başlık mevcut
• yol/slug geçerli
• yol, aynı site ve dil (locale) için mevcut bir sayfa çevirisiyle çakışmıyor

MVP, mevcut bir sayfayı değiştirmemeli, onunla birleştirmemeli veya güncellememelidir.

Mevcut WebBlocks CMS yönetim paneli kalıplarını kullanın:

• kart tabanlı formlar
• kompakt inceleme tabloları
• net uyarılar
• yalnızca yararlı olduğunda modal
• yıkıcı eylemler için tarayıcı confirm'i yok
• gerekli olmadıkça özel CSS/JS yok
• yalnızca WebBlocks UI sınıfları

İnceleme ekranı şu soruların kolayca yanıtlanmasını sağlamalıdır:

• Ne oluşturulacak?
• Hangi kısımlar yapılandırılmış bloklar?
• Hangi kısımlar geri dönüş HTML'i?
• Hangi kısımlar yok sayıldı?
• Ne manuel inceleme gerektiriyor?

Odaklı özellik testleri şunları kapsamalıdır:

• yetkili kullanıcılar Sayfa Dönüştürücü'yü açabilir
• yetkisiz kullanıcılar erişimleri olmayan sitelere erişemez
• yapıştırılan HTML analiz edilebilir
• yüklenen .html dosyası analiz edilebilir
• desteklenmeyen dosya türleri reddedilir
• script'ler ve güvensiz öznitelikler yapılandırılmış dönüştürmeden ayıklanır
• h1/h2 başlık bloğu önerisine eşlenir
• paragraflar rich-text/plain_text önerilerine eşlenir
• pre > code kod önerisine eşlenir
• table tablo önerisine eşlenir
• .wb-card kart önerisine eşlenir
• .wb-grid kart öğeleri açık kart bölgesi önerilerine eşlenir
• bilinmeyen parçalar sessizce atılmak yerine geri dönüş olarak raporlanır
• hedef yol çakışması taslak oluşturmayı engeller
• taslak sayfa yalnızca açık gönderimden sonra oluşturulur
• oluşturulan sayfa yayınlanmaz
• hiçbir mevcut sayfanın üzerine yazılmaz

Ekleyin veya güncelleyin:

• docs/page-converter.md
• docs/index.md
• README.md
• CHANGELOG.md

Dokümantasyon şunları içermelidir:

• özelliğin amacı
• kaynak girdi modları
• dönüştürme profilleri
• Safe HTML geri dönüş politikası
• güvenlik istisnaları
• MVP sınırlamaları
• gelecek yol haritası

Bu yol haritasını oluşturun ve Sayfa Dönüştürücü planlaması için standart bir CMS dokümantasyon sayfası ekleyin.

Çalışma zamanı değişikliği yok.

Yalnızca yönetim ekranını ve analiz akışını ekleyin.

• Yapıştırılan HTML'i kabul et.
• Dönüştürme planı üret.
• İnceleme ekranını göster.
• Henüz sayfa oluşturma.

Açık oluşturma eylemini ekleyin.

• Taslak sayfa oluştur.
• Ana slot bloklarını oluştur.
• Yol çakışmalarını doğrula.
• Uyarıları arayüzde koru.

.html / .htm yükleme desteğini ekleyin.

Şunlar için eşlemeleri iyileştirin:

• daha derin kart bölgesi alt öğeleri
• sütunlar
• mevcut düz metin faq alt sözleşmesinin ötesinde daha zengin akordeon öğesi görüntüleme
• tablolar
• listeler
• callout'lar
• hero/cta yönetilen düğme alt öğeleri

Yerel görsel paketleri veya mevcut medyayla eşleştirme için isteğe bağlı destek ekleyin.

Çok sayfalı iş akışları ekleyin:

• ZIP yükleme
• sayfa envanteri
• sayfa başına inceleme
• toplu taslak oluşturma

Yalnızca katı SSRF ve ağ güvenliği kuralları uygulandıktan sonra.

MVP şu koşullarda başarılıdır:

• Yönetici tek bir statik HTML sayfasını yapıştırabilir veya yükleyebilir.
• CMS incelenebilir bir dönüştürme planı gösterir.
• Yaygın HTML yapıları yapılandırılmış CMS bloklarına dönüşür.
• Safe HTML geri dönüşü görünür ve sınırlıdır.
• Yönetici yeni bir taslak sayfa oluşturabilir.
• Oluşturulan sayfa normal Page Builder'da düzenlenebilir.
• Hiçbir sayfa otomatik olarak yayınlanmaz.
• Hiçbir mevcut sayfanın üzerine yazılmaz.
• Testler temel dönüştürme ve güvenlik davranışını kapsar.

WebBlocks UI statik site taşıması, bu genel Sayfa Dönüştürücü'nün ilk gerçek dünya kullanımı olmalıdır.

Önerilen pilot sayfa:

Neden bu sayfa:

• birçok WebBlocks UI deseni içeriyor
• dokümantasyon yerleşimi davranışını test ediyor
• içerik kabuğu, kartlar, tablolar, durum yönergeleri ve kod benzeri örnekler içeriyor
• WebBlocks UI sınıf farkındalıklı eşlemeyi doğrulamaya yardımcı oluyor

Taşıma, WebBlocks UI'ye özgü davranışı doğrudan CMS çekirdeğine eklememelidir. Ek eşleme zekâsı gerekiyorsa bunu WebBlocks UI-flavored HTML gibi yeniden kullanılabilir bir profil olarak, ya da daha sonra isteğe bağlı bir operatör/eklenti profili olarak ekleyin.