Kurumsal CMS Migrasyonu: Sitecore'dan WordPress Blok Düzenleyiciye Geçiş ve Modern Mimari Rehberi

Kurumsal ölçekteki organizasyonlar için içerik yönetim sistemi (CMS) altyapısını modernize etmek, sadece bir yazılım güncellemesi değil; şirket içi iş akışlarını, operasyonel çevikliği ve teknik arama motoru optimizasyonunu (Teknik SEO) doğrudan etkileyen kritik bir mimari dönüşümdür. Uzun yıllar boyunca Sitecore, Adobe Experience Manager (AEM) veya eski Drupal sürümleri gibi monolitik sistemlerde kilitli kalan devasa içerik arşivlerini modern WordPress blok ekosistemine taşımak, yüksek mühendislik disiplini ve hassas bir veri stratejisi gerektirir.

Human Made ve sektörün önde gelen kurumsal WordPress danışmanlarının pratikleri, bu ölçekteki migrasyonların artık kontrolsüz özel blok (custom block) üretiminden ziyade, Core blokların kabiliyetleri ve gelişmiş Blok Kalıpları (Block Patterns) etrafında şekillendiğini gösteriyor. Bu teknik rehberde, kurumsal içerik migrasyonlarının perde arkasını, veri yapılandırma zorluklarını, blok grameri dönüşümünü ve SEO kazanımlarını derinlemesine inceliyoruz.

Monolitik Mirastan Blok Düzenleyiciye: Değişen Paradigma

Sitecore gibi sistemlerde içerik, genellikle son derece katı bileşen hiyerarşileri veya tam aksine kontrolsüzce şişmiş zengin metin (Rich Text/WYSIWYG) alanları içinde depolanır. Bu durum iki temel uç sorun yaratır:

1. Aşırı Katılık: Pazarlama ekipleri her yeni sayfa düzeninde yazılım ekibine bağımlı hale gelir.
2. Veri Kirliliği: Zengin metin editörleri zamanla iç içe geçmiş satır içi (inline) stiller, kırık HTML etiketleri ve uyumsuz medya gömmeleriyle dolar.

WordPress Blok Düzenleyici (Gutenberg) ise içeriği HTML yorum satırları (<!-- wp:block -->) içine yerleştirilmiş JSON nitelikleri (attributes) olarak depolar. Bu yapı, hem semantik ve temiz HTML çıktısı üretilmesini sağlar hem de veriyi soyut bir sözdizimi ağacı (AST - Abstract Syntax Tree) gibi işlenebilir kılar.

"Kurumsal migrasyonlarda zanaatkar dokunuşu (artisanal care), her bir içerik parçasının anlamsal değerini korumak; kurumsal verimlilik (enterprise efficiency) ise binlerce karmaşık şablonu insan hatasından arındırılmış algoritmik boru hatlarıyla (pipelines) dönüştürmektir."

Özel Bloklar Yerine Neden Blok Kalıpları (Patterns)?

Geçmişte React tabanlı özel ACF Blokları veya yerel Gutenberg blokları yazmak ilk tercih olarak görülüyordu. Ancak yüzlerce özel blok geliştirmek, uzun vadede teknik borç, bakım maliyetleri ve çekirdek WordPress güncellemelerinde uyumsuzluk riskini beraberinde getirir. Güncel kurumsal yaklaşım; Çekirdek Blokları (Core Blocks), Global Stilleri (theme.json) ve Blok Kalıplarını (Patterns) bir araya getirerek bir tasarım sistemi inşa etmektir.

Veri Ayrıştırma ve Dönüştürme Mimarisi

Eski CMS veritabanından alınan ham içerik doğrudan WordPress'e aktarılamaz. Başarılı bir kurumsal migrasyon boru hattı, içeriği HTML ayrıştırıcılar (DOM parsers) yardımıyla düğüm düğüm işleyerek eşdeğer Gutenberg blok yorumlarına dönüştürmelidir.

Örnek Migrasyon Scripti: HTML Bileşeninden Gutenberg Bloklarına

Aşağıdaki PHP fonksiyonu, eski CMS'ten gelen özel bir "Callout/Teaser Box" HTML yapısını semantik bir core/group ve core/heading blok kalıbına programatik olarak dönüştürme mantığını sergilemektedir:

<?php
/**
 * Eski CMS HTML bileşenini WordPress Gutenberg Blok Gramerine dönüştürür.
 */
function transform_legacy_callout_to_gutenberg( string $legacy_html ): string {
    $dom = new DOMDocument();
    // UTF-8 karakter desteği ve hataları sessize alma
    libxml_use_internal_errors(true);
    $dom->loadHTML(mb_convert_encoding($legacy_html, 'HTML-ENTITIES', 'UTF-8'));
    libxml_clear_errors();

    $xpath = new DOMXPath($dom);
    $callouts = $xpath->query("//div[contains(@class, 'legacy-callout')]");

    foreach ($callouts as $callout) {
        $titleNode = $xpath->query(".//h3", $callout)->item(0);
        $textNode  = $xpath->query(".//p", $callout)->item(0);

        $title = $titleNode ? trim($titleNode->nodeValue) : '';
        $text  = $textNode ? trim($textNode->nodeValue) : '';

        // Gutenberg blok yapısının JSON ve HTML yorumları ile inşası
        $block_content  = '<!-- wp:group {"style":{"spacing":{"padding":{"top":"var:preset|spacing|40","bottom":"var:preset|spacing|40"}}},"backgroundColor":"light-gray","layout":{"type":"constrained"}} -->';
        $block_content .= '<div class="wp-block-group has-light-gray-background-color has-background" style="padding-top:var(--wp--preset--spacing--40);padding-bottom:var(--wp--preset--spacing--40)">';
        
        if ( ! empty( $title ) ) {
            $block_content .= '<!-- wp:heading {"level":3} -->';
            $block_content .= '<h3 class="wp-block-heading">' . esc_html( $title ) . '</h3>';
            $block_content .= '<!-- /wp:heading -->';
        }

        if ( ! empty( $text ) ) {
            $block_content .= '<!-- wp:paragraph -->';
            $block_content .= '<p>' . esc_html( $text ) . '</p>';
            $block_content .= '<!-- /wp:paragraph -->';
        }

        $block_content .= '</div>';
        $block_content .= '<!-- /wp:group -->';

        // Dönüştürülen blok metnini eski düğümün yerine yaz
        $fragment = $dom->createDocumentFragment();
        $fragment->appendXML($block_content);
        $callout->parentNode->replaceChild($fragment, $callout);
    }

    return $dom->saveHTML();
}

Teknik SEO ve Core Web Vitals Etkisi

Sitecore veya benzeri kurumsal CMS mimarilerinde genellikle aşırı DOM derinliği (DOM depth), istemci taraflı ağır JavaScript bağımlılıkları ve verimsiz CSS enjeksiyonları bulunur. Gutenberg bloklarına geçiş, doğrudan arama motoru optimizasyonu metriklerini yukarı taşır:

• DOM Düğüm Sayısının Azaltılması: Gutenberg çekirdek blokları temiz çıktılar sunarak aşırı div katmanlarını (div soup) engeller. Bu, Googlebot'un tarama bütçesini verimli kullanmasını sağlar ve Cumulative Layout Shift (CLS) riskini minimize eder.
• Modern Görsel Yüklemesi: WordPress Core Blokları, otomatik olarak srcset, sizes ve yerel loading="lazy" niteliklerini ekler. Largest Contentful Paint (LCP) skoru hissedilir derecede iyileşir.
• Semantik Hiyerarşi: Özel tasarlanmış Blok Kalıpları, editörlerin sayfa yapısını bozmasını engeller. Başlık etiketlerinin (H1, H2, H3) hiyerarşik tutarlılığı garanti altına alınır.
• Schema.org Entegrasyonu: Blok verileri JSON yapısında saklandığı için, migrasyon boru hattında bloklara özel yapısal veriler (FAQPage, HowTo, Article) şematik olarak kolaylıkla enjekte edilebilir.

Kaynak: WP Tavern - https://wptavern.com/podcast/234-k-adam-white-on-migrating-to-blocks-with-artisanal-care-and-enterprise-efficiency