wp_dropdown_pages() │ WP 2.1.0

Виводить список постійних сторінок, що випадає (список у тезі.
За замовчуванням: ‘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() .

Список відсутніх тут параметрів get_pages() :

'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>

нотатки

Дивіться: get_pages()

список змін

З версії 2.1.0	Введено.
З версії 4.2.0	The `$value_field` argument був added.
З версії 4.3.0	The `$class` argument був added.

Код `wp_dropdown_pages() wp dropdown pages` ^{WP 6.0.2}

wp-includes/post-template.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',
	);

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

	$ pages = get_pages ($ parsed_args);
	$output = '';
	// Back-compat with old system where both id and name були базовані на $name argument.
	if ( empty( $parsed_args['id'] ) ) {
		$parsed_args['id'] = $parsed_args['name'];
	}

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

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

	/**
	 * Filters HTML output of list pages as drop down.
	 *
	 * @ Since 2.1.0
	 * @since 4.4.0 `$parsed_args` та `$pages` added as arguments.
	 *
	 * @param string $output HTML-output для скасування списку сторінок.
	 * @param array $parsed_args The parsed arguments array. See wp_dropdown_pages()
	 * for information on accepted arguments.
	 * @param WP_Post[] $pages Array of the page objects.
	 */
	$html = apply_filters( 'wp_dropdown_pages', $output, $parsed_args, $pages);

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

	return $html;
}

wp_dropdown_pages() │ WP 2.1.0

Параметри get_pages()

Приклади

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

#2 Приклад випадаючого списку постійних сторінок із кнопкою сабмита:

нотатки

список змін

Код wp_dropdown_pages() wp dropdown pages WP 6.0.2

Зв’язані функції

Список (wp_list списки)

Сторінки

Залишити відповідь Скасувати коментар

Код `wp_dropdown_pages() wp dropdown pages` ^{WP 6.0.2}