The_post_thumbnail() - Виводить html код картинки-мініатюри поточного посту

Виводить html код картинки-мініатюри поточного посту.

Цей тег шаблон повинен використовуватися всередині циклу WordPress.

Використовуйте get_the_post_thumbnail(), коли потрібно отримати дані цієї функції для обробки PHP.

Додатковий розмір картинки, яку можна отримати за допомогою цієї функції, можна створити через add_image_size(). За замовчуванням доступні такі розміри: thumbnail, medium, large, full, post-thumbnail.

Повертає

null (нічого). Виводить на екран рядок. Функція виводить на екран html код зображення або порожнє значення (null), якщо зображення не існує.

Використання

Розмір мініатюри, яку необхідно отримати. Може бути рядком: thumbnail, medium, large, full або масивом з двох елементів (ширина і висота картинки): array (32, 32).

Коли вказано масив, нова мініатюра із зазначеними розмірами не створюється. А WP шукає відповідний розмір з тих, що вже є, бере його і просто вказує висоту і ширину в пікселях для тега IMG, щоб зменшити картинку. Тобто. картинка зменшується лише візуально.

Типово: 'post-thumbnail', розмір який встановлюється для теми функцією set_post_thumbnail_size()

Масив атрибутів, які потрібно додати одержуваному html тегу img .

Можна вказати рядком: alt=альт& > або масивом:

Атрибути можна вказувати будь-які. За замовчуванням: ''

Додаткові приклади, як стилізувати мініатюри і передавати атрибути дивіться в описі функції get_the_post_thumbnail().

Приклад 1: Використовуйте наступний код, щоб зробити зображення мініатюри посиланням на пост. Приклад для використання всередині Цикл WordPress:

#2: Зробимо мініатюру посиланням на пост

Дляцього використовуємо хук post_thumbnail_html. В цьому випадку картинка буде посиланням на пост відразу при виклик функції the_post_thumbnail(); . Код потрібно додавати до файлу шаблонуfunctions.php :

Приклад, що показує як створити мініатюру, яка посилатиметься на оригінальний розмір картинки:

#4 Реєстрація нового розміру

За допомогою add_image_size() можна зареєструвати новий розмір і отримати його за ключом:

---