wp_get_attachment_image_src( int $resim_dosyasının_id_değeri, string|array $boyutları = 'thumbnail', bool $icon = false )

Açıklaması:

Bir resmin; URL değeri, genişliği, yüksekliği ve ikon özelliği bilgilerini bir dizi halinde getirir. Resimler için oluşturmak istediğimiz HTML elemanlarında bu bilgileri kullanabiliriz.

Parametreleri:

$resim_dosyasının_id_değeri

(int – Zorunludur ) Getirilmek istenilen resmin ID değeridir.

Bir resmin ID değerini bulmanın yollarında biri, yönetim panelinden Ortam->Kütüphane sayfasına giderek, resme tıklamak ve açılan sayfanın adres çubuğuna dikkat etmektir. Adres çubuğunda şuna benzer bir URL ifadesi görülecektir:

https://sitecenneti.com/wp-admin/upload.php?item=14

Yukarıda görülen URL ifadesindeki 14 sayısı, ekrandaki resmin ID değeridir.

$boyutlari

(string|array) Getirilmek istenen resmin boyutlarıdır. Bu parametre, değer olarak, daha önceden kayıtlı resim boyutlardan birinin adını alabilir ya da pixel cinsinden, resim için belirlediğimiz genişlik ve yükseklik değerlerini -sırasıyla- içeren basit bir dizi de kabul edebilir.

$boyutlari parametresine, varsayılan olarak, küçük boyutlardaki resimlerin ismi olan 'thumbnail' değeri ayarlanmıştır.

WordPress kurulumu ile birlikte gelen resim boyutları hakkında daha detaylı bilgi sahibi olmak için ortam ayarları başlığımızı okuyabilirsiniz.

Örnek-1

Wp_get_attachment_image_src() fonksiyonunun, $boyutları parametresine, basit bir dizi (array) değeri atanarak kullanımı şöyledir:

<?php $resim_bilgileri = wp_get_attachment_image_src( 1827, array('300', '300') );  ?>

Yukarıdaki kod, ID değeri 1827 olan resmi, oranını bozmadan, boyut bilgilerini 300×300 değerlerine en yakın hale getirir. Bu resim için, boyut değerleri ile birlikte, URL ve ikon bilgilerini bir dizi halinde döndürür.

$resim_bilgileri değişkeninin taşıdığı diziyi görmek için, var_dump( $resim_bilgileri ) fonksiyonu kullanırsak, karşımıza şöyle bir dizi çıkar:

array(4) {
     [0]=> string(68) "https://sitecenneti.com/wp-content/uploads/2019/06/Hydrangeas.jpg"
     [1]=> int(300)
     [2]=> int(225)
     [3]=> bool(false)
}

Aynı fonksiyonu, WordPress döngüsü içinde kullanmak istersek şöyle kullanırız:

<?php echo wp_get_attachment_image_src( get_the_ID(), array('300', '300') ) );  ?>

$icon

(bool) Resmin is_intermediate (orjinal boyutlar değişmiş mi) değerini döndürür. true/false değerlerini alır. Resim bilgileri orijinal boyutlara ait değilse true, orijinal boyut bilgileri geldi ise false değerini döndürür.

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

Bir resmin; URL değeri, genişliği, yüksekliği ve ikon özelliği bilgilerini bir dizi halinde getirir. Resmi bulamazsa false değerini döndürür.

Wp_get_attachmetn_image_src() fonksiyonunu, yalın haliye kullanmak istersek, sadece resmin ID değerini girmemiz yeterlidir:

Wp_get_attachment_image_src( 1827 );

Yalın halinde, wp_get_attachmetn_image_src() fonksiyonu şöyle bir dizi döndürecektir:

array(4) {
     [0]=> string(76) "https://sitecenneti.com/wp-content/uploads/2019/06/Hydrangeas-150x150.jpg"
     [1]=> int(150)
     [2]=> int(150)
     [3]=> bool(true)
} 

Kaynak kodu:

Dizini: wp-includes/media.php

function wp_get_attachment_image_src( $attachment_id, $size = 'thumbnail', $icon = false ) {
    // get a thumbnail or intermediate image if there is one
    $image = image_downsize( $attachment_id, $size );
    if ( ! $image ) {
        $src = false;
 
        if ( $icon && $src = wp_mime_type_icon( $attachment_id ) ) {
            /** This filter is documented in wp-includes/post.php */
            $icon_dir = apply_filters( 'icon_dir', ABSPATH . WPINC . '/images/media' );
 
            $src_file                = $icon_dir . '/' . wp_basename( $src );
            @list( $width, $height ) = getimagesize( $src_file );
        }
 
        if ( $src && $width && $height ) {
            $image = array( $src, $width, $height );
        }
    }
    /**
     * Filters the image src result.
     *
     * @since 4.3.0
     *
     * @param array|false  $image         Either array with src, width & height, icon src, or false.
     * @param int          $attachment_id Image attachment ID.
     * @param string|array $size          Size of image. Image size or array of width and height values
     *                                    (in that order). Default 'thumbnail'.
     * @param bool         $icon          Whether the image should be treated as an icon. Default false.
     */
    return apply_filters( 'wp_get_attachment_image_src', $image, $attachment_id, $size, $icon );
}

Örnek kullanım:

Örnek-1

Wp_get_attachment_image_src() fonksiyonunun genel kullanımı şu şekildedir:

<?php
$resim_bilgileri = wp_get_attachment_image_src( 1827 );
if ( $resim_bilgileri ) : ?>
    <img
	src="<?php echo $resim_bilgileri[0]; ?>"
	width="<?php echo $resim_bilgileri[1]; ?>"
	height="<?php echo $resim_bilgileri[2]; ?>"
	/>
<?php endif; ?>