WordPress sitenize özel kodlar eklemek istediğinizde doğrudan ana temanın functions.php dosyasını değiştirmek büyük bir risktir. Tema güncellemesi geldiğinde tüm eklediğiniz kodlar silinir. İşte bu noktada WordPress child theme (çocuk tema) oluşturma devreye girer. Bu rehberde, sıfırdan bir child theme nasıl kurulur, nelere dikkat edilmeli ve hangi kodlar güvenle eklenir adım adım anlatıyorum.
WordPress Child Theme Nedir, Neden Kullanmalısınız?
Child theme (çocuk tema), mevcut bir ana temanın (parent theme) tüm özelliklerini devralan, üzerine ekleme yapmanızı sağlayan bir WordPress temasıdır. Ana temaya dokunmadan CSS, PHP ve şablon değişiklikleri yapmanıza izin verir.
Child theme kullanmanın başlıca avantajları:
- Tema güncellemelerinde özel kodlarınız korunur
- Ana temayı güncel ve güvenli tutabilirsiniz
- Değişiklikleri geri almak kolaydır (child theme’i devre dışı bırakmanız yeterli)
- Canlı sitede güvenle test yapabilirsiniz
- Gelecekte tema değiştirseniz bile özel fonksiyonlarınızı taşıyabilirsiniz
Eğer daha önce WordPress güncellemesi sonrası siteniz bozulduysa, child theme kullanmaya başlamak için en doğru zamandasınız.
WordPress Child Theme Oluşturma: Adım Adım
1. Adım: Child Theme Klasörünü Oluşturun
WordPress kurulumunuzun /wp-content/themes/ klasörüne gidin ve yeni bir klasör açın. Adlandırma için genellikle ana tema adının sonuna -child eklenir. Örneğin ana temanız Astra ise klasör adını astra-child yapabilirsiniz.
2. Adım: style.css Dosyasını Oluşturun
Child theme’in en önemli dosyası style.css‘tir. Bu dosya WordPress’e child theme’in varlığını bildirir ve ana temayı tanımlar. Aşağıdaki içeriği kendi temanıza göre düzenleyerek kullanabilirsiniz:
/*
Theme Name: Astra Child
Theme URI: https://cagribolcal.com.tr
Description: Astra teması için child theme
Author: Çağrı Bolcal
Author URI: https://cagribolcal.com.tr
Template: astra
Version: 1.0.0
Text Domain: astra-child
*/Önemli: Template: satırı, ana temanın klasör adını tam olarak yazmalısınız (büyük-küçük harf duyarlı). Yanlış yazarsanız WordPress child theme’i tanımaz.
3. Adım: functions.php Dosyasını Oluşturun
Child theme’in functions.php dosyası, ana temanın fonksiyonlarını devralır ve üzerine yeni fonksiyonlar eklemenizi sağlar. En kritik nokta: ana temanın CSS ve JavaScript dosyalarını child theme üzerinden doğru şekilde yüklemektir.
Temel bir child theme functions.php dosyası şöyle görünür:
<?php
/**
* Astra Child Theme functions.php
*/
// Ana temanin CSSini kuyruga al
function astra_child_enqueue_styles() {
// Ana tema stylesheet
wp_enqueue_style(
'astra-parent-style',
get_template_directory_uri() . '/style.css'
);
// Child theme stylesheet (ana temadan sonra yuklenir)
wp_enqueue_style(
'astra-child-style',
get_stylesheet_directory_uri() . '/style.css',
['astra-parent-style'],
wp_get_theme()->get('Version')
);
}
add_action('wp_enqueue_scripts', 'astra_child_enqueue_styles');Bu kodu kendi temanıza göre uyarlamak için astra ifadelerini kullandığınız temanın adıyla değiştirin. Örneğin Hello Elementor için hello-elementor-child, Flatsome için flatsome-child şeklinde düzenleyebilirsiniz.
Child Theme’e Özel Kod Ekleme (PHP Snippetleri)
WordPress child theme oluşturma işleminin asıl amacı, güvenle özel kod ekleyebilmektir. İşte en çok kullanılan PHP snippetlerinden bazıları:
Örnek 1: WordPress Admin Paneline Özel CSS Ekleme
// Admin paneline ozel CSS ekle
function child_admin_styles() {
echo '<style>
#wpadminbar { background-color: #1d2327; }
.wp-menu-image img { opacity: 0.8; }
</style>';
}
add_action('admin_head', 'child_admin_styles');Örnek 2: WooCommerce Sepet Sayfasını Özelleştirme
E-ticaret sitenizde WooCommerce kullanıyorsanız, aşağıdaki kodla sepete eklenen ürünlerin yanında özel bir not alanı gösterebilirsiniz. Daha fazlası için WooCommerce checkout alan kaldırma yazısına da göz atabilirsiniz.
// Sepette urun adinin altina ekstra bilgi ekle
function child_cart_item_name($name, $cart_item, $cart_item_key) {
if (!empty($cart_item['variation'])) {
$name .= ' <small>(Varyasyonlu urun)</small>';
}
return $name;
}
add_filter('woocommerce_cart_item_name', 'child_cart_item_name', 10, 3);Child Theme’i Etkinleştirme ve Doğrulama
WordPress child theme oluşturma işlemini tamamladıktan sonra sıradaki adım etkinleştirmek:
- WordPress admin paneline gidin: Görünüm > Temalar
- Oluşturduğunuz child theme’i listede göreceksiniz (ör. “Astra Child”)
- Etkinleştir butonuna tıklayın
- Sitenizi gezerek her şeyin düzgün çalıştığını kontrol edin
Child theme etkinleştirildiğinde sitenizin görünümü ana temayla birebir aynı olmalıdır. Farklılık varsa style.css veya functions.php dosyasında hata olabilir. En sık yapılan hata Template: satırının yanlış yazılmasıdır.
Sık Yapılan Hatalar ve Çözümleri
Child Theme Görünmüyor veya Etkinleştirilemiyor
WordPress temalar sayfasında child theme’inizi göremiyorsanız:
- style.css dosyasının
Template:satırını kontrol edin. Ana temanın klasör adıyla birebir aynı olduğundan emin olun. - Child theme klasörünün
/wp-content/themes/altında olduğunu doğrulayın. - Ana temanın kurulu ve etkin durumda olup olmadığını kontrol edin.
CSS Değişiklikleri Uygulanmıyor
Child theme üzerinden CSS eklediğiniz halde değişiklikler görünmüyorsa:
- functions.php’de CSS dosyasının doğru sırada yüklendiğinden emin olun (ana tema stilinden sonra)
- Tarayıcı önbelleğini temizleyin veya Ctrl+F5 ile sayfayı yenileyin
- CSS kurallarınızda
!importantkullanmayı deneyin (geçici çözüm olarak)
PHP Kodları Çalışmıyor veya Beyaz Ekran Hatası
Bu durum genellikle PHP sözdizimi hatasından kaynaklanır. Çözüm için WordPress 500 Internal Server Error çözümü rehberine göz atabilirsiniz. Ayrıca:
- PHP açılış (
<?php) ve kapanış (?>) etiketlerini kontrol edin - Noktalı virgül (
;) eksikliği olup olmadığını inceleyin - Fonksiyon isimlerinde çakışma olmadığından emin olun
- Hata ayıklama için WordPress WP_DEBUG modunu aktif edin
Sonuç: Neden Her WordPress Kullanıcısı Child Theme Kullanmalı?
WordPress child theme oluşturma işlemini bu rehberde adım adım öğrendiniz. Özetle: bir klasör, iki dosya (style.css ve functions.php) ve birkaç dakikanızı alan bu yöntem, sitenizi tema güncellemelerine karşı korur ve özel kodlarınızı güvende tutar.
İster küçük bir CSS düzenlemesi yapın ister WooCommerce için kapsamlı PHP fonksiyonları ekleyin — child theme kullanmak profesyonel bir WordPress yaklaşımıdır. Sitenizde değişiklik yaparken her zaman child theme üzerinden çalışmayı alışkanlık haline getirin.
İhtiyacınız olan profesyonel web tasarım paketleri veya özel WordPress çözümleri için iletişim sayfasından bana ulaşabilirsiniz.