get_post_gallery()
Отримує першу галерею з тексту вказаного запису/поста. Шукає шорткод у тексті, обробляє його та повертає масив даних картинок галереї.
Аналог функції get_post_galleries() тільки отримує дані першої галереї, а не всіх наявних.
Не працює із блоковим редактором (Гутенберг). Працює лише для шоткоду .
Працює на основі:
get_post_galleries()
get_post_galleries()
Основа для:
get_post_gallery_images()
get_post_gallery_images()
1 раз – 0.014229 сек
(гальмо) | 50000 разів – 612.03 сек
(гальмо) |
PHP 7.0.4, WP 4.4.2
(гальмо) | 50000 разів – 612.03 сек
(гальмо) |
PHP 7.0.4, WP 4.4.2
Хуки з функції
Повертає
Строку|Массив.
массив– Список картинок галереї.строку HTML– Якщо параметр $html=true поверне рядок – HTML код галереї.false– Якщо на сторінці галерея відсутня.
Використання
get_post_gallery($post, $html);
-
$post
(число/WP_Post) (обов’язковий) - ID або об’єкт запису, в тексті якого потрібно знайти першу галерею.
-
$html
(логічний) -
У даних повертати готовий HTML галереї або дані галереї як ID вкладень і посилань на картинки цих вкладень.
Типово: true
Приклади
#1 Отримаємо першу галерею запису 2179
$ gal = get_post_gallery (2179, false); /* $gal міститиме Array ( [ids] => 6790,6789,6788 [src] => Array ( [0] => http://wp-kama.ru/wp-content/uploads/2016/02/image12-80x80.png [1] => http://wp-kama.ru/wp-content/uploads/2016/02/image11-80x80.png [2] => http://wp-kama.ru/wp-content/uploads/2016/02/image10-80x80.png ) ) */ $ gal = get_post_gallery (2179, true); /* $gal міститиме рядок HTML галереї <div id='gallery-1' class='gallery galleryid-19 gallery-columns-3 gallery-size-thumbnail'><figure class='gallery-item'> <div class='gallery-icon landscape'> <a href='/article/sajt-na-konstruktore-wix/image12'><img width="80" height="80" src="/wp-content/uploads/2016/02/image12-80x80.png " class="attachment-thumbnail size-thumbnail" alt="image12" /></a> </div></figure><figure class='gallery-item'> <div class='gallery-icon landscape'> <a href='/article/sajt-na-konstruktore-wix/image11'><img width="80" height="80" src="/wp-content/uploads/2016/02/image11-80x80.png " class="attachment-thumbnail size-thumbnail" alt="image11" /></a> </div></figure><figure class='gallery-item'> <div class='gallery-icon landscape'> <a href='/article/sajt-na-konstruktore-wix/image10'><img width="80" height="80" src="/wp-content/uploads/2016/02/image10-80x80.png " class="attachment-thumbnail size-thumbnail" alt="image10" /></a> </div></figure> </div> */
список змін
| З версії 3.6.0 | Введено. |
Код get_post_gallery() get post gallery WP 6.0.2
function get_post_gallery( $post = 0, $html = true ) {
$ galleries = get_post_galleries ($ post, $ html);
$ Gallery = reset ($ Galeries);
/**
* Filters the first-found post gallery.
*
* @ Since 3.6.0
*
* @param array $gallery The first-found post gallery.
* @param int|WP_Post $post Post ID або об'єкт.
* @param array $galleries Associative array all found post galleries.
*/
return apply_filters( 'get_post_gallery', $gallery, $post, $galleries);
}