wppaste
WordPress

apply_filters( 'wp_dropdown_pages', string $output, array $parsed_args, \WP_Post[] $pages )

Since
2.1.0, 4.4.0
Filters the HTML output of a list of pages as a dropdown.

Compatibility

WordPress
since 4.4.0
  • 6.7.7
  • 6.8.8
  • 6.9.7
  • 7.0.4
  • 7.1.0

Present in every tracked release (6.7.7 to 7.1.0).

Parameters

$outputstring
HTML output for dropdown list of pages.
$parsed_argsarray
The parsed arguments array. See wp_dropdown_pages() for information on accepted arguments.
$pages\WP_Post[]
Array of the page objects.

Where this hook fires · 1

  • wp-includes/post-template.php:1253wp_dropdown_pages()

Source code

View on Trac View on GitHub 

	 *	 * @param string    $output      HTML output for dropdown list of pages.	 * @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;

Changelog

Introduced in 2.1.0. Unchanged from 6.7.7 through 7.1.0.

  1. 6.7.7
  2. 6.8.8
  3. 6.9.7
  4. 7.0.4
  5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

4.4.0
$parsed_args and $pages added as arguments.from the docblock
2.1.0
Introduced.from the docblock

About this page

Parsed data
Generated from the wordpress-develop 7.1.0 tag, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.
Corrections
Something wrong on this page? Report it and it gets fixed in the next regeneration.