Как настроить вывод шорткода галереи изображений WP из плагина?

20 нояб. 2010 г., 15:57:31
Просмотры: 44.7K
Голосов: 17

Мы разрабатываем плагин, который отображает записи, и мы также хотим отображать галерею изображений, когда она используется в записи. Однако нам нужно ограничить количество отображаемых фотографий. Это возможно?

0
Все ответы на вопрос 2
2
37

Есть два способа реализовать это, но оба предполагают создание функции, которая делает практически то же самое, что и стандартная функция шорткода галереи...

Вы можете либо:

  1. Использовать хук post_gallery и манипулировать входящими данными (можно использовать функцию шорткода галереи как основу для фильтра, если необходимо)
  2. Отменить регистрацию стандартного шорткода галереи и зарегистрировать новый модифицированный шорткод (опять же, можно использовать существующую функцию как основу)

Я делал нечто подобное в этой ветке, и упоминаю об этом только потому, что собираюсь использовать тот же подход в следующем примере.

Пример фильтра для шорткода галереи

add_filter( 'post_gallery', 'my_post_gallery', 10, 2 );
function my_post_gallery( $output, $attr) {
    global $post, $wp_locale;

    static $instance = 0;
    $instance++;

    // Мы доверяем вводу автора, но хотя бы убедимся, что это похоже на корректное выражение для сортировки
    if ( isset( $attr['orderby'] ) ) {
        $attr['orderby'] = sanitize_sql_orderby( $attr['orderby'] );
        if ( !$attr['orderby'] )
            unset( $attr['orderby'] );
    }

    extract(shortcode_atts(array(
        'order'      => 'ASC',
        'orderby'    => 'menu_order ID',
        'id'         => $post->ID,
        'itemtag'    => 'dl',
        'icontag'    => 'dt',
        'captiontag' => 'dd',
        'columns'    => 3,
        'size'       => 'thumbnail',
        'include'    => '',
        'exclude'    => ''
    ), $attr));

    $id = intval($id);
    if ( 'RAND' == $order )
        $orderby = 'none';

    if ( !empty($include) ) {
        $include = preg_replace( '/[^0-9,]+/', '', $include );
        $_attachments = get_posts( array('include' => $include, 'post_status' => 'inherit', 'post_type' => 'attachment', 'post_mime_type' => 'image', 'order' => $order, 'orderby' => $orderby) );

        $attachments = array();
        foreach ( $_attachments as $key => $val ) {
            $attachments[$val->ID] = $_attachments[$key];
        }
    } elseif ( !empty($exclude) ) {
        $exclude = preg_replace( '/[^0-9,]+/', '', $exclude );
        $attachments = get_children( array('post_parent' => $id, 'exclude' => $exclude, 'post_status' => 'inherit', 'post_type' => 'attachment', 'post_mime_type' => 'image', 'order' => $order, 'orderby' => $orderby) );
    } else {
        $attachments = get_children( array('post_parent' => $id, 'post_status' => 'inherit', 'post_type' => 'attachment', 'post_mime_type' => 'image', 'order' => $order, 'orderby' => $orderby) );
    }

    if ( empty($attachments) )
        return '';

    if ( is_feed() ) {
        $output = "\n";
        foreach ( $attachments as $att_id => $attachment )
            $output .= wp_get_attachment_link($att_id, $size, true) . "\n";
        return $output;
    }

    $itemtag = tag_escape($itemtag);
    $captiontag = tag_escape($captiontag);
    $columns = intval($columns);
    $itemwidth = $columns > 0 ? floor(100/$columns) : 100;
    $float = is_rtl() ? 'right' : 'left';

    $selector = "gallery-{$instance}";

    $output = apply_filters('gallery_style', "
        <style type='text/css'>
            #{$selector} {
                margin: auto;
            }
            #{$selector} .gallery-item {
                float: {$float};
                margin-top: 10px;
                text-align: center;
                width: {$itemwidth}%;           }
            #{$selector} img {
                border: 2px solid #cfcfcf;
            }
            #{$selector} .gallery-caption {
                margin-left: 0;
            }
        </style>
        <!-- см. gallery_shortcode() в wp-includes/media.php -->
        <div id='$selector' class='gallery galleryid-{$id}'>");

    $i = 0;
    foreach ( $attachments as $id => $attachment ) {
        $link = isset($attr['link']) && 'file' == $attr['link'] ? wp_get_attachment_link($id, $size, false, false) : wp_get_attachment_link($id, $size, true, false);

        $output .= "<{$itemtag} class='gallery-item'>";
        $output .= "
            <{$icontag} class='gallery-icon'>
                $link
            </{$icontag}>";
        if ( $captiontag && trim($attachment->post_excerpt) ) {
            $output .= "
                <{$captiontag} class='gallery-caption'>
                " . wptexturize($attachment->post_excerpt) . "
                </{$captiontag}>";
        }
        $output .= "</{$itemtag}>";
        if ( $columns > 0 && ++$i % $columns == 0 )
            $output .= '<br style="clear: both" />';
    }

    $output .= "
            <br style='clear: both;' />
        </div>\n";

    return $output;
}

Модифицируйте эту функцию, чтобы наложить любые ограничения, которые вам нужны (это всего лишь основа)...

Хук, который я использую, находится в файле wp-includes/media.php внутри функции обратного вызова шорткода галереи (см. строку 763).

http://core.trac.wordpress.org/browser/tags/3.0.1/wp-includes/media.php#L745

Надеюсь, это поможет.. :)

21 нояб. 2010 г. 01:17:30
Комментарии

спасибо за подсказку. Я искал этот **** фильтр уже 2 часа. +1

kaiser kaiser
6 мая 2011 г. 03:33:31

Похоже, что в WordPress 4.2.2 параметр 'orderby' => 'menu_order ID' больше не работает?

Peanuts Peanuts
13 мая 2015 г. 15:17:28
0
-2

Вы можете указать количество изображений в галерее. Это можно настроить через вкладку галереи в медиабоксе редактора записей. После того, как галерея уже вставлена, вы можете изменить эти параметры, отредактировав галерею в визуальном редакторе.

21 нояб. 2010 г. 01:02:31