get_post_thumbnail_id() WP 2.9.0
Получает ID миниатюры указанной записи (поста). Получает ID вложения (картинки).
Можно использовать внутри Цикла WordPress.
Чтобы получить URL картинки используйте wp_get_attachment_image_src().
Чтобы для поста можно было определить картинку миниатюру, нужно активировать эту возможность функцией - add_theme_support( 'post-thumbnails' ) в файле шаблона funсtions.php.
ID миниатюры записывается в служебное произвольное поле _thumbnail_id
.
Хуков нет.
Возвращает
Число/false. ID миниатюры - если она есть. false - если миниатюры нет (до версии 5.5 возвращалась пустая строка).
Использование
$id = get_post_thumbnail_id( $post_id );
- $post_id(число/WP_Post)
- ID или объект поста, для которого нужно получить ID миниатюры.
По умолчанию: нет
Примеры
#1. Все вложения текущего поста, кроме миниатюр
Чтобы вывести все прикрепленные к посту файлы, кроме картинок-миниатюр можно использовать такой код. Переменная $post должна быть определена!
<?php $args = array( 'post_type' => 'attachment', 'numberposts' => -1, 'post_status' => null, 'post_parent' => $post->ID, 'exclude' => get_post_thumbnail_id() ); $attachments = get_posts( $args ); if ( $attachments ) { foreach ( $attachments as $attachment ) { echo apply_filters( 'the_title', $attachment->post_title ); the_attachment_link( $attachment->ID, false ); } } ?>
Для получения записей (прикрепленных фалов) используется функция get_posts().
Список изменений
С версии 2.9.0 | Введена. |
С версии 4.4.0 | $post can be a post ID or WP_Post object. |
С версии 5.5.0 | The return value for a non-existing post was changed to false instead of an empty string. |
Код get_post_thumbnail_id() get post thumbnail id WP 5.6
function get_post_thumbnail_id( $post = null ) {
$post = get_post( $post );
if ( ! $post ) {
return false;
}
return (int) get_post_meta( $post->ID, '_thumbnail_id', true );
}Cвязанные функции
Из метки: thumbnail (image картинки-миниатюры)
- add_image_size()
- delete_post_thumbnail()
- get_intermediate_image_sizes()
- get_the_post_thumbnail()
- get_the_post_thumbnail_caption()
- get_the_post_thumbnail_url()
- has_image_size()