Alert: This function’s access is marked private. This means it is not intended for use by plugin or theme developers, only in other core functions. It is listed here for completeness.
_wp_auto_add_pages_to_menu() WordPress Function
The _wp_auto_add_pages_to_menu() function automatically adds newly created pages to the main menu of a WordPress site. This can be useful for keeping the menu up to date without having to manually add new pages.
_wp_auto_add_pages_to_menu( string $new_status, string $old_status, WP_Post $post ) #
Automatically add newly published page objects to menus with that as an option.
Parameters
- $new_status
(string)(Required)The new status of the post object.
- $old_status
(string)(Required)The old status of the post object.
- $post
(WP_Post)(Required)The post object being transitioned from one status to another.
Source
File: wp-includes/nav-menu.php
function _wp_auto_add_pages_to_menu( $new_status, $old_status, $post ) { if ( 'publish' !== $new_status || 'publish' === $old_status || 'page' !== $post->post_type ) { return; } if ( ! empty( $post->post_parent ) ) { return; } $auto_add = get_option( 'nav_menu_options' ); if ( empty( $auto_add ) || ! is_array( $auto_add ) || ! isset( $auto_add['auto_add'] ) ) { return; } $auto_add = $auto_add['auto_add']; if ( empty( $auto_add ) || ! is_array( $auto_add ) ) { return; } $args = array( 'menu-item-object-id' => $post->ID, 'menu-item-object' => $post->post_type, 'menu-item-type' => 'post_type', 'menu-item-status' => 'publish', ); foreach ( $auto_add as $menu_id ) { $items = wp_get_nav_menu_items( $menu_id, array( 'post_status' => 'publish,draft' ) ); if ( ! is_array( $items ) ) { continue; } foreach ( $items as $item ) { if ( $post->ID == $item->object_id ) { continue 2; } } wp_update_nav_menu_item( $menu_id, 0, $args ); } }
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
Version | Description |
---|---|
3.0.0 | Introduced. |