WordPress как на ладони
wordpress jino

wp_dropdown_pages() WP 2.1.0

Выводит выпадающий список постоянных страниц (список в теге <select> ).

Хуки из функции:

Использование

wp_dropdown_pages( $args );

Параметры по умолчанию

$args = array(
	'depth'            => 0,
	'child_of'         => 0,
	'selected'         => 0,
	'echo'             => 1,
	'name'             => 'page_id',
	'show_option_none' => '',
	'exclude'          => '',
	'exclude_tree'     => '',
	'value_field'      => 'ID', // поле для значения value e тега option
);
wp_dropdown_pages( $args );
$args(строка/массив)
Массив аргументов которые нужно изменить. Можно указать как строку запроса.
По умолчанию: массив аргументов по умолчанию

Аргументы параметра $args

depth(число)

Этот параметр контролирует глубину вложенных страниц (сколько вложенных страниц будут показаны). По умолчанию 0 - будут показаны все уровни дочерних страниц.

  • 0 - все уровни дочерних страниц будут показаны. По умолчанию;

  • -1 - родительские и дочерние страницы будут показаны общим списком (без отступов от левого края);

  • 1 - показать только постоянные страницы первого уровня;

  • 2 - 2, 3, 4, 5 ... эти значения указывают до какой глубины показывать страницы.
child_of(число)
Показать только дочерние страницы указанной. Указывать надо ID родительской станицы.
selected(число)
ID постоянной страницы, которую нужно выделить в списке (указать атрибут selected).
По умолчанию: нет
echo(логический)
Выводить на экран (1) или возвращать для обработки (0). По умолчанию выводит на экран.
По умолчанию: 1
name(строка)
Значение атрибута name у HTML тега <select>.
По умолчанию: 'page_id'
show_option_none(строка)
Позволяет установить выбор поля select на пустое значение. Текст пустого значения указывается в этом параметре.
По умолчанию: ''
exclude(строка/число)
ID постоянных страниц, которые нужно исключить из списка. Указывать через запятую.
По умолчанию: ''
exclude_tree(число/строка)
ID родительских страниц, дерево которых не нужно показывать (включая саму станицу). Т.е. если указать, например, 45, то в списке будет отсутствовать страница 45 и все её подстраницы.
По умолчанию: ''
value_field(строка)
Поле, значение которого будет использоваться для значения атрибута value e тега option. Может быть названием любого поля таблицы posts (ID, post_title, post_name).
По умолчанию: 'ID'

Другие параметры

Кроме вышеописанных, также можно использовать и параметры рассчитанные на функцию get_pages(). Однако, эти параметры не подтверждены для этой функции, поэтому могут не работать.
Список, отсутствующих здесь, параметров get_pages():

$args = array(
	'sort_order'   => 'ASC',
	'sort_column'  => 'post_title',
	'hierarchical' => 1,
	'include'      => '',
	'meta_key'     => '',
	'meta_value'   => '',
	'authors'      => ''
);

Примеры

#1 Демонстрация работы

<?php wp_dropdown_pages(); ?>

Получим:

<select name='page_id' id='page_id'>
	<option class="level-0" value="760">Страница 1</option>
	<option class="level-0" value="280">Страница 2</option>
	<option class="level-1" value="1544">   Дочерняя страница 1</option>
	<option class="level-1" value="3484">   Дочерняя страница 2</option>
	<option class="level-1" value="3644">   Дочерняя страница 3</option>
	<option class="level-0" value="4970">Страница 3</option>
	<option class="level-0" value="7">Страница 4</option>
</select>

#2 Пример выпадающего списка постоянных страниц с кнопкой сабмита:

<li id="pages">
 <h2><?php _e('pages:'); ?></h2>
   <form action="<?php bloginfo('url'); ?>" method="get">
   <?php wp_dropdown_pages(); ?>
   <input type="submit" name="submit" value="view" />
   </form>
</li>

Код wp dropdown pages: wp-includes/post-template.php WP 4.9

<?php
function wp_dropdown_pages( $args = '' ) {
	$defaults = array(
		'depth' => 0, 'child_of' => 0,
		'selected' => 0, 'echo' => 1,
		'name' => 'page_id', 'id' => '',
		'class' => '',
		'show_option_none' => '', 'show_option_no_change' => '',
		'option_none_value' => '',
		'value_field' => 'ID',
	);

	$r = wp_parse_args( $args, $defaults );

	$pages = get_pages( $r );
	$output = '';
	// Back-compat with old system where both id and name were based on $name argument
	if ( empty( $r['id'] ) ) {
		$r['id'] = $r['name'];
	}

	if ( ! empty( $pages ) ) {
		$class = '';
		if ( ! empty( $r['class'] ) ) {
			$class = " class='" . esc_attr( $r['class'] ) . "'";
		}

		$output = "<select name='" . esc_attr( $r['name'] ) . "'" . $class . " id='" . esc_attr( $r['id'] ) . "'>\n";
		if ( $r['show_option_no_change'] ) {
			$output .= "\t<option value=\"-1\">" . $r['show_option_no_change'] . "</option>\n";
		}
		if ( $r['show_option_none'] ) {
			$output .= "\t<option value=\"" . esc_attr( $r['option_none_value'] ) . '">' . $r['show_option_none'] . "</option>\n";
		}
		$output .= walk_page_dropdown_tree( $pages, $r['depth'], $r );
		$output .= "</select>\n";
	}

	/**
	 * Filters the HTML output of a list of pages as a drop down.
	 *
	 * @since 2.1.0
	 * @since 4.4.0 `$r` and `$pages` added as arguments.
	 *
	 * @param string $output HTML output for drop down list of pages.
	 * @param array  $r      The parsed arguments array.
	 * @param array  $pages  List of WP_Post objects returned by `get_pages()`
 	 */
	$html = apply_filters( 'wp_dropdown_pages', $output, $r, $pages );

	if ( $r['echo'] ) {
		echo $html;
	}
	return $html;
}

Cвязанные функции

Из метки: Список (wp_list списки)

Еще из раздела: Страницы

Пвх покрытия для пола

Пол в помещении. Для любых помещений пвх покрытия для пола по телефону +7 (495) 740-84-68.

uzins.ru

wp_dropdown_pages 12 комментариев
Полезные 1 Все
  • Web-Blog21 cайт: web-blog.su

    "Тимур, а возможно с помощью этой функции вывести список страниц сайта в настройках плагина?

    Вы мне как-то давали пример по выводу зарегистрированных меню на сайте:

    function rmb_get_menu_list(){
    	$menus = wp_get_nav_menus();
    	if(!$menus) return false;
    	foreach($menus as $menu){
    		$options[$menu->slug] = $menu->name;
    	}
    	return $options;
    }

    , а можно так и для страниц сайта?"

    Ответить2 года назад #
    • Kama4660

      Получите все страницы через get_pages() и выведите их:

      function rmb_get_page_list(){
      	// параметры
      	$args = array(
      		'depth' => 0, 'child_of' => 0,
      		'selected' => 0, 'echo' => 1,
      		'name' => 'page_id', 'id' => '',
      		'class' => '',
      		'show_option_none' => '', 'show_option_no_change' => '',
      		'option_none_value' => '',
      		'value_field' => 'ID',
      	);
      
      	// получаем 
      	$pages = get_pages( $args );
      
      	$options = array();
      	foreach( $pages as $page ){
      		$options[ $menu->slug ] = $page->post_title;
      	}
      
      	return $options;
      }
      Ответить2 года назад #
  • Елена

    Как так же получить записи?

    Ответить2 месяца назад #
    • campusboy1946 cайт: www.youtube.com/c/wpplus @

      Вопрос хороший. Сегодня тоже самое хотел провернуть - пока не получилось.

      Ответить2 месяца назад #
    • Kama4660

      Записи не древовидные, наверное поэтому функция не работает с ними. Но это и к лучшему, потому что операций никаких не нужно по сбору дерева. А значит можно просто собрать элементы полученные через get_posts().

      $ppp = get_posts([
      	'numberposts' => 50, // сколько записей нужно
      ]);
      
      $elems = array();
      foreach( $ppp as $pp ){
      	$elems[] = '<option value="'. $pp->ID .'">'. esc_html($pp->post_title) .'</option>';
      }
      echo '<select name="______">'. implode("\n", $elems) .'</select>';
      Ответить2 месяца назад #
      • campusboy1946 cайт: www.youtube.com/c/wpplus @

        Ну я передавал, что пост тайп недревовидный. Всякие вариант попробовал, потом бросил smile и написал вот как ты. Жалею о потраченном времени...

        Ответить2 месяца назад #
  • Елена

    $ppp = get_posts([ 'numberposts' => 50, // сколько записей нужно ]);

    а как все вывести, не количество, а все

    Ответитьмесяц назад #
    • campusboy1946 cайт: www.youtube.com/c/wpplus @
      $ppp = get_posts([ 'numberposts' => -1 ]);
      Ответитьмесяц назад #
      • Елена

        Большое спасибо, все получилось. А можно ли таким же образом в селект вывести произвольное поле всех постов, например оно называется main_pole. Тоесть в каждой записи есть произвольное поле и вывести надо именно это произвольное поле

        Ответитьмесяц назад #
        • campusboy1946 cайт: www.youtube.com/c/wpplus @

          Функция wp_dropdown_pages() не для этого. Для решение такой проблемы я бы использовал функцию get_post().

          Ответитьмесяц назад #
          • Елена

            Тимур выше написал, что через get_post()

            $ppp = get_posts([
            	'numberposts' => 50, // сколько записей нужно
            ]);
            
            $elems = array();
            foreach( $ppp as $pp ){
            	$elems[] = '<option value="'. $pp->ID .'">'. esc_html($pp->post_title) .'</option>';
            }
            echo '<select name="______">'. implode("\n", $elems) .'</select>';

            Тоже самое получается, только произвольное поле, а как правильно написать, подскажите пожалуйста.

            campusboy, заранее спасибо вам

            1
            Ответитьмесяц назад #
            • campusboy1946 cайт: www.youtube.com/c/wpplus @

              Чисто теоретически:

              $posts_select = get_posts( [
              	'numberposts' => 50, // сколько записей нужно
              ] );
              
              $elems = array();
              foreach ( $posts_select as $item ) {
              	$meta    = esc_html( get_post_meta( $item->ID, 'main_pole', 1 ) );
              	$elems[] = sprintf( '<option value="%d">%s</option>', $item->ID, $meta );
              }
              echo '<select name="______">' . implode( "\n", $elems ) . '</select>';
              1
              Ответитьмесяц назад #

Здравствуйте, !

Ваш комментарий