Wordpress İle Özel Bir Kullanıcı Avatar Yükleme Sistemi Nasıl Yapılır?

Gereksinimler ve Ön Hazırlık

Sistemi kurmaya başlamadan önce geliştirme ortamınızın güncel olduğundan emin olmalısınız. WordPress 6.0 ve üzeri sürümler, modern dosya yükleme kütüphaneleriyle tam uyumludur.

• PHP 8.1 veya üzeri: Performans ve güvenlik güncellemeleri için gereklidir.
• WordPress 6.x: Temel API fonksiyonları için güncel sürüm.
• Child Theme (Alt Tema): Değişikliklerin ana tema güncellemelerinden etkilenmemesi için zorunludur.
• Temel Bilgi: PHP sözdizimi, WordPress Hooks (kanca) yapısı ve temel HTML/CSS bilgisi.

Adım 1: Kullanıcı Profiline Avatar Alanı Ekleme

İlk adım, WordPress kullanıcı profili düzenleme sayfasına yeni bir dosya yükleme alanı eklemektir. Bunun için show_user_profile ve edit_user_profile kancalarını kullanacağız.

add_action('show_user_profile', 'ozel_avatar_alanini_goster');
add_action('edit_user_profile', 'ozel_avatar_alanini_goster');

function ozel_avatar_alanini_goster($user) {
    $avatar_url = get_user_meta($user->ID, 'ozel_avatar', true);
    ?>
    
Özel Avatar Ayarları
    

        

            
Profil Fotoğrafı
            

                
                
            
        
    


Adım 2: Yüklenen Görselin Sunucuya Kaydedilmesi

Profil alanına eklediğimiz dosya seçiciyi işlevsel hale getirmek için, kullanıcının profilini güncellediğinde çalışacak bir personal_options_update ve edit_user_profile_update kancasına ihtiyacımız var. Bu fonksiyon, yüklenen dosyayı WordPress'in medya kütüphanesine kaydedecek ve URL'sini kullanıcı meta verisi olarak saklayacaktır.

add_action('personal_options_update', 'ozel_avatar_kaydet');
add_action('edit_user_profile_update', 'ozel_avatar_kaydet');

function ozel_avatar_kaydet($user_id) {
    if (!current_user_can('edit_user', $user_id)) {
        return false;
    }

    if (!empty($_FILES['ozel_avatar']['name'])) {
        $uploaded_file = $_FILES['ozel_avatar'];
        $upload_overrides = array('test_form' => false);
        
        $movefile = wp_handle_upload($uploaded_file, $upload_overrides);

        if ($movefile && !isset($movefile['error'])) {
            update_user_meta($user_id, 'ozel_avatar', $movefile['url']);
        } else {
            wp_die('Dosya yüklenirken bir hata oluştu: ' . $movefile['error']);
        }
    }
}






Performans ve Güvenlik İpuçları

Özel avatar sistemini canlıya alırken dikkat etmeniz gereken en önemli konu, kullanıcıların yüklediği dosyaların boyutudur. Sunucu kaynaklarını korumak ve sayfa yüklenme hızını optimize etmek için yükleme öncesi doğrulama yapılması kritiktir.


    
Dosya Tipi Kontrolü: Sadece image/jpeg, image/png ve image/webp formatlarına izin verin.
    
Dosya Boyutu Sınırı: Kullanıcıların çok yüksek çözünürlüklü görseller yüklemesini engellemek için wp_handle_upload öncesi $_FILES['ozel_avatar']['size'] kontrolü yapın.
    
Görsel Sıkıştırma: Yüklenen görselleri sunucuda işleyerek otomatik olarak yeniden boyutlandırmak (thumbnail oluşturmak) için wp_generate_attachment_metadata fonksiyonunu kullanmayı değerlendirin.


Hata Ayıklama (Debugging)

Sistemin düzgün çalışıp çalışmadığını anlamak için WordPress'in hata ayıklama modunu aktif edebilirsiniz. Eğer görsel veritabanına yazılmıyorsa, wp-config.php dosyanızda WP_DEBUG değerini true yaparak işlemleri loglayabilirsiniz.

// Hata ayıklama için geçici loglama
if (isset($movefile['error'])) {
    error_log('Avatar Yükleme Hatası: ' . $movefile['error']);
}






Özel Avatarı Ön Yüzde Görüntüleme

Sistemin son halkası, kaydedilen bu URL'yi WordPress'in standart get_avatar filtresi ile birleştirmektir. Böylece temanızın herhangi bir yerinde get_avatar() fonksiyonu çağrıldığında, WordPress otomatik olarak kullanıcının kendi yüklediği özel fotoğrafı çekecektir.

add_filter('get_avatar', 'ozel_avatar_filtresi', 10, 5);

function ozel_avatar_filtresi($avatar, $id_or_email, $size, $default, $alt) {
    $user_id = 0;
    if (is_numeric($id_or_email)) {
        $user_id = $id_or_email;
    } elseif (is_object($id_or_email)) {
        $user_id = $id_or_email->user_id;
    }

    $ozel_avatar_url = get_user_meta($user_id, 'ozel_avatar', true);

    if ($ozel_avatar_url) {
        $avatar = "
";
    }

    return $avatar;
}