get_post_gallery

Получает первую галерею из текста указанной записи/поста. Ищет шорткод [ gallery] в тексте, обрабатывает его и возвращает массив данных картинок галереи.

Аналог функции get_post_galleries(), только получает данные первой галереи, а не всех имеющихся.

✈ 1 раз = 0.014229с = тормоз | 50000 раз = 612.03с = тормоз PHP 7.0.4, WP 4.4.2
Хуки из функции:
get_post_gallery
Возвращает

Строку/массив. Список картинок галереи. Если параметр $html=true то вернет строку – HTML код галереи.

Использование

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='http://wp-kama.ru/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='http://wp-kama.ru/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='http://wp-kama.ru/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>
*/

Код из


wp-includes/media.php

WP 4.7.2

<?php
function get_post_gallery( $post = 0, $html = true ) {
	$galleries = get_post_galleries( $post, $html );
	$gallery = reset( $galleries );

	/**
	 * 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 or object.
	 * @param array       $galleries Associative array of all found post galleries.
	 */
	return apply_filters( 'get_post_gallery', $gallery, $post, $galleries );
}

Комментарии:


Оставить комментарий

Your email address will not be published. Required fields are marked *