set_post_thumbnail_size( int $genişlik, int $yükseklik, bool|array $kırpılsın = false )

Açıklaması:

Bu fonksiyon, add_image_size() fonksiyonunun özel bir halidir. Temamızdaki resimlerde kullanılmak üzere, ismi 'post-thumbnail' olan bir en-boy değeri kaydeder. Yani bu fonksiyon ile oluşturulan en-boy değerini gerektiğinde, 'post-thumbnail' ismi ile çağırılmalıdır.

Parametreleri:

$genişlik

(int) Resmin pixel cinsinden genişlik değeridir. Varsayılan değeri 0 olarak ayarlanmıştır.

$yükseklik

(int) Resmin pixel cinsinden yükseklik değeridir. Varsayılan değeri 0 olarak ayarlanmıştır.

$kırpılsın

(bool|array) Resmi yeniden boyutlandırırken kırpma işleminin yapılıp yapılmayacağını, yapılacaksa nasıl yapılacağını belirleyen parametredir.

Add_image_size() fonksiyonunun bu parametrenin değerine göre davranışı şöyle olur:

1. False değeri varsayılan değerdir ve bu değerde, resim kırpılmaz.

2. Argümanın değeri, kırpmanın başlayacağı noktanın koordinatlarını veren bir dizi şeklinde olursa, bu dizi şu formatta olmalıdır:

array('x_crop_position','y_crop_position')

'x_crop_position' : Kırpmanın başlayacağı noktanın yatay koordinatıdır. ‘left’, ‘center’ veya ‘right’değerlerini alır. Bu değerler sırasıyla; “sol”, “merkez” ve “sağ” anlamına gelir.

'y_crop_position' : Kırpmanın başlayacağı noktanın dikey koordinatıdır.  ‘top’, ‘center’ veya ‘bottom’değerlerini alır. Bu değerler sırasıyla; “üst”, “merkez” ve “alt” anlamına gelir.

3. True değeri verilirse, resim, merkez koordinatları ile kırpılır.

WordPress, bir ortam yükleyicisi ile bir resim yüklediğinizde, resmi kaydederken, bu fonksiyonda belirtilen boyutları ile de kaydeder. Bu yüzden, set_post_thumbnail_size() fonksiyonu kullanılmadan önce yüklenen resimler, tam olarak bu fonksiyonda belirtilen boyutlarla gelmeyebilir.

Döndürdüğü değer:

Fonksiyon herhangi bir değer döndürmez.

Kaynak kodu:

Dizini: wp-includes/media.php

function set_post_thumbnail_size( $width = 0, $height = 0, $crop = false ) {
    add_image_size( 'post-thumbnail', $width, $height, $crop );
}

Kullanımı:

Set_post_thumbnail_size() fonksiyonunu, functions.php dosyasında kullanmak için, önce, bu fonksiyonu içine alan başka bir fonksiyon oluşturmak sonra da oluşturulan bu fonksiyonu 'after_setup_theme' kancası ile çağırmak gerekir.

Aşağıda verilen örneklerden, Örnek-1‘de set_post_thumbnail_size() fonksiyonunun, functions.php dosyasındaki kullanımını göreceksiniz.

Örnek-1

Aşağıdaki kod, temanıza önce öne çıkan görsel özelliği ekler, daha sonra da öne çıkan görselleriniz için bir en-boy değeri oluşturur:

function ilktemam_setup_theme() {
    add_theme_support( 'post-thumbnails' );
    set_post_thumbnail_size( 160, 150 );
}
add_action( 'after_setup_theme', 'ilktemam_setup_theme' );

Bu kod ile, 160 pixel genişliğinde, 150 pixel yüksekliğinde ve adı 'post-thumbnail' olan bir en-boy değeri oluşturur.

Bu kod eklendikten sonra, WordPress, yönetim panelindeki ortam yükleyici ile yüklenen her bir resim için, bu boyutlarda bir örnek daha oluşturur.

Örnek-2

Aşağıdaki örnek, 60 pixel genişliğinde, 50 pixel yüksekliğinde ve adı 'post-thumbnail' olan bir en-boy değeri oluşturur.

set_post_thumbnail_size( 60, 50 );

Bu kod eklendikten sonra, WordPress, yönetim panelindeki ortam yükleyici ile yüklenen her bir resim için, bu boyutlarda bir örnek daha oluşturur.

Örnek-3

Aşağıdaki örnek, 60 pixel genişliğinde, 50 pixel yüksekliğinde, resmin merkezinden itibaren kırpılarak oluşturulan ve adı 'post-thumbnail' olan bir en-boy değeri oluşturur.

set_post_thumbnail_size( 60, 50, true );

Bu kod eklendikten sonra, WordPress, yönetim panelindeki ortam yükleyici ile yüklenen her bir resim için, bu boyutlarda bir örnek daha oluşturur.

Örnek-4

Aşağıdaki örnek, 60 pixel genişliğinde, 50 pixel yüksekliğinde, resmin üst sol köşesinden itibaren kırpılarak oluşturulan ve adı 'post-thumbnail' olan bir en-boy değeri oluşturur.

set_post_thumbnail_size( 60, 50, array( 'top', 'left')  );

Bu kod eklendikten sonra, WordPress, yönetim panelindeki ortam yükleyici ile yüklenen her bir resim için, bu boyutlarda bir örnek daha oluşturur.