Использование функции get_post_galleries() в WordPress

Главная - WordPress Codex - Использование функции get_post_galleries() в WordPress
Доступна с версии: 3.6
Раздел: Файловая система и Вложения
Написал: Александр Сокирка

Функция get_post_galleries() в WordPress позволяет извлекать галереи из содержимого записи, используя шорткоды gallery. Это полезный инструмент для разработчиков и администраторов сайтов, который помогает управлять визуальным контентом.

get_post_galleries( int|WP_Post $post, bool $html = true ): array

Параметры

  • $post (обязательный): ID записи (int) или объект записи (WP_Post), из которой нужно получить галереи.
  • $html (опциональный): логическое значение, указывающее, нужно ли возвращать HTML-код или массив данных. По умолчанию установлено значение true.

Возвращаемое значение

Функция возвращает массив, содержащий данные о галереях, включая идентификаторы вложений и ссылки на изображения. Если параметр $html установлен в true, возвращается готовый HTML-код галерей.

Важные моменты

Пример 1: Получение всех галерей записи с ID 1234

В этом примере мы получим все галереи из записи с ID 1234, предполагая, что в содержимом присутствуют две галереи.

$galleries = get_post_galleries(1234, false);

/* $galleries будет равно
Array
(
    [0] => Array
        (
            [ids] => 1010,1009,1008
            [src] => Array
                (
                    [0] => http://example.com/wp-content/uploads/2024/01/image1-80x80.png
                    [1] => http://example.com/wp-content/uploads/2024/01/image2-80x80.png
                    [2] => http://example.com/wp-content/uploads/2024/01/image3-80x80.png
                )
        )
    [1] => Array
        (
            [ids] => 1007,1006,1005
            [src] => Array
                (
                    [0] => http://example.com/wp-content/uploads/2024/01/image4-80x80.jpg
                    [1] => http://example.com/wp-content/uploads/2024/01/image5-80x80.jpg
                    [2] => http://example.com/wp-content/uploads/2024/01/image6-80x80.jpg
                )
        )
)
*/

Пример 2: Получение HTML-кода всех галерей записи с ID 4567

В этом примере мы получим HTML-код галерей из записи с ID 4567.

$galleries_html = get_post_galleries(4567, true);

/* $galleries_html будет равно
Array
(
    [0] => <div id='gallery-1' class='gallery galleryid-4567 gallery-columns-3 gallery-size-thumbnail'>
        <figure class='gallery-item'>
            <div class='gallery-icon landscape'>
                <a href='/gallery/image1'><img width="80" height="80" src="/wp-content/uploads/2024/01/image1-80x80.png" class="attachment-thumbnail size-thumbnail" alt="image1" /></a>
            </div></figure>
        <figure class='gallery-item'>
            <div class='gallery-icon landscape'>
                <a href='/gallery/image2'><img width="80" height="80" src="/wp-content/uploads/2024/01/image2-80x80.png" class="attachment-thumbnail size-thumbnail" alt="image2" /></a>
            </div></figure>
        <figure class='gallery-item'>
            <div class='gallery-icon landscape'>
                <a href='/gallery/image3'><img width="80" height="80" src="/wp-content/uploads/2024/01/image3-80x80.png" class="attachment-thumbnail size-thumbnail" alt="image3" /></a>
            </div></figure>
        </div>
    [1] => <div id='gallery-2' class='gallery galleryid-4567 gallery-columns-3 gallery-size-thumbnail'>
        <figure class='gallery-item'>
            <div class='gallery-icon landscape'>
                <a href='/gallery/image4'><img width="80" height="80" src="/wp-content/uploads/2024/01/image4-80x80.jpg" class="attachment-thumbnail size-thumbnail" alt="image4" /></a>
            </div></figure>
        <figure class='gallery-item'>
            <div class='gallery-icon landscape'>
                <a href='/gallery/image5'><img width="80" height="80" src="/wp-content/uploads/2024/01/image5-80x80.jpg" class="attachment-thumbnail size-thumbnail" alt="image5" /></a>
            </div></figure>
        <figure class='gallery-item'>
            <div class='gallery-icon landscape'>
                <a href='/gallery/image6'><img width="80" height="80" src="/wp-content/uploads/2024/01/image6-80x80.jpg" class="attachment-thumbnail size-thumbnail" alt="image6" /></a>
            </div></figure>
        </div>
)
*/

Заключение

Функция get_post_galleries() является мощным инструментом для работы с галереями изображений в WordPress. Она позволяет легко извлекать галереи из содержимого записей и представлять их в нужном формате, будь то массив данных или готовый HTML-код. С учетом поддержки блочного редактора с версии 5.9, возможности этой функции стали еще шире.

Стартовая премиум тема для WordPress
Демо импорт тестового контента в 1 клик.
SEO оптимизированный и валидный код.
Множество готовых стартовых сайтов.
Лучшая документация и поддержка.
Опции персонализации контента.
Креативный и современный дизайн.
Тема для WordPress

Дополнительно по: Файловая система и Вложения