Как получить количество колонок галереи?

В фильтре post_gallery количество колонок уже передается во втором аргументе фильтра — в массиве атрибутов галереи. Для классического шорткода галереи это ключ columns. Если пользователь не выбрал другое значение в настройках галереи, WordPress использует значение по умолчанию, обычно 3. Поэтому получать количество колонок нужно не из глобальных настроек и не из базы отдельно, а прямо из $attr.

Важно подключить фильтр с правильным количеством аргументов. У post_gallery есть не только $output и $attr, но и $instance. Если третий аргумент не нужен, его можно не использовать в логике, но при add_filter лучше указать 3 принимаемых аргумента, чтобы функция совпадала с сигнатурой фильтра и в будущем можно было различать несколько галерей на странице.

add_filter('post_gallery', 'custom_gallery_function', 10, 3);
 
function custom_gallery_function($output, $attr, $instance) {
    $columns = isset($attr['columns']) ? absint($attr['columns']) : 3;
 
    if ($columns < 1) {
        $columns = 3;
    }
 
    $ids = [];
 
    if (!empty($attr['ids'])) {
        $ids = array_map('absint', explode(',', $attr['ids']));
    }
 
    if (!$ids) {
        return $output;
    }
 
    $html = '<div class="custom-gallery custom-gallery--columns-' . esc_attr($columns) . '">';
 
    foreach ($ids as $id) {
        $html .= '<div class="custom-gallery__item">';
        $html .= wp_get_attachment_image($id, 'medium');
        $html .= '</div>';
    }
 
    $html .= '</div>';
 
    return $html;
}

Дальше это число можно использовать двумя способами: сразу добавить inline-стиль grid-template-columns или, что обычно чище, сформировать CSS-класс с количеством колонок. Например, custom-gallery--columns-2, custom-gallery--columns-3 и так далее. Тогда разметка остается простой, а внешний вид управляется CSS.

.custom-gallery {
    display: grid;
    gap: 16px;
}
 
.custom-gallery--columns-2 {
    grid-template-columns: repeat(2, minmax(0, 1fr));
}
 
.custom-gallery--columns-3 {
    grid-template-columns: repeat(3, minmax(0, 1fr));
}

• Если columns пришел пустым, нулевым или некорректным, задайте безопасное значение 3.
• Если в $attr нет ids, лучше вернуть исходный $output, чтобы не ломать галереи, собранные другим способом.
• Если на странице несколько галерей, параметр $instance поможет различать их номера, но для получения колонок он не нужен.

Отдельный нюанс: post_gallery работает с классическим шорткодом

. Если галерея создана блоком Gutenberg, она может выводиться как блок core/gallery и не проходить через этот фильтр. В таком случае нужно работать уже с render_block или стилями блока, а не ждать columns в post_gallery.