get_post_thumbnail_id( int|WP_Post $içerik_id = null )

Açıklaması:

Bir içeriğin, öne çıkan görselinin ID değerini getirir.

Parametreleri:

$içerik_id

(int|WP_Post) Öne çıkan görselini getirmek istediğiniz yazı ya da sayfanın ID değeridir.

Get_post_thumbnail_id() fonksiyonu, ekranda gösterilmekte olan içeriğin veya döngü içinde sırası gelen içeriğin ID değerini kendisi bulabilir, bu yüzden, bu durumlarda bir ID değeri kullanmanıza gerek kalmaz. Fakat fonksiyonu, belli bir içerik için kullanıyorsanız, içeriğin ID değerini mutlaka girmelisiniz.

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

İçeriğin ID değerini ya da bir boş karakter döndürür.

Kaynak kodu:

Dizini : wp-includes/post-thumbnail-template.php

function get_post_thumbnail_id( $post = null ) {
    $post = get_post( $post );
    if ( ! $post ) {
        return '';
    }
    return get_post_meta( $post->ID, '_thumbnail_id', true );
}

Kullanımı:

Örnek-1

Aşağıdaki kod, döngü içinde veya tek yazı şablonları gibi global $post nesnesinin tanımlı olduğu yerlerde kullanılır. Yoksa, kod içindeki $post->ID değeri ve get_post_thumbnail_id() fonksiyonu çalışmayacaktır.

Bu kod örneği, bir sayfa ya da yazı için yüklenmiş resimleri getirir fakat öne çıkan görsellerini getirmez. Ayrıca her bir resmin üzerine, o resmin adını başlık olarak da gösterir:

<?php
$argumanlar = array(
    'post_type'   => 'attachment',
    'post_mime_type' => 'image',
    'numberposts' => -1,
    'post_status' => 'any',
    'post_parent' => $post->ID,
    'exclude'     => get_post_thumbnail_id(),
);
 
$gorseller = get_posts( $argumanlar );
 
if ( $gorseller ) {
    foreach ( $gorseller as $gorsel ) {
        echo '<h2>'.apply_filters( 'the_title', $gorsel->post_title ).'</h2>';
        the_attachment_link( $gorsel->ID, false );
		echo '<br />';
    }
}
?>