WordPress child theme (alt tema), etkin ana temanın görünümünü ve belirli şablonlarını doğrudan ana tema dosyalarını düzenlemeden özelleştirmenizi sağlar. Ana tema güncellendiğinde kendi eklediğiniz dosyalar ayrı klasörde kalır. Ancak “güncellemeler hiçbir şeyi bozamaz” anlamına gelmez; ana temanın HTML yapısı, stil adları veya şablon mantığı değişirse alt temayı yeniden test etmeniz gerekir. Bu rehberde alt temanın ne zaman gerekli olduğunu, klasik ve blok temalarda kurulum farklarını, CSS ile PHP dosyalarının nasıl çalıştığını ve güvenli yayın adımlarını bulacaksınız.
Child theme nedir?
Alt tema, bir ana temayı “Template” bağıyla işaret eden ayrı WordPress temasıdır. Ziyaretçi aktif alt temayı görür; WordPress gerekli yerlerde ana temanın özelliklerinden ve dosyalarından yararlanır. Alt temada aynı isimli uygun şablon dosyası varsa belirli şablonlarda onu kullanabilir. Böylece örneğin bir yazı sayfasının yerleşimini değiştirirken ana temanın bütün dosyalarını kopyalamanız gerekmez. Alt temanın functions.php dosyası ana temanın dosyasını geçersiz kılmaz; ikisi de yüklenir. Bu ayrım en sık yapılan hatalardan biridir.
Alt tema, bir eklenti veya WordPress çekirdek güncelleme aracı değildir. Site tasarımına bağlı özelleştirmeler için uygundur. Tema değişse de kalmasını istediğiniz işlevler genellikle ayrı bir eklentiye daha uygundur. Örneğin özel bir API entegrasyonu veya iş kuralı yalnızca aktif temanın functions.php dosyasına bağlıysa tema değişiminde kaybolabilir. Önce değişikliğin görünüm mü, bağımsız işlev mi olduğunu sınıflandırın.
Ne zaman alt tema kurmalısınız?
Ana tema dosyasına kalıcı CSS, PHP veya şablon değişikliği yapmanız gerekiyorsa alt tema güçlü bir seçenektir. Yalnızca birkaç renk ve yazı tipi ayarı yapacaksanız, mevcut temanın Site Düzenleyici veya görünüm ayarları yeterli olabilir. Blok temalarda theme.json, stil varyasyonları ve editör arayüzü pek çok özelleştirmeyi kod yazmadan sağlar. Kodla daha kapsamlı şablon değişikliği yapacağınızda alt tema düzenli bir sınır sunar. İşe başlamadan kullandığınız temanın klasik mi blok tema mı olduğunu öğrenin.
Kurulum öncesi kontrol listesi
Etkin ana temanın klasör adını, sürümünü ve lisans koşullarını kaydedin. Dosya ile veritabanı yedeğini alın. Bir staging ortamı varsa ilk denemeyi orada yapın. Yapacağınız değişikliğin hangi sayfalarda etkili olacağını belirleyin: ana sayfa, tekil yazı, arşiv, arama ve mobil düzen örnek olabilir. Ana tema güncellemesi bekleniyorsa önce güncellemenin değişiklik notlarını okuyun. Hazır alt tema paketi sunuluyorsa onun içeriğini de inceleyin; eski ve uyumsuz bir paket kullanmayın.
Gerekli klasör ve style.css
WordPress temaları wp-content/themes/ altında bulunur. Ana temadan ayrı, açıklayıcı bir klasör oluşturun. Bu klasördeki style.css başlığında Theme Name ve Template alanları bulunmalıdır. Template değeri, ana temanın görünen adı değil tam klasör adıdır ve büyük küçük harf farkı önem taşıyabilir. Örnek olarak ana tema klasörü ornek-tema ise alan da bunu göstermelidir. Gerçek kurulumda kendi tema klasörünüzü yazın.
/*
Theme Name: Örnek Tema Alt Teması
Template: ornek-tema
Version: 1.0.0
*/Bu kısa başlık WordPress’in ilişkiyi kurmasına yardım eder. Ana tema yoksa veya klasör adı yanlışsa alt tema beklenen biçimde yüklenmez. Sadece klasör oluşturmak temayı etkinleştirmez; WordPress yönetimindeki Görünüm ekranında yeni temayı görüp önizleyin. Dosya düzenleme işlemini canlı sitede yapıyorsanız sözdizimi hatasının sayfayı bozma ihtimalini hesaba katın. Önce staging ve yedek kullanmak daha kontrollüdür.
Klasik temada CSS nasıl yüklenir?
Alt tema style.css dosyasının yüklenme davranışı ana temanın koduna bağlıdır. WordPress Tema El Kitabı, önce ana temanın hangi stil dosyalarını sıraya aldığını incelemeyi önerir. Bazı ana temalar aktif temanın stilini otomatik yükler; ek kod gerekmez. Bazıları yalnızca kendi stilini yükler ve alt temanın stilini ayrıca sıraya almak gerekir. Ana temanın veya alt temanın stilini iki kez yüklemek gereksiz istek ve sıra hatası doğurabilir. Bu nedenle internetteki “her child theme’e aynı functions.php kodunu yapıştır” yaklaşımı güvenilir değildir.
Alt temanın CSS dosyası yüklenmiyorsa, doğru kancada wp_enqueue_style() ile eklenebilir. Aşağıdaki örnek yalnızca alt tema stilini sıraya alır; ana temanın zaten kendi stilini yüklediği durum için düşünülmüştür. Önce sayfa kaynağında yüklenen CSS dosyalarını kontrol edin. Dosya yolunu dinamik veren get_stylesheet_uri() aktif temanın stil adresini döndürür.
<?php
add_action( 'wp_enqueue_scripts', 'ornek_alt_tema_stilini_yukle' );
function ornek_alt_tema_stilini_yukle() {
wp_enqueue_style( 'ornek-alt-tema', get_stylesheet_uri() );
}Bu kodu alt temanın functions.php dosyasına koyduğunuzda işlev adını özgün seçin. PHP dosyasında açılış etiketi ve sözdizimi doğru olmalıdır. Ana tema aktif temanın CSS adresini zaten yüklemişse bu ikinci kayıt çakışma yaratabilir; önceki denetim bu yüzden önemlidir. Ana tema yalnızca alt stil adresini yükleyip kendi stilini atlıyorsa ebeveyn stilini de uygun bağımlılıkla eklemek gerekebilir. Her temanın kaynak sırası aynı değildir; canlı HTML ve tarayıcı ağ paneliyle gerçek sonucu ölçün.
Blok temada theme.json ve stil farkı
Blok temalarda renk, boşluk, tipografi ve blok varsayılanları çoğunlukla theme.json üzerinden tanımlanır. Bu yüzden klasik temadaki gibi her değişiklik için style.css yüklemek gerekmeyebilir. Alt tema kendi theme.json dosyasında ihtiyaç duyduğu ayarları tanımlayabilir. Ancak ana temanın sürümü ve WordPress’in desteklediği şema sürümü önemlidir. Bir değerin editörde görünmesi, ön yüzdeki bütün şablonlarda beklenen sonucu verdiği anlamına gelmez. Site Düzenleyici’deki kullanıcı özelleştirmeleri de dosya ayarlarının üstüne gelebilir; farkları test edin.
Blok temada şablonlar çoğunlukla HTML dosyalarıdır ve görünüm arayüzünden de düzenlenebilir. Klasik temada PHP şablonları daha belirgindir. Hangi dosyayı kopyalayacağınıza karar vermeden ana temanın mimarisini inceleyin. Klasik temaya ait single.php örneğini bir blok temaya birebir uygulamak doğru olmayabilir. WordPress Tema El Kitabı alt temanın şablon, şablon parçası ve desenleri nasıl genişletebildiğini açıklar. Bir özelleştirmeyi dosyada mı arayüzde mi tutacağınızı ekip iş akışına göre belirleyin.
functions.php neden kopyalanmamalı?
Alt temanın functions.php dosyası ana temanın dosyasından önce yüklenir; ana temanın işlevlerini silip yerine geçmez. Ana temadaki bütün dosyayı alt temaya kopyalarsanız aynı fonksiyon adını iki kez tanımlayıp ölümcül PHP hatası oluşturabilirsiniz. İhtiyaç duyduğunuz yeni davranışı kanca, filtre veya belgelenmiş genişletme noktasıyla ekleyin. Ana temanın işlevi koşullu tanımlanmamışsa doğrudan yeniden tanımlamak mümkün olmayabilir. Kodun tema güncellemesinden sonra da çalışıp çalışmadığını kontrol edin.
Şablon dosyası ne zaman kopyalanır?
Bir sayfa düzeni ana temanın sunduğu seçeneklerle değiştirilemiyorsa ilgili şablon alt temaya kopyalanabilir. Kopyayı ana temadaki göreli klasör düzenine uygun yerleştirin ve yalnızca gerekli satırları değiştirin. Ana temanın bütün dosyalarını kopyalamak, güncellemelerde bakım yükünü büyütür. Kopyaladığınız şablon, ana tema güncellense bile eski sürümde kalabilir. Bu nedenle dosya adını, alındığı ana tema sürümünü ve neden değiştirildiğini not edin. WooCommerce şablonları gibi eklentiye bağlı dosyalarda uyumluluk uyarılarını da izleyin.
Şablonun görsel olarak doğru görünmesi yeterli değildir. Başlık hiyerarşisi, erişilebilirlik etiketleri, yapılandırılmış veri, reklam alanları ve yorum formu gibi parçalar da etkilenebilir. Yeni dosyayı yalnızca ana sayfada değil temsil ettiği içerik türlerinde test edin. Birden fazla şablon kopyası aynı içeriğe aday olabiliyorsa WordPress’in şablon hiyerarşisini inceleyin. Kod kalitesini sürüm kontrolünde değişiklik olarak tutmak, güncelleme sonrası fark karşılaştırmasını kolaylaştırır.
Alt tema nasıl etkinleştirilir?
Dosyaları hazırladıktan sonra WordPress panelinde Görünüm > Temalar ekranını açın. Alt temanın adını ve bağlı ana temayı doğrulayın. Varsa canlı önizleme ile menü, üst alan, yazı şablonu ve mobil görünümü kontrol edin. Ardından staging ortamında etkinleştirin. Canlı sitede temayı değiştirmek görünümü anında etkiler; bu nedenle düşük trafik zamanı ve geri dönüş planı seçin. Etkinleştirme sonrasında menü konumları, bileşen alanları veya tema seçenekleri değişebilir. Önceki tema ayarlarını ve yeni ekranda görünen değerleri karşılaştırın.
Alt tema dosyalarını ZIP olarak yüklemek de mümkündür; paket kökünde doğru tema klasör yapısı ve style.css bulunmalıdır. Rastgele bir indirme sitesinden alınan hazır ZIP’i üretim ortamına yüklemeyin. Ana tema geliştiricisinin sunduğu paket varsa sürüm uyumunu kontrol edin. Elle dosya kopyalıyorsanız sunucudaki izinler ve sahiplik kuralları hosting ayarlarına bağlıdır; yanlış izin vermek yerine sağlayıcının önerisini izleyin. Temayı etkinleştirmeden önce ana temanın sunucuda kurulu olduğundan emin olun.
Güncelleme yapınca ne olur?
Ana tema güncellenirken ana temanın klasöründeki dosyalar değişir; alt tema klasörü genellikle olduğu gibi kalır. Bu özellik özelleştirmeleri korur, fakat eski kopya şablonları otomatik güncellemez. Ana tema geliştiricisi sınıf adı, HTML yapısı veya kanca değiştirirse alt tema CSS’i ve PHP kodu bozulabilir. Güncelleme notlarını okuyun, staging’de güncelleyin ve önceki görünüme karşı test yapın. Kırılan değişikliği bulmak için alt tema dosyalarıyla yeni ana tema dosyalarını karşılaştırın; gerekli düzeltmeyi alt temaya uygulayın.
Alt tema güvenlik güncellemelerini engeller mi?
Alt tema kullanmak ana temayı güncelleme gereğini ortadan kaldırmaz. Ana tema kodu çalışmaya devam eder ve eski sürümlerdeki sorunlar etkili olabilir. Alt temaya kopyalanmış eski bir şablon da kendi bakım sorumluluğunu taşır. WordPress çekirdeği, tema ve eklentiler için güncelleme planı yapın. Her güncellemede yedek, staging testi, canlı doğrulama ve gerekirse geri dönüş yolunu hazırlayın. “Alt tema var, dolayısıyla güncelleme güvenli” çıkarımı doğru değildir.
Yayın ve bakım için kontrol listesi
Alt tema dosyalarının yedeği ve sürüm geçmişi var mı? Template alanı doğru klasöre işaret ediyor mu? Ana tema kurulu ve güncel mi? Alt tema stil dosyası gerçekten bir kez yükleniyor mu? functions.php içinde ad çakışması var mı? Kopyalanan her şablonun kaynağı ve sürümü not edildi mi? Masaüstü ve mobilde ana sayfa, tekil yazı ve arşiv açılıyor mu? Menü, form, reklam alanı, paylaşım ve yorum akışları çalışıyor mu? Bunları staging ortamında işaretleyip sonra canlıya uygulayın.
Canlıya taşıma sonrası tarayıcı önbelleğini ve gerekiyorsa CDN önbelleğini kontrollü temizleyin. Görsel değişiklikler hâlâ görünmüyorsa ilgili CSS dosyasının gerçek URL’sini açıp sürümü inceleyin. Güncellemeden sonra temanın lisans veya ayar ekranı farklı davranıyorsa sağlayıcının resmi belgelerine bakın. Ekip içinde kimin şablonları değiştireceğini belirlemek, aynı dosyanın panelden ve sunucudan farklı sürümlerde düzenlenmesini önler. Büyük sitelerde değişiklikleri sürüm kontrolünden geçirmek hata ayıklamayı kolaylaştırır.
Alt temayı kullanmayı bırakmak isterseniz önce hangi özelleştirmelerin yalnızca bu klasörde olduğunu listeleyin. Ana temaya dönmek bu kodları ve şablonları göstermeyecektir; içerik verisi genellikle ayrı kalsa da yerleşim ve özel alan gösterimi değişebilir. Önizleme ve yedekle geçiş yapın. Böylece alt tema, unutulmuş dosyalarla dolu bir kopya değil, amacı ve bakım sorumlusu belli bir özelleştirme katmanı olarak kalır.
Karar verirken ana temanın geliştiricisinin sağladığı kanca ve belgeleri de inceleyin. Resmî genişletme noktası varsa büyük şablon kopyasından daha az bakım gerektirebilir. Her değişiklik için önce en küçük uygulanabilir yolu seçip sonucu gerçek sayfalarda doğrulayın.
Yaygın hatalar ve çözümleri
Alt tema görünmüyor: style.css başlığını, klasör düzenini ve Template değerini kontrol edin. Stiller uygulanmıyor: tarayıcı kaynaklarında CSS dosyasının yüklenip yüklenmediğine, önbelleğe ve seçicilerin önceliğine bakın. Beyaz ekran veya kritik hata: son eklenen PHP kodunda sözdizimi ya da fonksiyon adı çakışması olabilir; hosting hata günlüğünü okuyup yedekten geri dönün. Şablon değişmiyor: dosya adının ve konumunun ana temayla aynı olduğundan, ayrıca editörde kaydedilmiş farklı bir şablonun baskın olmadığından emin olun.
Güncellemeden sonra düzen bozuldu: ana temanın değişiklik notlarını inceleyin, kopyalanmış eski şablon ile yeni dosyayı karşılaştırın. Menü kayboldu: menü konumu eşlemesini kontrol edin; menü içeriği silinmemiş olabilir. Görseller yanlış boyutlanıyor: CSS, tema görsel boyutları ve medya çıktısını birlikte inceleyin. Sorunu görmeden rastgele önbellek temizliği veya eklenti devre dışı bırakma işlemlerine güvenmeyin. Her denemeden sonra etkilenen sayfayı ve değişen dosyayı kaydedin.
Çocuk tema, ek CSS ve özel eklenti karşılaştırması
Yalnızca küçük görsel dokunuşlar için WordPress’in ek CSS veya blok tema stil ayarları yeterli olabilir. Bu ayarlar panelden yönetilir; tema değiştiğinde davranışları ayrıca kontrol edilmelidir. Şablon dosyası ve tema düzeyinde kod için alt tema uygundur. Tema bağımsız işlev, veri türü veya API entegrasyonu için özel eklenti daha doğru sınır olabilir. Bir projede bu yollar birlikte kullanılabilir. Seçim bakım sorumluluğunu ve güncelleme etkisini açık tutmalıdır; her CSS satırı için ayrı alt tema kurma zorunluluğu yoktur.
Performans ve SEO etkisi
Alt tema kullanmak kendiliğinden siteyi hızlandırmaz veya arama sırasını yükseltmez. Gereksiz çift CSS yükleme, ağır JavaScript ve şablon hataları performansı olumsuz etkileyebilir. Başlık yapısını veya canonical işaretini değiştiren şablon kopyası SEO çıktısını bozabilir. Bu nedenle değişiklik sonrası canlı HTML’de sayfa başlığı, meta, bağlantılar, görseller ve mobil düzeni kontrol edin. Önceki ve yeni sürüm için aynı sayfada ölçüm yapmak daha anlamlıdır. Alt temanın varlığı değil, uygulanan kodun niteliği sonucu belirler.
Örnek proje: yazı sayfası özelleştirmesi
Bir yayın sitesi yazı başlığının altına kısa bir açıklama alanı eklemek ve başlık rengini değiştirmek istiyor. Önce temanın yerleşik ayarlarına bakın. Başlık rengi editör arayüzünden ayarlanabiliyorsa dosya eklemeyin. Açıklama için kanca veya şablon parçası imkânı varsa onu kullanın. Şablon kopyası gerekiyorsa yalnızca ilgili dosyayı alt temaya alın. Değişikliği staging’de farklı kategorilerdeki yazılarda test edin; başlıksız görsel, uzun başlık ve mobil ekrana da bakın. Ana tema güncellemesinden sonra bu özel sayfaları yeniden kontrol etmek üzere bir not bırakın.
Sık sorulan sorular
Alt tema olmadan ana tema dosyasını değiştirebilir miyim?
Teknik olarak mümkün olsa da ana tema güncellemesi değişiklikleri üzerine yazabilir. Güncelleme ve bakım için özelleştirmeleri ayrı yerde tutmak daha sağlıklıdır. Hangi yolun uygun olduğu yapılan değişikliğe bağlıdır.
functions.php ana temadaki dosyanın yerine geçer mi?
Hayır. İki dosya da yüklenir. Aynı isimde fonksiyon tanımlamak hata oluşturabilir; kanca ve özgün adlarla genişletme yapın.
Blok temada alt tema zorunlu mu?
Hayır. theme.json ve Site Düzenleyici pek çok tasarım ayarı sunar. Dosya düzeyinde kalıcı şablon ve kod değişikliği gerekiyorsa alt tema değerlendirilir.
Kaynaklar ve ileri okuma
