Повертає зображення (разом з HTML-тегом і його атрибутами), яке встановлено в якості мініатюри поста. Якщо зазначений пост не має мініатюри, то функція повертає порожній рядок.
$ Post_id (ціле число) ID поста, мініатюру якого нам потрібно отримати, за замовчуванням - ID поточного пост з циклу. $ Size (рядок | масив) в цьому параметрі вказуємо розмір мініатюри. Може приймати наступні значення:
- thumbnail / medium / large - одне зі стандартних розмірів зображень, зареєстрованих в WordPress за замовчуванням, дані розміри можна налаштувати в Параметри> Медіа,
- full - оригінальне дозвіл зображення - таким воно було завантажено на сайт,
- Можна вказати власні параметри ширини і висоти мініатюри у вигляді масиву, наприклад array (50, 30). Зверніть увагу, WordPress не створюватиме дублікат картинки під цей розмір - замість цього буде використовуватися найбільш близький по вирішенню зареєстрований розмір картинки, підігнаний під ваші параметри зі збереженням оригінальних пропорцій.
- src - якщо вам треба, можете навіть замінити URL картинки.
- class - клас тега
. за замовчуванням має наступні класи wp-post-image і attachment-.
- alt - за замовчуванням trim (strip_tags ($ attachment-> post_title)) - вказується в адмінці при завантаженні / редагуванні медіафайлу.
- title - за замовчуванням trim (strip_tags ($ attachment-> post_excerpt)).
Простий приклад - просто виведемо мініатюру поста з ID = 5:
У цьому прикладі я також використовував функцію has_post_thumbnail () для того, щоб в разі відсутності мініатюри код не виводив зайвий тег .
Приклад 3. Як зробити, щоб при кліці на мініатюру, відкривалася повна версія картинки?
Код з цього прикладу відмінно підійде для використання в якомусь плагін jQuery, наприклад fancybox або pretty photo. В такому випадку вам можливо також знадобиться додати клас для посилання.
Ви також можете ознайомитися з документацією функцій wp_get_attachment_image_src () і get_post_thumbnail_id () на моєму блозі.
Приклад 4. Використовуємо третій параметр $ attr для зміни класу мініатюри
Давайте додамо на наші мініатюри клас align-left типу для того, щоб вони обтічні текстом зліва:
Кількість параметрів даного фільтра не може не радувати, це означає, що ми можемо творити з повертається HTML-кодом все, що нам завгодно.
$ Html (рядок) HTML-код, що повертається функцією за замовчуванням, $ post_id (ціле число) ID поста, мініатюру якого потрібно отримати, $ post_thumbnail_id (ціле число) ID мініатюри, $ size (рядок | масив) розмір мініатюри, $ attr ( масив) масив HTML-атрибутів, які були задані при виконанні функції, якщо не задані, то порожній масив;
А тепер кілька цікавих прикладів.
Приклад 1. Автоматичне проставляння посилань на пост
Круто так? А головне - все дуже просто.
Приклад 2. Повертаємо тільки URL мініатюри
Ще одна корисна річ, яку можна зробити за допомогою фільтра post_thumbnail_html. Припустимо, нам не потрібен весь HTML-код з тегом . допустимо, нам потрібен тільки URL. В такому випадку:
