parent_dropdown() WordPress Function
The parent_dropdown() function in WordPress allows you to create a dropdown menu of all the pages on your site. This can be useful if you want to create a navigation menu that includes all the pages on your site.
parent_dropdown( int $default_page, int $parent, int $level, int|WP_Post $post = null ) #
Prints out option HTML elements for the page parents drop-down.
Parameters
Return
(void|false) Void on success, false if the page has no children.
Source
File: wp-admin/includes/template.php
function parent_dropdown( $default_page = 0, $parent = 0, $level = 0, $post = null ) { global $wpdb; $post = get_post( $post ); $items = $wpdb->get_results( $wpdb->prepare( "SELECT ID, post_parent, post_title FROM $wpdb->posts WHERE post_parent = %d AND post_type = 'page' ORDER BY menu_order", $parent ) ); if ( $items ) { foreach ( $items as $item ) { // A page cannot be its own parent. if ( $post && $post->ID && (int) $item->ID === $post->ID ) { continue; } $pad = str_repeat( ' ', $level * 3 ); $selected = selected( $default_page, $item->ID, false ); echo "\n\t<option class='level-$level' value='$item->ID' $selected>$pad " . esc_html( $item->post_title ) . '</option>'; parent_dropdown( $default_page, $item->ID, $level + 1 ); } } else { return false; } }
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
Version | Description |
---|---|
4.4.0 | $post argument was added. |
1.5.0 | Introduced. |