Wordpress İle Özel Kısa Kod Geliştirme Nasıl Yapılır?

Ön Hazırlık ve Gereksinimler

Özel kısa kod geliştirmeye başlamadan önce, kodlarınızı nereye ekleyeceğinizi ve hangi araçlara ihtiyacınız olduğunu bilmeniz gerekir. WordPress üzerinde doğrudan çekirdek dosyaları düzenlemek yerine, her zaman güvenli yöntemleri tercih etmeliyiz.

• Aktif Bir WordPress Kurulumu: Yerel (LocalWP gibi) veya canlı bir sunucu ortamı.
• Kod Editörü: VS Code veya benzeri bir editör.
• Çocuk Tema (Child Theme) veya Eklenti: Kodlarınızı functions.php dosyasına veya özel bir eklenti klasörüne eklemelisiniz.
• PHP Bilgisi: Temel fonksiyon yapısı ve değişken kullanımı.

Kritik Uyarı: Asla ana temanızın functions.php dosyasını doğrudan düzenlemeyin. Tema güncellendiğinde tüm değişiklikleriniz silinecektir. Mutlaka bir çocuk tema oluşturun veya kodlarınızı "Code Snippets" gibi bir eklenti ya da kendi özel eklentiniz üzerinden yönetin.

Temel Kısa Kod Yapısı: İlk Adım

WordPress, kısa kodları tanımlamak için add_shortcode() fonksiyonunu kullanır. Bu fonksiyon iki parametre alır: kısa kodun adı ve çağrıldığında çalışacak olan geri çağırma (callback) fonksiyonu.

function basit_kisa_kod_fonksiyonu() {
    return "Merhaba, bu benim ilk özel kısa kodum!";
}
add_shortcode('selamla', 'basit_kisa_kod_fonksiyonu');

Bu kod bloğunu functions.php dosyanıza eklediğinizde, herhangi bir yazı veya sayfa editörüne [selamla] yazdığınızda, WordPress otomatik olarak bu metni ekrana basacaktır. Dikkat etmeniz gereken en önemli nokta, kısa kod fonksiyonlarının çıktı üretmek yerine her zaman return ile değer döndürmesi gerektiğidir.

Parametre Kullanımı ve Dinamik İçerik

Kısa kodların en güçlü yanı, kullanıcıdan gelen parametreleri işleyebilmeleridir. Örneğin, kullanıcıya özel bir karşılama mesajı oluşturmak için shortcode_atts() fonksiyonunu kullanırız. Bu fonksiyon, varsayılan değerleri belirlemenize ve kullanıcı tarafından girilen verileri güvenli bir şekilde işlemenize olanak tanır.

function ozellestirilmis_selamla($atts) {
    $a = shortcode_atts(array(
        'isim' => 'Ziyaretçi',
    ), $atts);

    return "Merhaba " . esc_html($a['isim']) . ", sitemize hoş geldin!";
}
add_shortcode('kisiye_ozel', 'ozellestirilmis_selamla');

Bu örnekte [kisiye_ozel isim="Ahmet"] şeklinde kullanım yaptığınızda, çıktı "Merhaba Ahmet, sitemize hoş geldin!" olacaktır. esc_html() fonksiyonu, XSS (Cross-Site Scripting) saldırılarını engellemek için kullanıcıdan gelen veriyi temizler.

İçerik Sarmalayıcı (Enclosing) Kısa Kodlar

Bazı kısa kodların, belirli bir içeriği sarmalaması gerekir. Örneğin, bir metni vurgulamak veya kutu içerisine almak için açılış ve kapanış etiketleri kullanırız. Bunun için fonksiyonunuza $content parametresini eklemeniz yeterlidir.

function kutu_icinde_goster($atts, $content = null) {
    return '
' . do_shortcode($content) . '
';
}
add_shortcode('kutu', 'kutu_icinde_goster');

Artık [kutu]Bu metin bir kutu içindedir.[/kutu] şeklinde bir kullanım yapabilirsiniz. do_shortcode($content) kullanımı, sarmalanan içerik içerisinde başka kısa kodların da çalışabilmesini sağlar.

Veritabanı Sorguları ve Kısa Kodlar

WordPress ile özel kısa kod geliştirme sürecinde, veritabanından veri çekmeniz gerekebilir. Ancak burada SQL injection riskine karşı çok dikkatli olmalısınız. Asla doğrudan kullanıcı verisini sorguya dahil etmeyin.

function son_yazilari_listele($atts) {
    $args = array(
        'posts_per_page' => 3,
        'orderby' => 'date'
    );
    $query = new WP_Query($args);
    $output = '
';
    
    if ($query->have_posts()) {
        while ($query->have_posts()) {
            $query->the_post();
            $output .= '
' . get_the_title() . '
';
        }
        wp_reset_postdata();
    }
    $output .= '
';
    return $output;
}
add_shortcode('son_yazilar', 'son_yazilari_listele');

Bu örnek, son 3 yazıyı listeleyen bir kısa kod üretir. wp_reset_postdata() kullanımı, küresel yazı verisinin bozulmaması için hayati öneme sahiptir.

Kısa Kod Yöntemleri Karşılaştırması

Güvenlik Sorumluluk Reddi: Kısa kodlarınızda kullandığınız tüm değişkenleri esc_html(), esc_url() veya sanitize_text_field() gibi WordPress güvenlik fonksiyonları ile temizlediğinizden emin olun. Aksi takdirde siteniz XSS saldırılarına açık hale gelebilir.

Sıkça Sorulan Sorular

Kısa kodlarım neden çalışmıyor?

Öncelikle fonksiyonun return değerini döndürdüğünden emin olun (echo kullanmayın). Ayrıca, add_shortcode fonksiyonunun doğru tetiklendiğini ve kodun functions.php içerisinde doğru yere yazıldığını kontrol edin.

Kısa kodun içine başka kısa kod koyabilir miyim?

Evet, do_shortcode() fonksiyonunu kullanarak iç içe kısa kod yapısını destekleyebilirsiniz. Ancak bu durumun performans üzerindeki etkisini göz önünde bulundurmalısınız.

Kısa kodlarımı bir eklenti olarak nasıl paketlerim?

Kodlarınızı ayrı bir PHP dosyasına alıp, dosyanın en üstüne eklenti başlık bilgilerini (Plugin Name, Description vb.) ekleyerek wp-content/plugins/ klasörüne yükleyebilirsiniz.

Kısa kodlar sayfa hızıma etki eder mi?

Eğer veritabanı sorgusu yapan ağır kısa kodlar kullanıyorsanız evet. Mümkün olduğunda sonuçları set_transient() ile önbelleğe alarak hız artışı sağlayabilirsiniz.

Kısa kod isimlendirmesinde nelere dikkat etmeliyim?

İsimlerin benzersiz olduğundan emin olun. Başka bir eklentiyle çakışmaması için kodlarınıza bir önek (prefix) ekleyin (örneğin: [kurumsal_iletisim]).

Kısa Kodlarda Hata Ayıklama ve Gelişmiş Hata Yönetimi

Kısa kodlarınız karmaşıklaştıkça, özellikle veritabanı sorguları veya dış API bağlantıları içeren işlemlerde hatalarla karşılaşma olasılığınız artar. Kullanıcıya doğrudan PHP hata mesajlarını göstermek hem güvenlik riski oluşturur hem de profesyonel bir kullanıcı deneyimi sunmaz. Bunun yerine, kısa kodlarınızda try-catch bloklarını kullanarak hataları yönetmeli ve gerekirse WordPress'in hata ayıklama günlüğüne (debug log) yazmalısınız.

Aşağıdaki örnekte, bir API'den veri çeken kısa kodun hata yönetimi ile nasıl korunacağını görebilirsiniz:

function ozel_api_verisi_kisa_kod($atts) {
    try {
        $data = wp_remote_get('https://api.ornek-servis.com/veri');
        
        if (is_wp_error($data)) {
            throw new Exception('Veri kaynağına ulaşılamadı.');
        }
        
        $body = wp_remote_retrieve_body($data);
        return '
' . esc_html($body) . '
';
        
    } catch (Exception $e) {
        if (defined('WP_DEBUG') && WP_DEBUG) {
            error_log('Kısa Kod Hatası: ' . $e->getMessage());
        }
        return '
Üzgünüz, içerik şu an yüklenemiyor.
';
    }
}
add_shortcode('api_icerik', 'ozel_api_verisi_kisa_kod');

Kısa Kod Performansını Artırmak İçin İleri Teknikler

Kısa kodlarınızın sayfa yüklenme süresine etkisini minimize etmek için "Lazy Loading" (tembel yükleme) mantığını benimseyebilirsiniz. Özellikle veritabanını yoğun kullanan kısa kodlarda, içeriğin sayfa ilk yüklendiğinde değil, ihtiyaç duyulduğunda veya AJAX ile yüklenmesini sağlamak büyük bir performans artışı sağlar.

AJAX Destekli Kısa Kod Yapısı

Bir kısa kodun içeriğini AJAX ile yüklemek için şu adımları izlemelisiniz:

1. Kısa kodun içine bir "placeholder" (yer tutucu) div yerleştirin.
2. JavaScript ile sayfa yüklendiğinde bir AJAX isteği tetikleyin.
3. WordPress'in wp_ajax_nopriv_ ve wp_ajax_ kancalarını kullanarak veriyi sunucudan çekin.

Bu yöntem, özellikle çok sayıda kısa kodun bulunduğu sayfaların "Time to First Byte" (TTFB) değerini önemli ölçüde iyileştirir. Ayrıca, kısa kodlarınızda ob_start() ve ob_get_clean() fonksiyonlarını kullanarak çıktı tamponlaması (output buffering) yapmanız, karmaşık HTML çıktılarını daha temiz yönetmenize olanak tanır.

Profesyonel İpucu: Eğer kısa kodunuz sadece belirli sayfalarda çalışıyorsa, has_shortcode() fonksiyonunu kullanarak kaynaklarınızı (CSS/JS) sadece ilgili sayfalarda yükleyin. Bu, sitenizin genel hızını korumak için kritik bir optimizasyondur.

// Sadece kısa kodun kullanıldığı sayfalarda stil yükle
function kisa_kod_stil_yukle() {
    global $post;
    if (is_a($post, 'WP_Post') && has_shortcode($post->post_content, 'ozel_galeri')) {
        wp_enqueue_style('galeri-stili', get_template_directory_uri() . '/css/galeri.css');
    }
}
add_action('wp_enqueue_scripts', 'kisa_kod_stil_yukle');

Sonuç

WordPress ile özel kısa kod geliştirme, sitenizi daha modüler ve yönetilebilir hale getirmenin en etkili yoludur. Bu rehberde öğrendiğiniz temel yapıları, parametre yönetimini ve güvenlik pratiklerini kullanarak kendi ihtiyaçlarınıza özel çözümler üretebilirsiniz. Bir sonraki adım olarak, veritabanı sorgularını önbelleğe alarak performans optimizasyonu yapmayı ve kısa kodlarınızı birer eklenti haline getirerek farklı projelerde kullanmayı deneyebilirsiniz.