Как добавить фильтр в список записей в админке 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. Вы можете перейти в конец страницы и оставить ваш комментарий.

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

Обновление Inactive User Deleter плагина до v 1.1

Ноябрь 26, 2012 г.

Вспомнил про свой первый плагин для вордпресса только потому, что в гостевую мне написал один из пользователей этого плагина. Зашел на страницу плагина на вордпресс.org, почитал форум поддержки... И понял, что пора обновить плагин. Любой проект, ...

Читать

Inactive User Deleter Tool 1.62

Август 26, 2023 г.

Небольшие обновления для плагина, который я поддерживаю для WP. Я хотел убрать ограничение, связанное с переменной PHP - max_input_vars. Дело в том, что каждый пользователь в списке - это отдельная переменная формы, и если список большой, то можно ...

Читать

Комментарии к «Как добавить фильтр в список записей в админке 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

Ответить

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