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

Açıklaması:

Bir yazı ya da sayfanın, öne çıkan bir görsele sahip olup olmadığını kontrol eder.

Öne çıkan görseller için daha detaylı bilgiyi, Öne Çıkan Görsel Özelliği Ekleme adlı dersimizde bulabilirsiniz.

Parametreleri:

$içerik_id

(int|WP_Post) Öne çıkan görsele sahip olup olmadığını test etmek istediğiniz yazı ya da sayfanın ID değeridir.

Has_post_thumbnail() 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:

Has_post_thumbnail() fonksiyonu; parametresinde ID değeri belirtilen içerik, öne çıkan bir görsele sahipse true değerini döndürür, değilse false değerini döndürür.

Kaynak kodu:

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

function has_post_thumbnail( $post = null ) {
    $thumbnail_id  = get_post_thumbnail_id( $post );
    $has_thumbnail = (bool) $thumbnail_id;
 
    /**
     * Filters whether a post has a post thumbnail.
     *
     * @since 5.1.0
     *
     * @param bool             $has_thumbnail true if the post has a post thumbnail, otherwise false.
     * @param int|WP_Post|null $post          Post ID or WP_Post object. Default is global `$post`.
     * @param int|string       $thumbnail_id  Post thumbnail ID or empty string.
     */
    return (bool) apply_filters( 'has_post_thumbnail', $has_thumbnail, $post, $thumbnail_id );
}

Kullanımı:

Örnek-1

Öne çıkan görseli olmayan içeriklerimiz için bir yer tutucu görseliniz olsun ve bu görsel, temanın ana dizininde bulunan 'resimler' klasöründe bulunan, yer-tutucu-gorsel.jpg adında bir resim olsun.

Aşağıdaki örnek, döngü içindeyken, bir içeriğin öne çıkan görseli varsa onu yoksa, onun yerine bahsettiğimiz bu yer tutucu resmi yükler:

<?php
// Döngü içinde çalışır
 
if ( has_post_thumbnail() ) {
    the_post_thumbnail();
}
else {
    echo '<img src="' . get_theme_file_uri() . '/resimler/yer-tutucu-gorsel.jpg" />';
}
?>