Как добавить фильтр в список записей в админке WordPress?

Выведя дополнительные столбцы в админке, хотелось бы иметь возможность фильтрации по этим полям. Как это делать, покажу на примере фильтрации по мета-полю публикации.

Если вы читаете данный гайд, то уже знаете :

Если нет, восполните сначала данные пробелы, чтобы двигаться дальше.

Итак, мы создали свой кастомный тип публикации, в котором храним описания филиалов нашей розничной сети. При регистрации данного типа материала (filials), я указал, что буду использовать meta-поля (custom_fields).

WordPress позволяет прямо в редакторе публикации создавать новые поля, подключая их к редактируемой статье. Я решил, что буду задавать для каждого филиала поле City, т.е. город, где расположен данный филиал. Соотвествующий столбец был настроен в списке публикаций админки WP.

Для внедрения фильтра понадобится две зацепки :

Фильтр (filter) parse_query — позволяет добавить HTML код в панель фильтров админки,
Действие (action) restrict_manage_posts — позволяет внедриться в запрос списка выводимых записей и сделать нужные нам манипуляции.

Реализацию этих зацепок нужно разместить в function.php своей темы или коде своего плагина.

// кастомный фильтр в список публикаций админки
add_filter( 'parse_query', 'admin_posts_filter' );
add_action( 'restrict_manage_posts', 'admin_posts_filter_restrict_manage_posts' );

function admin_posts_filter( $query ) {
    global $pagenow;
    if ( is_admin() && $pagenow=='edit.php') {
        //добавлям фильтрацию по городу в запрос
        if (!empty($_GET['ADMIN_FILTER_FIELD_CITY'])) {
            $query->query_vars['meta_key'] = 'City';
            $query->query_vars['meta_value'] = $_GET['ADMIN_FILTER_FIELD_CITY'];
        }
    }
}

function admin_posts_filter_restrict_manage_posts() {
    global $wpdb, $pagenow;
 
    if ($pagenow != 'edit.php') return;
    $out = '';
 
    switch ($_GET['post_type']) {
    case 'filials':
        //фильтр по городу
        $fieldname = 'ADMIN_FILTER_FIELD_CITY';
        //надо выбрать все уникальные значения поля для показа
        //в выпадающем поле
        $rows = $wpdb->get_results("SELECT DISTINCT meta_value FROM {$wpdb->postmeta} 
        WHERE meta_key = 'City' ORDER BY meta_value", ARRAY_N);
        
        //собираем HTML код SELECT со списком городов
        $out .= '<select name="' . $fieldname . '">
        <option value="">-- Выберите город --</option>';
       
        foreach($rows as $row) {
            if (isset($_GET[$fieldname]) && $_GET[$fieldname] == $row[0]) 
                $out .= sprintf ('<option value="%s" selected>%s</option>',
                     $row[0], $row[0]);
            else 
                $out .= sprintf ('<option value="%s">%s</option>', 
                     $row[0], $row[0]);
        }
        $out .= '</select>';
    }
    //покажем созданный фильтр
    echo $out;
}

// кастомный фильтр в список публикаций админки

add_filter( 'parse_query', 'admin_posts_filter' );

add_action( 'restrict_manage_posts', 'admin_posts_filter_restrict_manage_posts' );

function admin_posts_filter( $query ) {

global $pagenow;

if ( is_admin() && $pagenow=='edit.php') {

//добавлям фильтрацию по городу в запрос

if (!empty($_GET['ADMIN_FILTER_FIELD_CITY'])) {

$query->query_vars['meta_key'] = 'City';

$query->query_vars['meta_value'] = $_GET['ADMIN_FILTER_FIELD_CITY'];

}

function admin_posts_filter_restrict_manage_posts() {

global $wpdb, $pagenow;

if ($pagenow != 'edit.php') return;

$out = '';

switch ($_GET['post_type']) {

case 'filials':

//фильтр по городу

$fieldname = 'ADMIN_FILTER_FIELD_CITY';

//надо выбрать все уникальные значения поля для показа

//в выпадающем поле

$rows = $wpdb->get_results("SELECT DISTINCT meta_value FROM {$wpdb->postmeta}

WHERE meta_key = 'City' ORDER BY meta_value", ARRAY_N);

//собираем HTML код SELECT со списком городов

$out .= '<select name="' . $fieldname . '">

<option value="">-- Выберите город --</option>';

foreach($rows as $row) {

if (isset($_GET[$fieldname]) && $_GET[$fieldname] == $row[0])

$out .= sprintf ('<option value="%s" selected>%s</option>',

$row[0], $row[0]);

else

$out .= sprintf ('<option value="%s">%s</option>',

$row[0], $row[0]);

}

$out .= '</select>';

}

//покажем созданный фильтр

echo $out;

}

У вас будут свои мета-поля, но данный каркас вы легко приспособите для собственной задачи.

Написать комментарий

Данная запись опубликована в 21.04.2016 21:18 и размещена в рубрике wordpress. Вы можете перейти в конец страницы и оставить ваш комментарий.

Мало букафф? Читайте есчо !

WordPress: вывод рубрик и тегов таксономии в шаблоне single.php

Июль 17, 2025 г.

Если вы хотите отобразить рубрики (категории) и теги поста в шаблоне single.php - т.е. шаблоне одиночной статьи, WordPress предоставляет удобные функции из API-шаблонов. В этой статье разберем, как их использовать правильно и оформить вывод. Зачем ...

Читать

Ошибка формирования чека в best2pay для WooCommerce при использовании купонов — разбор и решение

Январь 29, 2026 г.

В одном из проектов столкнулся с проблемой формирования фискального чека в модуле оплаты best2pay для WooCommerce. Ошибка проявлялась не всегда, а только при использовании промокодов и нескольких товаров в корзине. Формально платеж проходил, но строки ...

Читать

WP Plugin Active Contour для WordPress — визуальное редактирование контуров на изображениях

Июнь 17, 2025 г.

Идея сделать этот плагин возникла у меня уже давно, но как это часто бывает, не хватало времени «сесть и реализовать». Но не давно, я остался без контракта, и у меня появилось время на собственные проекты. Одновременно хотелось попробовать давно интересовавшую ...

Читать

Переводим (русифицируем) плагин для wordpress

Январь 22, 2010 г.

Допустим вы написали плагин для wordpress. Что дальше? Можно ли как то расширить аудиторию пользователей, чтобы стяжать ещё большую славу :)? Ответ, конечно же, - да, можно. Иначе этой статьи бы не было. Расскажу, как сделать и подключить файлы переводов ...

Читать

Комментарии к «Как добавить фильтр в список записей в админке WordPress?»

Понравилась статья? Есть вопросы? - пишите в комментариях.

Много комментариев в “Как добавить фильтр в список записей в админке WordPress?”

Александр:

6 июня 2017 в 23:02

А если нужно N-фильтров и все они являются кастомными полями?

$query->query_vars[‘meta_key’] = ‘City’;
$query->query_vars[‘meta_value’] = $_GET[‘ADMIN_FILTER_FIELD_CITY’];

Как в query_vars передать несколько мета-данных. Я это пойму конечно через время (доки почитаю, погуглю), просто наверняка и другим будет это интересно

Ответить

Александр:

6 июня 2017 в 23:03

Или можно как-то массив передать?

Ответить
- admin:
  
  6 июня 2017 в 23:19
  
  Можно и массив передавать, если нужно:) К примеру, вы создаёте select с множественным выбором и именем переменной myvar[]. При выборе нескольких элементов списка получите массив в $_GET[‘myvar’].

admin:

6 июня 2017 в 23:15

WP_query позволяет собирать несколько условий https://codex.wordpress.org/Class_Reference/WP_Query#Custom_Field_Parameters

для этого нужно собрать массив вида

$query->query_vars = array(
	'meta_query' => array(
               'relation' => 'AND',
		array(
			'key'     => 'color',
			'value'   => 'blue',
			'compare' => 'NOT LIKE',
		),
		array(
			'key' => 'price',
			'value'   => array( 20, 100 ),
			'type'    => 'numeric',
			'compare' => 'BETWEEN',
		),
	),
);

$query->query_vars = array(

'meta_query' => array(

'relation' => 'AND',

array(

'key' => 'color',

'value' => 'blue',

'compare' => 'NOT LIKE',

array(

'key' => 'price',

'value' => array( 20, 100 ),

'type' => 'numeric',

'compare' => 'BETWEEN',

);

Ответить

Александр:

6 июня 2017 в 23:31

Ответ тут:
https://wp-kama.ru/function/wp_meta_query

Ответить

Имя (обязательно)	Е-майл (не будет опубликован на сайте, обязательно для заполнения)
Комментарий: