2010-02-24 03:06:36 -05:00
< ? php
2015-09-22 10:27:24 -04:00
/**
* Core Navigation Menu API
*
* @ package WordPress
* @ subpackage Nav_Menus
* @ since 3.0 . 0
*/
2010-04-26 21:05:58 -04:00
2016-08-31 12:31:29 -04:00
/** Walker_Nav_Menu_Edit class */
2020-02-06 01:33:11 -05:00
require_once ABSPATH . 'wp-admin/includes/class-walker-nav-menu-edit.php' ;
2016-08-31 12:31:29 -04:00
/** Walker_Nav_Menu_Checklist class */
2020-02-06 01:33:11 -05:00
require_once ABSPATH . 'wp-admin/includes/class-walker-nav-menu-checklist.php' ;
2016-08-31 12:31:29 -04:00
2010-04-26 21:05:58 -04:00
/**
* Prints the appropriate response to a menu quick search .
*
* @ since 3.0 . 0
2010-05-03 16:26:11 -04:00
*
2010-04-26 21:05:58 -04:00
* @ param array $request The unsanitized request values .
*/
function _wp_ajax_menu_quick_search ( $request = array () ) {
2017-11-30 18:11:00 -05:00
$args = array ();
$type = isset ( $request [ 'type' ] ) ? $request [ 'type' ] : '' ;
$object_type = isset ( $request [ 'object_type' ] ) ? $request [ 'object_type' ] : '' ;
$query = isset ( $request [ 'q' ] ) ? $request [ 'q' ] : '' ;
2020-04-04 23:02:11 -04:00
$response_format = isset ( $request [ 'response-format' ] ) ? $request [ 'response-format' ] : '' ;
if ( ! $response_format || ! in_array ( $response_format , array ( 'json' , 'markup' ), true ) ) {
$response_format = 'json' ;
}
2010-04-26 21:05:58 -04:00
2020-05-16 14:42:12 -04:00
if ( 'markup' === $response_format ) {
2022-11-29 10:51:14 -05:00
$args [ 'walker' ] = new Walker_Nav_Menu_Checklist ();
2010-04-26 21:05:58 -04:00
}
2020-05-16 14:42:12 -04:00
if ( 'get-post-item' === $type ) {
2010-06-11 11:53:41 -04:00
if ( post_type_exists ( $object_type ) ) {
2010-04-26 21:05:58 -04:00
if ( isset ( $request [ 'ID' ] ) ) {
$object_id = ( int ) $request [ 'ID' ];
2020-05-16 14:42:12 -04:00
if ( 'markup' === $response_format ) {
2017-11-30 18:11:00 -05:00
echo walk_nav_menu_tree ( array_map ( 'wp_setup_nav_menu_item' , array ( get_post ( $object_id ) ) ), 0 , ( object ) $args );
2020-05-16 14:42:12 -04:00
} elseif ( 'json' === $response_format ) {
2014-10-28 14:35:19 -04:00
echo wp_json_encode (
2010-04-26 21:05:58 -04:00
array (
2017-11-30 18:11:00 -05:00
'ID' => $object_id ,
2010-04-26 21:05:58 -04:00
'post_title' => get_the_title ( $object_id ),
2017-11-30 18:11:00 -05:00
'post_type' => get_post_type ( $object_id ),
2010-04-26 21:05:58 -04:00
)
);
echo " \n " ;
}
}
2010-06-11 11:53:41 -04:00
} elseif ( taxonomy_exists ( $object_type ) ) {
2010-04-26 21:05:58 -04:00
if ( isset ( $request [ 'ID' ] ) ) {
$object_id = ( int ) $request [ 'ID' ];
2020-05-16 14:42:12 -04:00
if ( 'markup' === $response_format ) {
2017-11-30 18:11:00 -05:00
echo walk_nav_menu_tree ( array_map ( 'wp_setup_nav_menu_item' , array ( get_term ( $object_id , $object_type ) ) ), 0 , ( object ) $args );
2020-05-16 14:42:12 -04:00
} elseif ( 'json' === $response_format ) {
2010-04-26 21:05:58 -04:00
$post_obj = get_term ( $object_id , $object_type );
2014-10-28 14:35:19 -04:00
echo wp_json_encode (
2010-04-26 21:05:58 -04:00
array (
2017-11-30 18:11:00 -05:00
'ID' => $object_id ,
2010-04-26 21:05:58 -04:00
'post_title' => $post_obj -> name ,
2017-11-30 18:11:00 -05:00
'post_type' => $object_type ,
2010-04-26 21:05:58 -04:00
)
);
echo " \n " ;
}
}
}
2017-11-30 18:11:00 -05:00
} elseif ( preg_match ( '/quick-search-(posttype|taxonomy)-([a-zA-Z_-]*\b)/' , $type , $matches ) ) {
2020-05-16 14:42:12 -04:00
if ( 'posttype' === $matches [ 1 ] && get_post_type_object ( $matches [ 2 ] ) ) {
2016-09-09 00:59:31 -04:00
$post_type_obj = _wp_nav_menu_meta_box_object ( get_post_type_object ( $matches [ 2 ] ) );
2017-11-30 18:11:00 -05:00
$args = array_merge (
2016-10-02 22:35:28 -04:00
$args ,
array (
'no_found_rows' => true ,
'update_post_meta_cache' => false ,
'update_post_term_cache' => false ,
'posts_per_page' => 10 ,
'post_type' => $matches [ 2 ],
's' => $query ,
)
2016-09-09 00:59:31 -04:00
);
if ( isset ( $post_type_obj -> _default_query ) ) {
$args = array_merge ( $args , ( array ) $post_type_obj -> _default_query );
}
$search_results_query = new WP_Query ( $args );
2016-06-27 07:51:30 -04:00
if ( ! $search_results_query -> have_posts () ) {
2010-05-03 16:31:34 -04:00
return ;
2016-06-27 07:51:30 -04:00
}
while ( $search_results_query -> have_posts () ) {
$post = $search_results_query -> next_post ();
2020-05-16 14:42:12 -04:00
if ( 'markup' === $response_format ) {
2016-06-27 07:51:30 -04:00
$var_by_ref = $post -> ID ;
2017-11-30 18:11:00 -05:00
echo walk_nav_menu_tree ( array_map ( 'wp_setup_nav_menu_item' , array ( get_post ( $var_by_ref ) ) ), 0 , ( object ) $args );
2020-05-16 14:42:12 -04:00
} elseif ( 'json' === $response_format ) {
2014-10-28 14:35:19 -04:00
echo wp_json_encode (
2010-04-26 21:05:58 -04:00
array (
2017-11-30 18:11:00 -05:00
'ID' => $post -> ID ,
2016-06-27 07:51:30 -04:00
'post_title' => get_the_title ( $post -> ID ),
2017-11-30 18:11:00 -05:00
'post_type' => $matches [ 2 ],
2010-04-26 21:05:58 -04:00
)
);
echo " \n " ;
}
}
2020-05-16 14:42:12 -04:00
} elseif ( 'taxonomy' === $matches [ 1 ] ) {
2017-11-30 18:11:00 -05:00
$terms = get_terms (
2018-08-16 21:51:36 -04:00
array (
2019-01-21 18:38:52 -05:00
'taxonomy' => $matches [ 2 ],
2017-11-30 18:11:00 -05:00
'name__like' => $query ,
'number' => 10 ,
2020-05-02 18:36:07 -04:00
'hide_empty' => false ,
2017-11-30 18:11:00 -05:00
)
);
if ( empty ( $terms ) || is_wp_error ( $terms ) ) {
2010-05-03 16:31:34 -04:00
return ;
2017-11-30 18:11:00 -05:00
}
2015-08-25 16:28:22 -04:00
foreach ( ( array ) $terms as $term ) {
2020-05-16 14:42:12 -04:00
if ( 'markup' === $response_format ) {
2017-11-30 18:11:00 -05:00
echo walk_nav_menu_tree ( array_map ( 'wp_setup_nav_menu_item' , array ( $term ) ), 0 , ( object ) $args );
2020-05-16 14:42:12 -04:00
} elseif ( 'json' === $response_format ) {
2014-10-28 14:35:19 -04:00
echo wp_json_encode (
2010-04-26 21:05:58 -04:00
array (
2017-11-30 18:11:00 -05:00
'ID' => $term -> term_id ,
2010-04-26 21:05:58 -04:00
'post_title' => $term -> name ,
2017-11-30 18:11:00 -05:00
'post_type' => $matches [ 2 ],
2010-04-26 21:05:58 -04:00
)
);
echo " \n " ;
}
}
}
}
}
2010-03-22 15:56:16 -04:00
/**
2016-07-09 20:56:28 -04:00
* Register nav menu meta boxes and advanced menu items .
2010-03-22 15:56:16 -04:00
*
* @ since 3.0 . 0
2017-11-30 18:11:00 -05:00
*/
2010-04-28 23:43:39 -04:00
function wp_nav_menu_setup () {
2020-01-28 19:35:08 -05:00
// Register meta boxes.
2010-04-26 21:05:58 -04:00
wp_nav_menu_post_type_meta_boxes ();
2015-03-12 02:15:27 -04:00
add_meta_box ( 'add-custom-links' , __ ( 'Custom Links' ), 'wp_nav_menu_item_link_meta_box' , 'nav-menus' , 'side' , 'default' );
2010-04-26 21:05:58 -04:00
wp_nav_menu_taxonomy_meta_boxes ();
2010-05-03 16:26:11 -04:00
2020-01-28 19:35:08 -05:00
// Register advanced menu items (columns).
2013-03-15 09:16:38 -04:00
add_filter ( 'manage_nav-menus_columns' , 'wp_nav_menu_manage_columns' );
2010-05-03 16:26:11 -04:00
2010-04-28 23:43:39 -04:00
// If first time editing, disable advanced items by default.
2015-06-16 16:01:25 -04:00
if ( false === get_user_option ( 'managenav-menuscolumnshidden' ) ) {
2010-04-28 23:43:39 -04:00
$user = wp_get_current_user ();
2021-05-24 15:59:57 -04:00
update_user_meta (
2018-08-16 21:51:36 -04:00
$user -> ID ,
'managenav-menuscolumnshidden' ,
2017-11-30 18:11:00 -05:00
array (
0 => 'link-target' ,
1 => 'css-classes' ,
2 => 'xfn' ,
3 => 'description' ,
4 => 'title-attribute' ,
2021-05-24 15:59:57 -04:00
)
2017-11-30 18:11:00 -05:00
);
2010-04-28 23:43:39 -04:00
}
2010-03-22 15:56:16 -04:00
}
2010-02-24 03:06:36 -05:00
2010-03-22 15:56:16 -04:00
/**
2015-06-18 11:04:26 -04:00
* Limit the amount of meta boxes to pages , posts , links , and categories for first time users .
2010-03-22 15:56:16 -04:00
*
* @ since 3.0 . 0
2015-05-28 17:41:30 -04:00
*
* @ global array $wp_meta_boxes
2017-11-30 18:11:00 -05:00
*/
2010-03-22 15:56:16 -04:00
function wp_initial_nav_menu_meta_boxes () {
global $wp_meta_boxes ;
2010-03-26 15:36:49 -04:00
2017-11-30 18:11:00 -05:00
if ( get_user_option ( 'metaboxhidden_nav-menus' ) !== false || ! is_array ( $wp_meta_boxes ) ) {
2010-04-29 14:27:46 -04:00
return ;
2017-11-30 18:11:00 -05:00
}
2010-04-29 15:16:21 -04:00
2015-11-04 05:56:26 -05:00
$initial_meta_boxes = array ( 'add-post-type-page' , 'add-post-type-post' , 'add-custom-links' , 'add-category' );
2017-11-30 18:11:00 -05:00
$hidden_meta_boxes = array ();
2010-03-26 15:36:49 -04:00
2017-11-30 18:11:00 -05:00
foreach ( array_keys ( $wp_meta_boxes [ 'nav-menus' ] ) as $context ) {
foreach ( array_keys ( $wp_meta_boxes [ 'nav-menus' ][ $context ] ) as $priority ) {
foreach ( $wp_meta_boxes [ 'nav-menus' ][ $context ][ $priority ] as $box ) {
2020-04-04 23:02:11 -04:00
if ( in_array ( $box [ 'id' ], $initial_meta_boxes , true ) ) {
2010-04-29 14:27:46 -04:00
unset ( $box [ 'id' ] );
} else {
$hidden_meta_boxes [] = $box [ 'id' ];
2010-03-22 15:56:16 -04:00
}
}
}
}
2010-04-29 15:16:21 -04:00
2010-04-29 14:27:46 -04:00
$user = wp_get_current_user ();
2021-05-24 15:59:57 -04:00
update_user_meta ( $user -> ID , 'metaboxhidden_nav-menus' , $hidden_meta_boxes );
2010-03-22 15:56:16 -04:00
}
2010-03-15 12:26:46 -04:00
2010-02-28 15:00:49 -05:00
/**
2016-07-09 20:56:28 -04:00
* Creates meta boxes for any post type menu item ..
2010-02-28 15:00:49 -05:00
*
* @ since 3.0 . 0
*/
2010-04-26 21:05:58 -04:00
function wp_nav_menu_post_type_meta_boxes () {
2010-05-13 13:29:45 -04:00
$post_types = get_post_types ( array ( 'show_in_nav_menus' => true ), 'object' );
2010-03-17 12:27:25 -04:00
2017-11-30 18:11:00 -05:00
if ( ! $post_types ) {
2010-03-22 15:56:16 -04:00
return ;
2017-11-30 18:11:00 -05:00
}
2010-03-16 13:22:24 -04:00
foreach ( $post_types as $post_type ) {
2013-10-26 13:48:11 -04:00
/**
2016-05-22 14:01:30 -04:00
* Filters whether a menu items meta box will be added for the current
2014-04-25 02:14:15 -04:00
* object type .
2013-10-26 13:48:11 -04:00
*
2014-04-25 02:14:15 -04:00
* If a falsey value is returned instead of an object , the menu items
* meta box for the current meta box object will not be added .
2013-10-26 13:48:11 -04:00
*
* @ since 3.0 . 0
*
2019-12-06 17:23:04 -05:00
* @ param WP_Post_Type | false $post_type The current object to add a menu items
* meta box for .
2013-10-26 13:48:11 -04:00
*/
2010-04-28 14:30:32 -04:00
$post_type = apply_filters ( 'nav_menu_meta_box_object' , $post_type );
if ( $post_type ) {
$id = $post_type -> name ;
2014-07-17 05:14:16 -04:00
// Give pages a higher priority.
2020-05-16 14:42:12 -04:00
$priority = ( 'page' === $post_type -> name ? 'core' : 'default' );
2015-10-30 01:47:24 -04:00
add_meta_box ( " add-post-type- { $id } " , $post_type -> labels -> name , 'wp_nav_menu_item_post_type_meta_box' , 'nav-menus' , 'side' , $priority , $post_type );
2010-04-28 14:30:32 -04:00
}
2010-02-28 15:00:49 -05:00
}
2010-03-15 12:26:46 -04:00
}
/**
2016-07-09 20:56:28 -04:00
* Creates meta boxes for any taxonomy menu item .
2010-03-15 12:26:46 -04:00
*
* @ since 3.0 . 0
*/
2010-04-26 21:05:58 -04:00
function wp_nav_menu_taxonomy_meta_boxes () {
2010-05-29 12:46:46 -04:00
$taxonomies = get_taxonomies ( array ( 'show_in_nav_menus' => true ), 'object' );
2010-03-16 18:01:49 -04:00
2017-11-30 18:11:00 -05:00
if ( ! $taxonomies ) {
2010-03-22 15:56:16 -04:00
return ;
2017-11-30 18:11:00 -05:00
}
2010-03-16 13:22:24 -04:00
2010-03-15 12:26:46 -04:00
foreach ( $taxonomies as $tax ) {
2014-04-25 02:14:15 -04:00
/** This filter is documented in wp-admin/includes/nav-menu.php */
2010-04-28 14:30:32 -04:00
$tax = apply_filters ( 'nav_menu_meta_box_object' , $tax );
if ( $tax ) {
$id = $tax -> name ;
2010-05-13 20:34:04 -04:00
add_meta_box ( " add- { $id } " , $tax -> labels -> name , 'wp_nav_menu_item_taxonomy_meta_box' , 'nav-menus' , 'side' , 'default' , $tax );
2010-04-28 14:30:32 -04:00
}
2010-02-28 15:00:49 -05:00
}
}
2010-02-24 03:06:36 -05:00
2013-02-15 23:53:59 -05:00
/**
2019-12-09 08:49:03 -05:00
* Check whether to disable the Menu Locations meta box submit button and inputs .
2013-02-15 23:53:59 -05:00
*
* @ since 3.6 . 0
Code Modernization: Rename parameters that use reserved keywords in `wp-admin/includes/nav-menu.php`.
While using reserved PHP keywords as parameter name labels is allowed, in the context of function calls using named parameters in PHP 8.0+, this will easily lead to confusion. To avoid that, it is recommended not to use reserved keywords as function parameter names.
This commit:
* Renames the `$echo` parameter to `$display` in `wp_nav_menu_disabled_check()`.
* Renames the `$object` parameter to `$item_object` in:
* `wp_nav_menu_item_post_type_meta_box()`
* `wp_nav_menu_item_taxonomy_meta_box()`
* `_wp_nav_menu_meta_box_object()`
Follow-up to [52946], [52996], [52997], [52998], [53003], [53014], [53029], [53039], [53116], [53117], [53137], [53174], [53184], [53185], [53192], [53193], [53198], [53203].
Props jrf, aristath, poena, justinahinon, SergeyBiryukov.
See #55327.
Built from https://develop.svn.wordpress.org/trunk@53207
git-svn-id: http://core.svn.wordpress.org/trunk@52796 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-04-18 11:22:08 -04:00
* @ since 5.3 . 1 The `$display` parameter was added .
2013-02-15 23:53:59 -05:00
*
2015-05-28 17:41:30 -04:00
* @ global bool $one_theme_location_no_menus to determine if no menus exist
2013-02-15 23:53:59 -05:00
*
2019-12-09 08:49:03 -05:00
* @ param int | string $nav_menu_selected_id ID , name , or slug of the currently selected menu .
Code Modernization: Rename parameters that use reserved keywords in `wp-admin/includes/nav-menu.php`.
While using reserved PHP keywords as parameter name labels is allowed, in the context of function calls using named parameters in PHP 8.0+, this will easily lead to confusion. To avoid that, it is recommended not to use reserved keywords as function parameter names.
This commit:
* Renames the `$echo` parameter to `$display` in `wp_nav_menu_disabled_check()`.
* Renames the `$object` parameter to `$item_object` in:
* `wp_nav_menu_item_post_type_meta_box()`
* `wp_nav_menu_item_taxonomy_meta_box()`
* `_wp_nav_menu_meta_box_object()`
Follow-up to [52946], [52996], [52997], [52998], [53003], [53014], [53029], [53039], [53116], [53117], [53137], [53174], [53184], [53185], [53192], [53193], [53198], [53203].
Props jrf, aristath, poena, justinahinon, SergeyBiryukov.
See #55327.
Built from https://develop.svn.wordpress.org/trunk@53207
git-svn-id: http://core.svn.wordpress.org/trunk@52796 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-04-18 11:22:08 -04:00
* @ param bool $display Whether to display or just return the string .
2019-12-09 08:49:03 -05:00
* @ return string | false Disabled attribute if at least one menu exists , false if not .
2015-12-12 10:37:28 -05:00
*/
Code Modernization: Rename parameters that use reserved keywords in `wp-admin/includes/nav-menu.php`.
While using reserved PHP keywords as parameter name labels is allowed, in the context of function calls using named parameters in PHP 8.0+, this will easily lead to confusion. To avoid that, it is recommended not to use reserved keywords as function parameter names.
This commit:
* Renames the `$echo` parameter to `$display` in `wp_nav_menu_disabled_check()`.
* Renames the `$object` parameter to `$item_object` in:
* `wp_nav_menu_item_post_type_meta_box()`
* `wp_nav_menu_item_taxonomy_meta_box()`
* `_wp_nav_menu_meta_box_object()`
Follow-up to [52946], [52996], [52997], [52998], [53003], [53014], [53029], [53039], [53116], [53117], [53137], [53174], [53184], [53185], [53192], [53193], [53198], [53203].
Props jrf, aristath, poena, justinahinon, SergeyBiryukov.
See #55327.
Built from https://develop.svn.wordpress.org/trunk@53207
git-svn-id: http://core.svn.wordpress.org/trunk@52796 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-04-18 11:22:08 -04:00
function wp_nav_menu_disabled_check ( $nav_menu_selected_id , $display = true ) {
2013-02-15 23:53:59 -05:00
global $one_theme_location_no_menus ;
2017-11-30 18:11:00 -05:00
if ( $one_theme_location_no_menus ) {
2013-02-15 23:53:59 -05:00
return false ;
2017-11-30 18:11:00 -05:00
}
2013-02-15 23:53:59 -05:00
Code Modernization: Rename parameters that use reserved keywords in `wp-admin/includes/nav-menu.php`.
While using reserved PHP keywords as parameter name labels is allowed, in the context of function calls using named parameters in PHP 8.0+, this will easily lead to confusion. To avoid that, it is recommended not to use reserved keywords as function parameter names.
This commit:
* Renames the `$echo` parameter to `$display` in `wp_nav_menu_disabled_check()`.
* Renames the `$object` parameter to `$item_object` in:
* `wp_nav_menu_item_post_type_meta_box()`
* `wp_nav_menu_item_taxonomy_meta_box()`
* `_wp_nav_menu_meta_box_object()`
Follow-up to [52946], [52996], [52997], [52998], [53003], [53014], [53029], [53039], [53116], [53117], [53137], [53174], [53184], [53185], [53192], [53193], [53198], [53203].
Props jrf, aristath, poena, justinahinon, SergeyBiryukov.
See #55327.
Built from https://develop.svn.wordpress.org/trunk@53207
git-svn-id: http://core.svn.wordpress.org/trunk@52796 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-04-18 11:22:08 -04:00
return disabled ( $nav_menu_selected_id , 0 , $display );
2013-02-15 23:53:59 -05:00
}
2010-03-15 12:26:46 -04:00
/**
2016-07-09 20:56:28 -04:00
* Displays a meta box for the custom links menu item .
2010-03-15 12:26:46 -04:00
*
* @ since 3.0 . 0
2015-05-28 17:41:30 -04:00
*
* @ global int $_nav_menu_placeholder
* @ global int | string $nav_menu_selected_id
2010-03-15 12:26:46 -04:00
*/
2010-04-26 21:05:58 -04:00
function wp_nav_menu_item_link_meta_box () {
2010-05-29 16:33:48 -04:00
global $_nav_menu_placeholder , $nav_menu_selected_id ;
2010-04-26 21:05:58 -04:00
2013-03-15 13:08:04 -04:00
$_nav_menu_placeholder = 0 > $_nav_menu_placeholder ? $_nav_menu_placeholder - 1 : - 1 ;
2010-04-26 21:05:58 -04:00
2010-03-15 12:26:46 -04:00
?>
2010-05-26 10:49:43 -04:00
< div class = " customlinkdiv " id = " customlinkdiv " >
2013-03-15 09:16:38 -04:00
< input type = " hidden " value = " custom " name = " menu-item[<?php echo $_nav_menu_placeholder ; ?>][menu-item-type] " />
2016-01-30 08:46:27 -05:00
< p id = " menu-item-url-wrap " class = " wp-clearfix " >
2016-01-22 09:26:27 -05:00
< label class = " howto " for = " custom-menu-item-url " >< ? php _e ( 'URL' ); ?> </label>
2020-10-23 11:05:09 -04:00
< input id = " custom-menu-item-url " name = " menu-item[<?php echo $_nav_menu_placeholder ; ?>][menu-item-url] " type = " text " < ? php wp_nav_menu_disabled_check ( $nav_menu_selected_id ); ?> class="code menu-item-textbox form-required" placeholder="https://" />
2013-03-15 09:16:38 -04:00
</ p >
2010-04-26 21:05:58 -04:00
2016-01-30 08:46:27 -05:00
< p id = " menu-item-name-wrap " class = " wp-clearfix " >
2016-01-22 09:26:27 -05:00
< label class = " howto " for = " custom-menu-item-name " >< ? php _e ( 'Link Text' ); ?> </label>
2019-12-09 08:49:03 -05:00
< input id = " custom-menu-item-name " name = " menu-item[<?php echo $_nav_menu_placeholder ; ?>][menu-item-title] " type = " text " < ? php wp_nav_menu_disabled_check ( $nav_menu_selected_id ); ?> class="regular-text menu-item-textbox" />
2013-03-15 09:16:38 -04:00
</ p >
2010-04-26 21:05:58 -04:00
2016-01-30 08:46:27 -05:00
< p class = " button-controls wp-clearfix " >
2010-04-26 21:05:58 -04:00
< span class = " add-to-menu " >
2017-11-30 18:11:00 -05:00
< input type = " submit " < ? php wp_nav_menu_disabled_check ( $nav_menu_selected_id ); ?> class="button submit-add-to-menu right" value="<?php esc_attr_e( 'Add to Menu' ); ?>" name="add-custom-menu-item" id="submit-customlinkdiv" />
2012-09-26 15:57:44 -04:00
< span class = " spinner " ></ span >
2010-04-26 21:05:58 -04:00
</ span >
</ p >
</ div ><!-- /. customlinkdiv -->
2010-03-15 12:26:46 -04:00
< ? php
}
2010-02-24 03:06:36 -05:00
2010-03-15 12:26:46 -04:00
/**
2016-07-09 20:56:28 -04:00
* Displays a meta box for a post type menu item .
2010-03-15 12:26:46 -04:00
*
* @ since 3.0 . 0
*
2015-05-28 17:41:30 -04:00
* @ global int $_nav_menu_placeholder
* @ global int | string $nav_menu_selected_id
*
Code Modernization: Rename parameters that use reserved keywords in `wp-admin/includes/template.php`.
While using reserved PHP keywords as parameter name labels is allowed, in the context of function calls using named parameters in PHP 8.0+, this will easily lead to confusion. To avoid that, it is recommended not to use reserved keywords as function parameter names.
This commit:
* Renames the `$echo` parameter to `$display` in:
* `wp_popular_terms_checklist()`
* `_post_states()`
* `_media_states()`
* Renames the `$default` parameter to `$default_term` in `wp_popular_terms_checklist()`.
* Renames the `$default` parameter to `$default_template` in `page_template_dropdown()`.
* Renames the `$default` parameter to `$default_page` in `parent_dropdown()`.
* Renames the `$object` parameter to `$data_object` in:
* `do_block_editor_incompatible_meta_box()`
* `do_meta_boxes()`
* `do_accordion_sections()`
* Amends the `$item_object` parameter in other functions for consistency:
* `wp_nav_menu_item_post_type_meta_box()`
* `wp_nav_menu_item_taxonomy_meta_box()`
* `_wp_nav_menu_meta_box_object()`
Follow-up to [52946], [52996], [52997], [52998], [53003], [53014], [53029], [53039], [53116], [53117], [53137], [53174], [53184], [53185], [53192], [53193], [53198], [53203], [53207], [53215], [53216].
Props jrf, aristath, poena, justinahinon, SergeyBiryukov.
See #55327.
Built from https://develop.svn.wordpress.org/trunk@53220
git-svn-id: http://core.svn.wordpress.org/trunk@52809 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-04-19 11:13:08 -04:00
* @ param string $data_object Not used .
2016-07-21 15:19:29 -04:00
* @ param array $box {
* Post type menu item meta box arguments .
2016-07-21 14:00:32 -04:00
*
2016-07-21 15:24:28 -04:00
* @ type string $id Meta box 'id' attribute .
2016-07-21 15:19:29 -04:00
* @ type string $title Meta box title .
2020-07-14 07:56:04 -04:00
* @ type callable $callback Meta box display callback .
2016-07-21 15:19:29 -04:00
* @ type WP_Post_Type $args Extra meta box arguments ( the post type object for this meta box ) .
2016-07-21 14:00:32 -04:00
* }
2010-03-15 12:26:46 -04:00
*/
Code Modernization: Rename parameters that use reserved keywords in `wp-admin/includes/template.php`.
While using reserved PHP keywords as parameter name labels is allowed, in the context of function calls using named parameters in PHP 8.0+, this will easily lead to confusion. To avoid that, it is recommended not to use reserved keywords as function parameter names.
This commit:
* Renames the `$echo` parameter to `$display` in:
* `wp_popular_terms_checklist()`
* `_post_states()`
* `_media_states()`
* Renames the `$default` parameter to `$default_term` in `wp_popular_terms_checklist()`.
* Renames the `$default` parameter to `$default_template` in `page_template_dropdown()`.
* Renames the `$default` parameter to `$default_page` in `parent_dropdown()`.
* Renames the `$object` parameter to `$data_object` in:
* `do_block_editor_incompatible_meta_box()`
* `do_meta_boxes()`
* `do_accordion_sections()`
* Amends the `$item_object` parameter in other functions for consistency:
* `wp_nav_menu_item_post_type_meta_box()`
* `wp_nav_menu_item_taxonomy_meta_box()`
* `_wp_nav_menu_meta_box_object()`
Follow-up to [52946], [52996], [52997], [52998], [53003], [53014], [53029], [53039], [53116], [53117], [53137], [53174], [53184], [53185], [53192], [53193], [53198], [53203], [53207], [53215], [53216].
Props jrf, aristath, poena, justinahinon, SergeyBiryukov.
See #55327.
Built from https://develop.svn.wordpress.org/trunk@53220
git-svn-id: http://core.svn.wordpress.org/trunk@52809 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-04-19 11:13:08 -04:00
function wp_nav_menu_item_post_type_meta_box ( $data_object , $box ) {
2010-05-29 16:33:48 -04:00
global $_nav_menu_placeholder , $nav_menu_selected_id ;
2010-05-26 22:24:33 -04:00
2016-07-21 15:19:29 -04:00
$post_type_name = $box [ 'args' ] -> name ;
2020-02-07 16:38:06 -05:00
$post_type = get_post_type_object ( $post_type_name );
2020-04-04 23:02:11 -04:00
$tab_name = $post_type_name . '-tab' ;
2010-04-26 21:05:58 -04:00
2014-07-17 05:14:16 -04:00
// Paginate browsing for large numbers of post objects.
2010-04-26 21:05:58 -04:00
$per_page = 50 ;
2020-04-04 23:02:11 -04:00
$pagenum = isset ( $_REQUEST [ $tab_name ] ) && isset ( $_REQUEST [ 'paged' ] ) ? absint ( $_REQUEST [ 'paged' ] ) : 1 ;
2017-11-30 18:11:00 -05:00
$offset = 0 < $pagenum ? $per_page * ( $pagenum - 1 ) : 0 ;
2010-04-26 21:05:58 -04:00
2010-05-03 16:26:11 -04:00
$args = array (
2017-11-30 18:11:00 -05:00
'offset' => $offset ,
'order' => 'ASC' ,
'orderby' => 'title' ,
'posts_per_page' => $per_page ,
'post_type' => $post_type_name ,
'suppress_filters' => true ,
2010-05-11 14:43:12 -04:00
'update_post_term_cache' => false ,
2017-11-30 18:11:00 -05:00
'update_post_meta_cache' => false ,
2010-04-26 21:05:58 -04:00
);
2010-03-17 12:27:25 -04:00
2017-11-30 18:11:00 -05:00
if ( isset ( $box [ 'args' ] -> _default_query ) ) {
$args = array_merge ( $args , ( array ) $box [ 'args' ] -> _default_query );
}
2010-04-28 14:30:32 -04:00
2019-09-25 17:51:58 -04:00
/*
* If we 're dealing with pages, let' s prioritize the Front Page ,
* Posts Page and Privacy Policy Page at the top of the list .
*/
$important_pages = array ();
2020-05-16 14:42:12 -04:00
if ( 'page' === $post_type_name ) {
2019-09-25 17:51:58 -04:00
$suppress_page_ids = array ();
// Insert Front Page or custom Home link.
2020-05-16 14:42:12 -04:00
$front_page = 'page' === get_option ( 'show_on_front' ) ? ( int ) get_option ( 'page_on_front' ) : 0 ;
2019-09-25 17:51:58 -04:00
$front_page_obj = null ;
if ( ! empty ( $front_page ) ) {
$front_page_obj = get_post ( $front_page );
$front_page_obj -> front_or_home = true ;
$important_pages [] = $front_page_obj ;
$suppress_page_ids [] = $front_page_obj -> ID ;
} else {
2020-10-08 17:15:13 -04:00
$_nav_menu_placeholder = ( 0 > $_nav_menu_placeholder ) ? ( int ) $_nav_menu_placeholder - 1 : - 1 ;
2019-09-25 17:51:58 -04:00
$front_page_obj = ( object ) array (
'front_or_home' => true ,
'ID' => 0 ,
'object_id' => $_nav_menu_placeholder ,
'post_content' => '' ,
'post_excerpt' => '' ,
'post_parent' => '' ,
'post_title' => _x ( 'Home' , 'nav menu home label' ),
'post_type' => 'nav_menu_item' ,
'type' => 'custom' ,
'url' => home_url ( '/' ),
);
$important_pages [] = $front_page_obj ;
}
// Insert Posts Page.
2020-05-16 14:42:12 -04:00
$posts_page = 'page' === get_option ( 'show_on_front' ) ? ( int ) get_option ( 'page_for_posts' ) : 0 ;
2019-09-25 17:51:58 -04:00
if ( ! empty ( $posts_page ) ) {
$posts_page_obj = get_post ( $posts_page );
$posts_page_obj -> posts_page = true ;
$important_pages [] = $posts_page_obj ;
$suppress_page_ids [] = $posts_page_obj -> ID ;
}
// Insert Privacy Policy Page.
$privacy_policy_page_id = ( int ) get_option ( 'wp_page_for_privacy_policy' );
if ( ! empty ( $privacy_policy_page_id ) ) {
$privacy_policy_page = get_post ( $privacy_policy_page_id );
if ( $privacy_policy_page instanceof WP_Post && 'publish' === $privacy_policy_page -> post_status ) {
$privacy_policy_page -> privacy_policy_page = true ;
$important_pages [] = $privacy_policy_page ;
$suppress_page_ids [] = $privacy_policy_page -> ID ;
}
}
// Add suppression array to arguments for WP_Query.
if ( ! empty ( $suppress_page_ids ) ) {
$args [ 'post__not_in' ] = $suppress_page_ids ;
}
}
2020-01-28 19:35:08 -05:00
// @todo Transient caching of these results with proper invalidation on updating of a post of this type.
2022-11-29 10:51:14 -05:00
$get_posts = new WP_Query ();
2017-11-30 18:11:00 -05:00
$posts = $get_posts -> query ( $args );
2019-09-25 17:51:58 -04:00
// Only suppress and insert when more than just suppression pages available.
2010-05-11 14:38:51 -04:00
if ( ! $get_posts -> post_count ) {
2019-09-25 17:51:58 -04:00
if ( ! empty ( $suppress_page_ids ) ) {
unset ( $args [ 'post__not_in' ] );
2022-11-29 10:51:14 -05:00
$get_posts = new WP_Query ();
2019-09-25 17:51:58 -04:00
$posts = $get_posts -> query ( $args );
} else {
echo '<p>' . __ ( 'No items.' ) . '</p>' ;
return ;
}
} elseif ( ! empty ( $important_pages ) ) {
$posts = array_merge ( $important_pages , $posts );
2010-04-29 02:01:44 -04:00
}
2010-04-26 21:05:58 -04:00
$num_pages = $get_posts -> max_num_pages ;
2017-11-30 18:11:00 -05:00
$page_links = paginate_links (
array (
'base' => add_query_arg (
array (
2020-04-04 23:02:11 -04:00
$tab_name => 'all' ,
'paged' => '%#%' ,
'item-type' => 'post_type' ,
'item-object' => $post_type_name ,
2017-11-30 18:11:00 -05:00
)
),
'format' => '' ,
'prev_text' => '<span aria-label="' . esc_attr__ ( 'Previous page' ) . '">' . __ ( '«' ) . '</span>' ,
'next_text' => '<span aria-label="' . esc_attr__ ( 'Next page' ) . '">' . __ ( '»' ) . '</span>' ,
I18N: Mark screen reader strings as such with translator comments.
This aims to provide better context for translators and make it easier to determine that some strings contain hidden accessibility text and are not displayed in the UI.
Props kebbet, mercime, pavelevap, ocean90, swissspidy, Chouby, jipmoors, afercia, desrosj, costdev, audrasjb, SergeyBiryukov.
Fixes #29748.
Built from https://develop.svn.wordpress.org/trunk@55276
git-svn-id: http://core.svn.wordpress.org/trunk@54809 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2023-02-07 12:10:21 -05:00
/* translators: Hidden accessibility text. */
2017-11-30 18:11:00 -05:00
'before_page_number' => '<span class="screen-reader-text">' . __ ( 'Page' ) . '</span> ' ,
'total' => $num_pages ,
'current' => $pagenum ,
)
);
2010-05-03 16:26:11 -04:00
2011-05-04 14:59:40 -04:00
$db_fields = false ;
if ( is_post_type_hierarchical ( $post_type_name ) ) {
2017-11-30 18:11:00 -05:00
$db_fields = array (
'parent' => 'post_parent' ,
'id' => 'ID' ,
);
2011-05-04 14:59:40 -04:00
}
2010-03-17 12:27:25 -04:00
2011-05-04 14:59:40 -04:00
$walker = new Walker_Nav_Menu_Checklist ( $db_fields );
2010-05-21 19:32:45 -04:00
$current_tab = 'most-recent' ;
2020-04-04 23:02:11 -04:00
if ( isset ( $_REQUEST [ $tab_name ] ) && in_array ( $_REQUEST [ $tab_name ], array ( 'all' , 'search' ), true ) ) {
$current_tab = $_REQUEST [ $tab_name ];
2010-02-24 03:06:36 -05:00
}
2010-03-17 12:27:25 -04:00
2017-11-30 18:11:00 -05:00
if ( ! empty ( $_REQUEST [ 'quick-search-posttype-' . $post_type_name ] ) ) {
2010-04-26 21:05:58 -04:00
$current_tab = 'search' ;
}
$removed_args = array (
2010-05-03 16:26:11 -04:00
'action' ,
2010-04-26 21:05:58 -04:00
'customlink-tab' ,
'edit-menu-item' ,
'menu-item' ,
'page-tab' ,
'_wpnonce' ,
);
2019-07-01 08:52:01 -04:00
$most_recent_url = '' ;
$view_all_url = '' ;
$search_url = '' ;
2017-11-22 23:09:49 -05:00
if ( $nav_menu_selected_id ) {
2020-04-04 23:02:11 -04:00
$most_recent_url = esc_url ( add_query_arg ( $tab_name , 'most-recent' , remove_query_arg ( $removed_args ) ) );
$view_all_url = esc_url ( add_query_arg ( $tab_name , 'all' , remove_query_arg ( $removed_args ) ) );
$search_url = esc_url ( add_query_arg ( $tab_name , 'search' , remove_query_arg ( $removed_args ) ) );
2017-11-22 23:09:49 -05:00
}
2010-03-15 12:26:46 -04:00
?>
2010-04-26 21:05:58 -04:00
< div id = " posttype-<?php echo $post_type_name ; ?> " class = " posttypediv " >
< ul id = " posttype-<?php echo $post_type_name ; ?>-tabs " class = " posttype-tabs add-menu-item-tabs " >
2020-05-16 14:42:12 -04:00
< li < ? php echo ( 'most-recent' === $current_tab ? ' class="tabs"' : '' ); ?> >
2017-11-22 23:09:49 -05:00
< a class = " nav-tab-link " data - type = " tabs-panel-posttype-<?php echo esc_attr( $post_type_name ); ?>-most-recent " href = " <?php echo $most_recent_url ; ?>#tabs-panel-posttype-<?php echo $post_type_name ; ?>-most-recent " >
2013-03-15 09:16:38 -04:00
< ? php _e ( 'Most Recent' ); ?>
</ a >
</ li >
2020-05-16 14:42:12 -04:00
< li < ? php echo ( 'all' === $current_tab ? ' class="tabs"' : '' ); ?> >
2017-11-22 23:09:49 -05:00
< a class = " nav-tab-link " data - type = " <?php echo esc_attr( $post_type_name ); ?>-all " href = " <?php echo $view_all_url ; ?>#<?php echo $post_type_name ; ?>-all " >
2013-03-15 09:16:38 -04:00
< ? php _e ( 'View All' ); ?>
</ a >
</ li >
2020-05-16 14:42:12 -04:00
< li < ? php echo ( 'search' === $current_tab ? ' class="tabs"' : '' ); ?> >
2017-11-22 23:09:49 -05:00
< a class = " nav-tab-link " data - type = " tabs-panel-posttype-<?php echo esc_attr( $post_type_name ); ?>-search " href = " <?php echo $search_url ; ?>#tabs-panel-posttype-<?php echo $post_type_name ; ?>-search " >
2017-11-30 18:11:00 -05:00
< ? php _e ( 'Search' ); ?>
2013-03-15 09:16:38 -04:00
</ a >
</ li >
</ ul ><!-- . posttype - tabs -->
2010-04-26 21:05:58 -04:00
2022-11-14 06:50:15 -05:00
< div id = " tabs-panel-posttype-<?php echo $post_type_name ; ?>-most-recent " class = " tabs-panel <?php echo ( 'most-recent' === $current_tab ? 'tabs-panel-active' : 'tabs-panel-inactive' ); ?> " role = " region " aria - label = " <?php esc_attr_e( 'Most Recent' ); ?> " tabindex = " 0 " >
2010-05-21 19:32:45 -04:00
< ul id = " <?php echo $post_type_name ; ?>checklist-most-recent " class = " categorychecklist form-no-clear " >
< ? php
2017-11-30 18:11:00 -05:00
$recent_args = array_merge (
2018-08-16 21:51:36 -04:00
$args ,
array (
2017-11-30 18:11:00 -05:00
'orderby' => 'post_date' ,
'order' => 'DESC' ,
'posts_per_page' => 15 ,
)
);
$most_recent = $get_posts -> query ( $recent_args );
2010-05-21 19:32:45 -04:00
$args [ 'walker' ] = $walker ;
2015-06-18 07:35:28 -04:00
/**
2016-05-22 14:01:30 -04:00
* Filters the posts displayed in the 'Most Recent' tab of the current
2015-06-18 07:35:28 -04:00
* post type ' s menu items meta box .
*
2015-07-13 15:51:24 -04:00
* The dynamic portion of the hook name , `$post_type_name` , refers to the post type name .
*
2021-03-07 07:32:09 -05:00
* Possible hook names include :
*
* - `nav_menu_items_post_recent`
* - `nav_menu_items_page_recent`
*
2015-06-18 07:35:28 -04:00
* @ since 4.3 . 0
2017-10-19 09:05:55 -04:00
* @ since 4.9 . 0 Added the `$recent_args` parameter .
2015-06-18 07:35:28 -04:00
*
2018-02-09 12:26:31 -05:00
* @ param WP_Post [] $most_recent An array of post objects being listed .
* @ param array $args An array of `WP_Query` arguments for the meta box .
* @ param array $box Arguments passed to `wp_nav_menu_item_post_type_meta_box()` .
* @ param array $recent_args An array of `WP_Query` arguments for 'Most Recent' tab .
2015-06-18 07:35:28 -04:00
*/
2017-10-19 09:05:55 -04:00
$most_recent = apply_filters ( " nav_menu_items_ { $post_type_name } _recent " , $most_recent , $args , $box , $recent_args );
2015-06-18 07:35:28 -04:00
2017-10-19 09:05:55 -04:00
echo walk_nav_menu_tree ( array_map ( 'wp_setup_nav_menu_item' , $most_recent ), 0 , ( object ) $args );
2010-05-21 19:32:45 -04:00
?>
</ ul >
</ div ><!-- /. tabs - panel -->
2020-05-16 14:42:12 -04:00
< div class = " tabs-panel <?php echo ( 'search' === $current_tab ? 'tabs-panel-active' : 'tabs-panel-inactive' ); ?> " id = " tabs-panel-posttype-<?php echo $post_type_name ; ?>-search " role = " region " aria - label = " <?php echo $post_type->labels ->search_items; ?> " tabindex = " 0 " >
2010-05-03 16:26:11 -04:00
< ? php
2017-11-30 18:11:00 -05:00
if ( isset ( $_REQUEST [ 'quick-search-posttype-' . $post_type_name ] ) ) {
$searched = esc_attr ( $_REQUEST [ 'quick-search-posttype-' . $post_type_name ] );
$search_results = get_posts (
array (
's' => $searched ,
'post_type' => $post_type_name ,
'fields' => 'all' ,
'order' => 'DESC' ,
)
);
2010-04-26 21:05:58 -04:00
} else {
2017-11-30 18:11:00 -05:00
$searched = '' ;
2010-04-26 21:05:58 -04:00
$search_results = array ();
}
?>
< p class = " quick-search-wrap " >
I18N: Mark screen reader strings as such with translator comments.
This aims to provide better context for translators and make it easier to determine that some strings contain hidden accessibility text and are not displayed in the UI.
Props kebbet, mercime, pavelevap, ocean90, swissspidy, Chouby, jipmoors, afercia, desrosj, costdev, audrasjb, SergeyBiryukov.
Fixes #29748.
Built from https://develop.svn.wordpress.org/trunk@55276
git-svn-id: http://core.svn.wordpress.org/trunk@54809 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2023-02-07 12:10:21 -05:00
< label for = " quick-search-posttype-<?php echo $post_type_name ; ?> " class = " screen-reader-text " >
< ? php
/* translators: Hidden accessibility text. */
_e ( 'Search' );
?>
</ label >
2019-12-09 08:49:03 -05:00
< input type = " search " < ? php wp_nav_menu_disabled_check ( $nav_menu_selected_id ); ?> class="quick-search" value="<?php echo $searched; ?>" name="quick-search-posttype-<?php echo $post_type_name; ?>" id="quick-search-posttype-<?php echo $post_type_name; ?>" />
2012-09-26 15:57:44 -04:00
< span class = " spinner " ></ span >
2016-09-28 15:54:28 -04:00
< ? php submit_button ( __ ( 'Search' ), 'small quick-search-submit hide-if-js' , 'submit' , false , array ( 'id' => 'submit-quick-search-posttype-' . $post_type_name ) ); ?>
2010-04-26 21:05:58 -04:00
</ p >
2017-11-30 18:11:00 -05:00
< ul id = " <?php echo $post_type_name ; ?>-search-checklist " data - wp - lists = " list:<?php echo $post_type_name ; ?> " class = " categorychecklist form-no-clear " >
2010-04-26 21:05:58 -04:00
< ? php if ( ! empty ( $search_results ) && ! is_wp_error ( $search_results ) ) : ?>
< ? php
2010-05-21 19:32:45 -04:00
$args [ 'walker' ] = $walker ;
2017-11-30 18:11:00 -05:00
echo walk_nav_menu_tree ( array_map ( 'wp_setup_nav_menu_item' , $search_results ), 0 , ( object ) $args );
2010-04-26 21:05:58 -04:00
?>
2010-04-28 16:44:08 -04:00
< ? php elseif ( is_wp_error ( $search_results ) ) : ?>
< li >< ? php echo $search_results -> get_error_message (); ?> </li>
< ? php elseif ( ! empty ( $searched ) ) : ?>
2017-11-30 18:11:00 -05:00
< li >< ? php _e ( 'No results found.' ); ?> </li>
2010-04-26 21:05:58 -04:00
< ? php endif ; ?>
2010-03-15 12:26:46 -04:00
</ ul >
2010-04-26 21:05:58 -04:00
</ div ><!-- /. tabs - panel -->
2020-05-16 14:42:12 -04:00
< div id = " <?php echo $post_type_name ; ?>-all " class = " tabs-panel tabs-panel-view-all <?php echo ( 'all' === $current_tab ? 'tabs-panel-active' : 'tabs-panel-inactive' ); ?> " role = " region " aria - label = " <?php echo $post_type->labels ->all_items; ?> " tabindex = " 0 " >
2010-05-23 03:43:07 -04:00
< ? php if ( ! empty ( $page_links ) ) : ?>
< div class = " add-menu-item-pagelinks " >
< ? php echo $page_links ; ?>
</ div >
< ? php endif ; ?>
2017-11-30 18:11:00 -05:00
< ul id = " <?php echo $post_type_name ; ?>checklist " data - wp - lists = " list:<?php echo $post_type_name ; ?> " class = " categorychecklist form-no-clear " >
2010-04-26 21:05:58 -04:00
< ? php
2010-05-21 19:32:45 -04:00
$args [ 'walker' ] = $walker ;
2010-06-02 16:04:07 -04:00
2015-10-24 13:46:25 -04:00
if ( $post_type -> has_archive ) {
2020-10-08 17:15:13 -04:00
$_nav_menu_placeholder = ( 0 > $_nav_menu_placeholder ) ? ( int ) $_nav_menu_placeholder - 1 : - 1 ;
2017-11-30 18:11:00 -05:00
array_unshift (
2018-08-16 21:51:36 -04:00
$posts ,
( object ) array (
2017-11-30 18:11:00 -05:00
'ID' => 0 ,
'object_id' => $_nav_menu_placeholder ,
'object' => $post_type_name ,
'post_content' => '' ,
'post_excerpt' => '' ,
'post_title' => $post_type -> labels -> archives ,
'post_type' => 'nav_menu_item' ,
'type' => 'post_type_archive' ,
'url' => get_post_type_archive_link ( $post_type_name ),
)
);
2015-10-24 13:46:25 -04:00
}
2013-10-26 13:48:11 -04:00
/**
2016-05-22 14:01:30 -04:00
* Filters the posts displayed in the 'View All' tab of the current
2013-10-26 13:48:11 -04:00
* post type ' s menu items meta box .
*
2014-11-30 06:28:24 -05:00
* The dynamic portion of the hook name , `$post_type_name` , refers
* to the slug of the current post type .
2013-10-26 13:48:11 -04:00
*
2021-03-07 07:32:09 -05:00
* Possible hook names include :
*
* - `nav_menu_items_post`
* - `nav_menu_items_page`
*
2013-10-26 13:48:11 -04:00
* @ since 3.2 . 0
2016-07-13 11:24:28 -04:00
* @ since 4.6 . 0 Converted the `$post_type` parameter to accept a WP_Post_Type object .
2013-10-26 13:48:11 -04:00
*
* @ see WP_Query :: query ()
*
2018-02-09 12:26:31 -05:00
* @ param object [] $posts The posts for the current post type . Mostly `WP_Post` objects , but
* can also contain " fake " post objects to represent other menu items .
* @ param array $args An array of `WP_Query` arguments .
2016-06-28 12:41:35 -04:00
* @ param WP_Post_Type $post_type The current post type object for this menu item meta box .
2013-10-26 13:48:11 -04:00
*/
$posts = apply_filters ( " nav_menu_items_ { $post_type_name } " , $posts , $args , $post_type );
2016-07-13 11:24:28 -04:00
2017-11-30 18:11:00 -05:00
$checkbox_items = walk_nav_menu_tree ( array_map ( 'wp_setup_nav_menu_item' , $posts ), 0 , ( object ) $args );
2010-04-26 21:05:58 -04:00
echo $checkbox_items ;
?>
</ ul >
2010-05-23 03:43:07 -04:00
< ? php if ( ! empty ( $page_links ) ) : ?>
< div class = " add-menu-item-pagelinks " >
< ? php echo $page_links ; ?>
</ div >
< ? php endif ; ?>
2010-04-26 21:05:58 -04:00
</ div ><!-- /. tabs - panel -->
2019-09-23 08:42:58 -04:00
< p class = " button-controls wp-clearfix " data - items - type = " posttype-<?php echo esc_attr( $post_type_name ); ?> " >
< span class = " list-controls hide-if-no-js " >
2020-04-04 23:02:11 -04:00
< input type = " checkbox " < ? php wp_nav_menu_disabled_check ( $nav_menu_selected_id ); ?> id="<?php echo esc_attr( $tab_name ); ?>" class="select-all" />
< label for = " <?php echo esc_attr( $tab_name ); ?> " >< ? php _e ( 'Select All' ); ?> </label>
2010-04-26 21:05:58 -04:00
</ span >
< span class = " add-to-menu " >
2016-09-28 15:54:28 -04:00
< input type = " submit " < ? php wp_nav_menu_disabled_check ( $nav_menu_selected_id ); ?> class="button submit-add-to-menu right" value="<?php esc_attr_e( 'Add to Menu' ); ?>" name="add-post-type-menu-item" id="<?php echo esc_attr( 'submit-posttype-' . $post_type_name ); ?>" />
2012-09-26 15:57:44 -04:00
< span class = " spinner " ></ span >
2010-04-26 21:05:58 -04:00
</ span >
</ p >
</ div ><!-- /. posttypediv -->
2010-03-15 12:26:46 -04:00
< ? php
2010-02-24 03:06:36 -05:00
}
2010-02-28 15:00:49 -05:00
/**
2016-07-09 20:56:28 -04:00
* Displays a meta box for a taxonomy menu item .
2010-02-28 15:00:49 -05:00
*
* @ since 3.0 . 0
*
2015-05-28 17:41:30 -04:00
* @ global int | string $nav_menu_selected_id
*
Code Modernization: Rename parameters that use reserved keywords in `wp-admin/includes/template.php`.
While using reserved PHP keywords as parameter name labels is allowed, in the context of function calls using named parameters in PHP 8.0+, this will easily lead to confusion. To avoid that, it is recommended not to use reserved keywords as function parameter names.
This commit:
* Renames the `$echo` parameter to `$display` in:
* `wp_popular_terms_checklist()`
* `_post_states()`
* `_media_states()`
* Renames the `$default` parameter to `$default_term` in `wp_popular_terms_checklist()`.
* Renames the `$default` parameter to `$default_template` in `page_template_dropdown()`.
* Renames the `$default` parameter to `$default_page` in `parent_dropdown()`.
* Renames the `$object` parameter to `$data_object` in:
* `do_block_editor_incompatible_meta_box()`
* `do_meta_boxes()`
* `do_accordion_sections()`
* Amends the `$item_object` parameter in other functions for consistency:
* `wp_nav_menu_item_post_type_meta_box()`
* `wp_nav_menu_item_taxonomy_meta_box()`
* `_wp_nav_menu_meta_box_object()`
Follow-up to [52946], [52996], [52997], [52998], [53003], [53014], [53029], [53039], [53116], [53117], [53137], [53174], [53184], [53185], [53192], [53193], [53198], [53203], [53207], [53215], [53216].
Props jrf, aristath, poena, justinahinon, SergeyBiryukov.
See #55327.
Built from https://develop.svn.wordpress.org/trunk@53220
git-svn-id: http://core.svn.wordpress.org/trunk@52809 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-04-19 11:13:08 -04:00
* @ param string $data_object Not used .
2016-07-21 15:21:28 -04:00
* @ param array $box {
2016-07-22 12:50:28 -04:00
* Taxonomy menu item meta box arguments .
2016-07-21 14:01:29 -04:00
*
2020-07-14 07:56:04 -04:00
* @ type string $id Meta box 'id' attribute .
* @ type string $title Meta box title .
* @ type callable $callback Meta box display callback .
* @ type object $args Extra meta box arguments ( the taxonomy object for this meta box ) .
2016-07-21 14:01:29 -04:00
* }
2010-02-28 15:00:49 -05:00
*/
Code Modernization: Rename parameters that use reserved keywords in `wp-admin/includes/template.php`.
While using reserved PHP keywords as parameter name labels is allowed, in the context of function calls using named parameters in PHP 8.0+, this will easily lead to confusion. To avoid that, it is recommended not to use reserved keywords as function parameter names.
This commit:
* Renames the `$echo` parameter to `$display` in:
* `wp_popular_terms_checklist()`
* `_post_states()`
* `_media_states()`
* Renames the `$default` parameter to `$default_term` in `wp_popular_terms_checklist()`.
* Renames the `$default` parameter to `$default_template` in `page_template_dropdown()`.
* Renames the `$default` parameter to `$default_page` in `parent_dropdown()`.
* Renames the `$object` parameter to `$data_object` in:
* `do_block_editor_incompatible_meta_box()`
* `do_meta_boxes()`
* `do_accordion_sections()`
* Amends the `$item_object` parameter in other functions for consistency:
* `wp_nav_menu_item_post_type_meta_box()`
* `wp_nav_menu_item_taxonomy_meta_box()`
* `_wp_nav_menu_meta_box_object()`
Follow-up to [52946], [52996], [52997], [52998], [53003], [53014], [53029], [53039], [53116], [53117], [53137], [53174], [53184], [53185], [53192], [53193], [53198], [53203], [53207], [53215], [53216].
Props jrf, aristath, poena, justinahinon, SergeyBiryukov.
See #55327.
Built from https://develop.svn.wordpress.org/trunk@53220
git-svn-id: http://core.svn.wordpress.org/trunk@52809 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-04-19 11:13:08 -04:00
function wp_nav_menu_item_taxonomy_meta_box ( $data_object , $box ) {
2010-05-29 16:33:48 -04:00
global $nav_menu_selected_id ;
2020-02-07 16:38:06 -05:00
2016-07-21 15:21:28 -04:00
$taxonomy_name = $box [ 'args' ] -> name ;
2017-11-30 18:11:00 -05:00
$taxonomy = get_taxonomy ( $taxonomy_name );
2020-04-04 23:02:11 -04:00
$tab_name = $taxonomy_name . '-tab' ;
2010-05-25 22:42:15 -04:00
2014-07-17 05:14:16 -04:00
// Paginate browsing for large numbers of objects.
2010-05-06 10:09:10 -04:00
$per_page = 50 ;
2020-04-04 23:02:11 -04:00
$pagenum = isset ( $_REQUEST [ $tab_name ] ) && isset ( $_REQUEST [ 'paged' ] ) ? absint ( $_REQUEST [ 'paged' ] ) : 1 ;
2017-11-30 18:11:00 -05:00
$offset = 0 < $pagenum ? $per_page * ( $pagenum - 1 ) : 0 ;
2010-04-29 02:01:44 -04:00
2010-03-15 12:26:46 -04:00
$args = array (
2019-08-02 23:35:56 -04:00
'taxonomy' => $taxonomy_name ,
2017-11-30 18:11:00 -05:00
'child_of' => 0 ,
'exclude' => '' ,
'hide_empty' => false ,
2010-05-03 16:26:11 -04:00
'hierarchical' => 1 ,
2017-11-30 18:11:00 -05:00
'include' => '' ,
'number' => $per_page ,
'offset' => $offset ,
'order' => 'ASC' ,
'orderby' => 'name' ,
'pad_counts' => false ,
2010-03-15 12:26:46 -04:00
);
2010-03-17 02:10:47 -04:00
2019-08-02 23:35:56 -04:00
$terms = get_terms ( $args );
2010-05-11 14:55:12 -04:00
2017-11-30 18:11:00 -05:00
if ( ! $terms || is_wp_error ( $terms ) ) {
2010-05-11 14:55:12 -04:00
echo '<p>' . __ ( 'No items.' ) . '</p>' ;
return ;
}
2017-11-30 18:11:00 -05:00
$num_pages = ceil (
wp_count_terms (
2018-08-16 21:51:36 -04:00
array_merge (
$args ,
array (
2017-11-30 18:11:00 -05:00
'number' => '' ,
'offset' => '' ,
)
2010-04-26 21:05:58 -04:00
)
2017-11-30 18:11:00 -05:00
) / $per_page
);
$page_links = paginate_links (
array (
'base' => add_query_arg (
array (
2020-04-04 23:02:11 -04:00
$tab_name => 'all' ,
'paged' => '%#%' ,
'item-type' => 'taxonomy' ,
'item-object' => $taxonomy_name ,
2017-11-30 18:11:00 -05:00
)
),
'format' => '' ,
'prev_text' => '<span aria-label="' . esc_attr__ ( 'Previous page' ) . '">' . __ ( '«' ) . '</span>' ,
'next_text' => '<span aria-label="' . esc_attr__ ( 'Next page' ) . '">' . __ ( '»' ) . '</span>' ,
I18N: Mark screen reader strings as such with translator comments.
This aims to provide better context for translators and make it easier to determine that some strings contain hidden accessibility text and are not displayed in the UI.
Props kebbet, mercime, pavelevap, ocean90, swissspidy, Chouby, jipmoors, afercia, desrosj, costdev, audrasjb, SergeyBiryukov.
Fixes #29748.
Built from https://develop.svn.wordpress.org/trunk@55276
git-svn-id: http://core.svn.wordpress.org/trunk@54809 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2023-02-07 12:10:21 -05:00
/* translators: Hidden accessibility text. */
2017-11-30 18:11:00 -05:00
'before_page_number' => '<span class="screen-reader-text">' . __ ( 'Page' ) . '</span> ' ,
'total' => $num_pages ,
'current' => $pagenum ,
)
);
2010-05-03 16:26:11 -04:00
2011-05-04 14:59:40 -04:00
$db_fields = false ;
if ( is_taxonomy_hierarchical ( $taxonomy_name ) ) {
2017-11-30 18:11:00 -05:00
$db_fields = array (
'parent' => 'parent' ,
'id' => 'term_id' ,
);
2011-05-04 14:59:40 -04:00
}
$walker = new Walker_Nav_Menu_Checklist ( $db_fields );
2010-03-17 12:27:25 -04:00
2010-04-26 21:05:58 -04:00
$current_tab = 'most-used' ;
2020-04-04 23:02:11 -04:00
if ( isset ( $_REQUEST [ $tab_name ] ) && in_array ( $_REQUEST [ $tab_name ], array ( 'all' , 'most-used' , 'search' ), true ) ) {
$current_tab = $_REQUEST [ $tab_name ];
2010-04-26 21:05:58 -04:00
}
2017-11-30 18:11:00 -05:00
if ( ! empty ( $_REQUEST [ 'quick-search-taxonomy-' . $taxonomy_name ] ) ) {
2010-04-26 21:05:58 -04:00
$current_tab = 'search' ;
2010-02-24 03:06:36 -05:00
}
2010-03-17 12:27:25 -04:00
2010-04-26 21:05:58 -04:00
$removed_args = array (
2010-05-03 16:26:11 -04:00
'action' ,
2010-04-26 21:05:58 -04:00
'customlink-tab' ,
'edit-menu-item' ,
'menu-item' ,
'page-tab' ,
'_wpnonce' ,
);
2019-07-01 08:52:01 -04:00
$most_used_url = '' ;
$view_all_url = '' ;
$search_url = '' ;
2017-11-22 23:09:49 -05:00
if ( $nav_menu_selected_id ) {
2020-04-04 23:02:11 -04:00
$most_used_url = esc_url ( add_query_arg ( $tab_name , 'most-used' , remove_query_arg ( $removed_args ) ) );
$view_all_url = esc_url ( add_query_arg ( $tab_name , 'all' , remove_query_arg ( $removed_args ) ) );
$search_url = esc_url ( add_query_arg ( $tab_name , 'search' , remove_query_arg ( $removed_args ) ) );
2017-11-22 23:09:49 -05:00
}
2010-03-15 12:26:46 -04:00
?>
2010-04-26 21:05:58 -04:00
< div id = " taxonomy-<?php echo $taxonomy_name ; ?> " class = " taxonomydiv " >
< ul id = " taxonomy-<?php echo $taxonomy_name ; ?>-tabs " class = " taxonomy-tabs add-menu-item-tabs " >
2020-05-16 14:42:12 -04:00
< li < ? php echo ( 'most-used' === $current_tab ? ' class="tabs"' : '' ); ?> >
2017-11-22 23:09:49 -05:00
< a class = " nav-tab-link " data - type = " tabs-panel-<?php echo esc_attr( $taxonomy_name ); ?>-pop " href = " <?php echo $most_used_url ; ?>#tabs-panel-<?php echo $taxonomy_name ; ?>-pop " >
2017-10-24 07:23:24 -04:00
< ? php echo esc_html ( $taxonomy -> labels -> most_used ); ?>
2013-03-15 09:16:38 -04:00
</ a >
</ li >
2020-05-16 14:42:12 -04:00
< li < ? php echo ( 'all' === $current_tab ? ' class="tabs"' : '' ); ?> >
2017-11-22 23:09:49 -05:00
< a class = " nav-tab-link " data - type = " tabs-panel-<?php echo esc_attr( $taxonomy_name ); ?>-all " href = " <?php echo $view_all_url ; ?>#tabs-panel-<?php echo $taxonomy_name ; ?>-all " >
2013-03-15 09:16:38 -04:00
< ? php _e ( 'View All' ); ?>
</ a >
</ li >
2020-05-16 14:42:12 -04:00
< li < ? php echo ( 'search' === $current_tab ? ' class="tabs"' : '' ); ?> >
2017-11-22 23:09:49 -05:00
< a class = " nav-tab-link " data - type = " tabs-panel-search-taxonomy-<?php echo esc_attr( $taxonomy_name ); ?> " href = " <?php echo $search_url ; ?>#tabs-panel-search-taxonomy-<?php echo $taxonomy_name ; ?> " >
2013-03-15 09:16:38 -04:00
< ? php _e ( 'Search' ); ?>
</ a >
</ li >
</ ul ><!-- . taxonomy - tabs -->
2010-04-26 21:05:58 -04:00
2020-05-16 14:42:12 -04:00
< div id = " tabs-panel-<?php echo $taxonomy_name ; ?>-pop " class = " tabs-panel <?php echo ( 'most-used' === $current_tab ? 'tabs-panel-active' : 'tabs-panel-inactive' ); ?> " role = " region " aria - label = " <?php echo $taxonomy->labels ->most_used; ?> " tabindex = " 0 " >
2010-04-26 21:05:58 -04:00
< ul id = " <?php echo $taxonomy_name ; ?>checklist-pop " class = " categorychecklist form-no-clear " >
< ? php
2017-11-30 18:11:00 -05:00
$popular_terms = get_terms (
2018-08-16 21:51:36 -04:00
array (
2019-08-02 23:35:56 -04:00
'taxonomy' => $taxonomy_name ,
2017-11-30 18:11:00 -05:00
'orderby' => 'count' ,
'order' => 'DESC' ,
'number' => 10 ,
'hierarchical' => false ,
)
);
2010-04-26 21:05:58 -04:00
$args [ 'walker' ] = $walker ;
2017-11-30 18:11:00 -05:00
echo walk_nav_menu_tree ( array_map ( 'wp_setup_nav_menu_item' , $popular_terms ), 0 , ( object ) $args );
2010-04-26 21:05:58 -04:00
?>
2010-03-15 12:26:46 -04:00
</ ul >
2010-04-26 21:05:58 -04:00
</ div ><!-- /. tabs - panel -->
2020-05-16 14:42:12 -04:00
< div id = " tabs-panel-<?php echo $taxonomy_name ; ?>-all " class = " tabs-panel tabs-panel-view-all <?php echo ( 'all' === $current_tab ? 'tabs-panel-active' : 'tabs-panel-inactive' ); ?> " role = " region " aria - label = " <?php echo $taxonomy->labels ->all_items; ?> " tabindex = " 0 " >
2010-05-28 16:36:57 -04:00
< ? php if ( ! empty ( $page_links ) ) : ?>
< div class = " add-menu-item-pagelinks " >
< ? php echo $page_links ; ?>
</ div >
< ? php endif ; ?>
2017-11-30 18:11:00 -05:00
< ul id = " <?php echo $taxonomy_name ; ?>checklist " data - wp - lists = " list:<?php echo $taxonomy_name ; ?> " class = " categorychecklist form-no-clear " >
2010-05-28 16:36:57 -04:00
< ? php
$args [ 'walker' ] = $walker ;
2017-11-30 18:11:00 -05:00
echo walk_nav_menu_tree ( array_map ( 'wp_setup_nav_menu_item' , $terms ), 0 , ( object ) $args );
2010-05-28 16:36:57 -04:00
?>
</ ul >
< ? php if ( ! empty ( $page_links ) ) : ?>
< div class = " add-menu-item-pagelinks " >
< ? php echo $page_links ; ?>
</ div >
< ? php endif ; ?>
</ div ><!-- /. tabs - panel -->
2020-05-16 14:42:12 -04:00
< div class = " tabs-panel <?php echo ( 'search' === $current_tab ? 'tabs-panel-active' : 'tabs-panel-inactive' ); ?> " id = " tabs-panel-search-taxonomy-<?php echo $taxonomy_name ; ?> " role = " region " aria - label = " <?php echo $taxonomy->labels ->search_items; ?> " tabindex = " 0 " >
2010-05-03 16:26:11 -04:00
< ? php
2017-11-30 18:11:00 -05:00
if ( isset ( $_REQUEST [ 'quick-search-taxonomy-' . $taxonomy_name ] ) ) {
$searched = esc_attr ( $_REQUEST [ 'quick-search-taxonomy-' . $taxonomy_name ] );
$search_results = get_terms (
2018-08-16 21:51:36 -04:00
array (
2019-08-02 23:35:56 -04:00
'taxonomy' => $taxonomy_name ,
2017-11-30 18:11:00 -05:00
'name__like' => $searched ,
'fields' => 'all' ,
'orderby' => 'count' ,
'order' => 'DESC' ,
'hierarchical' => false ,
)
);
2010-04-26 21:05:58 -04:00
} else {
2017-11-30 18:11:00 -05:00
$searched = '' ;
2010-04-26 21:05:58 -04:00
$search_results = array ();
}
?>
< p class = " quick-search-wrap " >
I18N: Mark screen reader strings as such with translator comments.
This aims to provide better context for translators and make it easier to determine that some strings contain hidden accessibility text and are not displayed in the UI.
Props kebbet, mercime, pavelevap, ocean90, swissspidy, Chouby, jipmoors, afercia, desrosj, costdev, audrasjb, SergeyBiryukov.
Fixes #29748.
Built from https://develop.svn.wordpress.org/trunk@55276
git-svn-id: http://core.svn.wordpress.org/trunk@54809 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2023-02-07 12:10:21 -05:00
< label for = " quick-search-taxonomy-<?php echo $taxonomy_name ; ?> " class = " screen-reader-text " >
< ? php
/* translators: Hidden accessibility text. */
_e ( 'Search' );
?>
</ label >
2016-01-22 09:26:27 -05:00
< input type = " search " class = " quick-search " value = " <?php echo $searched ; ?> " name = " quick-search-taxonomy-<?php echo $taxonomy_name ; ?> " id = " quick-search-taxonomy-<?php echo $taxonomy_name ; ?> " />
2012-09-26 15:57:44 -04:00
< span class = " spinner " ></ span >
2016-09-28 15:54:28 -04:00
< ? php submit_button ( __ ( 'Search' ), 'small quick-search-submit hide-if-js' , 'submit' , false , array ( 'id' => 'submit-quick-search-taxonomy-' . $taxonomy_name ) ); ?>
2010-04-26 21:05:58 -04:00
</ p >
2010-05-03 16:26:11 -04:00
2017-11-30 18:11:00 -05:00
< ul id = " <?php echo $taxonomy_name ; ?>-search-checklist " data - wp - lists = " list:<?php echo $taxonomy_name ; ?> " class = " categorychecklist form-no-clear " >
2010-04-26 21:05:58 -04:00
< ? php if ( ! empty ( $search_results ) && ! is_wp_error ( $search_results ) ) : ?>
< ? php
$args [ 'walker' ] = $walker ;
2017-11-30 18:11:00 -05:00
echo walk_nav_menu_tree ( array_map ( 'wp_setup_nav_menu_item' , $search_results ), 0 , ( object ) $args );
2010-04-26 21:05:58 -04:00
?>
2010-04-28 16:44:08 -04:00
< ? php elseif ( is_wp_error ( $search_results ) ) : ?>
< li >< ? php echo $search_results -> get_error_message (); ?> </li>
< ? php elseif ( ! empty ( $searched ) ) : ?>
2017-11-30 18:11:00 -05:00
< li >< ? php _e ( 'No results found.' ); ?> </li>
2010-04-26 21:05:58 -04:00
< ? php endif ; ?>
</ ul >
</ div ><!-- /. tabs - panel -->
2019-09-23 08:42:58 -04:00
< p class = " button-controls wp-clearfix " data - items - type = " taxonomy-<?php echo esc_attr( $taxonomy_name ); ?> " >
< span class = " list-controls hide-if-no-js " >
2020-04-04 23:02:11 -04:00
< input type = " checkbox " < ? php wp_nav_menu_disabled_check ( $nav_menu_selected_id ); ?> id="<?php echo esc_attr( $tab_name ); ?>" class="select-all" />
< label for = " <?php echo esc_attr( $tab_name ); ?> " >< ? php _e ( 'Select All' ); ?> </label>
2010-04-26 21:05:58 -04:00
</ span >
< span class = " add-to-menu " >
2016-09-28 15:54:28 -04:00
< input type = " submit " < ? php wp_nav_menu_disabled_check ( $nav_menu_selected_id ); ?> class="button submit-add-to-menu right" value="<?php esc_attr_e( 'Add to Menu' ); ?>" name="add-taxonomy-menu-item" id="<?php echo esc_attr( 'submit-taxonomy-' . $taxonomy_name ); ?>" />
2012-09-26 15:57:44 -04:00
< span class = " spinner " ></ span >
2010-04-26 21:05:58 -04:00
</ span >
</ p >
</ div ><!-- /. taxonomydiv -->
2010-03-15 12:26:46 -04:00
< ? php
2010-02-24 03:06:36 -05:00
}
2010-02-28 15:00:49 -05:00
/**
2010-04-26 21:05:58 -04:00
* Save posted nav menu item data .
2010-02-28 15:00:49 -05:00
*
* @ since 3.0 . 0
*
2018-02-09 12:26:31 -05:00
* @ param int $menu_id The menu ID for which to save this item . Value of 0 makes a draft , orphaned menu item . Default 0.
* @ param array [] $menu_data The unsanitized POSTed menu item data .
* @ return int [] The database IDs of the items saved
2010-02-28 15:00:49 -05:00
*/
2010-05-19 01:59:43 -04:00
function wp_save_nav_menu_items ( $menu_id = 0 , $menu_data = array () ) {
2017-11-30 18:11:00 -05:00
$menu_id = ( int ) $menu_id ;
2010-04-26 21:05:58 -04:00
$items_saved = array ();
2010-05-27 18:22:09 -04:00
if ( 0 == $menu_id || is_nav_menu ( $menu_id ) ) {
2010-04-26 21:05:58 -04:00
2014-07-17 05:14:16 -04:00
// Loop through all the menu items' POST values.
2015-08-25 16:28:22 -04:00
foreach ( ( array ) $menu_data as $_possible_db_id => $_item_object_data ) {
2010-05-03 16:26:11 -04:00
if (
2014-07-17 05:14:16 -04:00
// Checkbox is not checked.
empty ( $_item_object_data [ 'menu-item-object-id' ] ) &&
2010-05-03 16:26:11 -04:00
(
2014-07-17 05:14:16 -04:00
// And item type either isn't set.
! isset ( $_item_object_data [ 'menu-item-type' ] ) ||
// Or URL is the default.
2020-04-04 23:02:11 -04:00
in_array ( $_item_object_data [ 'menu-item-url' ], array ( 'https://' , 'http://' , '' ), true ) ||
2020-01-28 19:35:08 -05:00
// Or it's not a custom menu item (but not the custom home page).
2020-05-16 14:42:12 -04:00
! ( 'custom' === $_item_object_data [ 'menu-item-type' ] && ! isset ( $_item_object_data [ 'menu-item-db-id' ] ) ) ||
2014-07-17 05:14:16 -04:00
// Or it *is* a custom menu item that already exists.
! empty ( $_item_object_data [ 'menu-item-db-id' ] )
2010-04-26 21:05:58 -04:00
)
) {
2014-07-17 05:14:16 -04:00
// Then this potential menu item is not getting added to this menu.
continue ;
2010-04-26 21:05:58 -04:00
}
2014-07-17 05:14:16 -04:00
// If this possible menu item doesn't actually have a menu database ID yet.
2010-05-03 16:26:11 -04:00
if (
2010-04-26 21:05:58 -04:00
empty ( $_item_object_data [ 'menu-item-db-id' ] ) ||
( 0 > $_possible_db_id ) ||
$_possible_db_id != $_item_object_data [ 'menu-item-db-id' ]
) {
$_actual_db_id = 0 ;
} else {
$_actual_db_id = ( int ) $_item_object_data [ 'menu-item-db-id' ];
}
2010-05-03 16:26:11 -04:00
2010-04-26 21:05:58 -04:00
$args = array (
2017-11-30 18:11:00 -05:00
'menu-item-db-id' => ( isset ( $_item_object_data [ 'menu-item-db-id' ] ) ? $_item_object_data [ 'menu-item-db-id' ] : '' ),
'menu-item-object-id' => ( isset ( $_item_object_data [ 'menu-item-object-id' ] ) ? $_item_object_data [ 'menu-item-object-id' ] : '' ),
'menu-item-object' => ( isset ( $_item_object_data [ 'menu-item-object' ] ) ? $_item_object_data [ 'menu-item-object' ] : '' ),
'menu-item-parent-id' => ( isset ( $_item_object_data [ 'menu-item-parent-id' ] ) ? $_item_object_data [ 'menu-item-parent-id' ] : '' ),
'menu-item-position' => ( isset ( $_item_object_data [ 'menu-item-position' ] ) ? $_item_object_data [ 'menu-item-position' ] : '' ),
'menu-item-type' => ( isset ( $_item_object_data [ 'menu-item-type' ] ) ? $_item_object_data [ 'menu-item-type' ] : '' ),
'menu-item-title' => ( isset ( $_item_object_data [ 'menu-item-title' ] ) ? $_item_object_data [ 'menu-item-title' ] : '' ),
'menu-item-url' => ( isset ( $_item_object_data [ 'menu-item-url' ] ) ? $_item_object_data [ 'menu-item-url' ] : '' ),
2010-04-26 21:05:58 -04:00
'menu-item-description' => ( isset ( $_item_object_data [ 'menu-item-description' ] ) ? $_item_object_data [ 'menu-item-description' ] : '' ),
2017-11-30 18:11:00 -05:00
'menu-item-attr-title' => ( isset ( $_item_object_data [ 'menu-item-attr-title' ] ) ? $_item_object_data [ 'menu-item-attr-title' ] : '' ),
'menu-item-target' => ( isset ( $_item_object_data [ 'menu-item-target' ] ) ? $_item_object_data [ 'menu-item-target' ] : '' ),
'menu-item-classes' => ( isset ( $_item_object_data [ 'menu-item-classes' ] ) ? $_item_object_data [ 'menu-item-classes' ] : '' ),
'menu-item-xfn' => ( isset ( $_item_object_data [ 'menu-item-xfn' ] ) ? $_item_object_data [ 'menu-item-xfn' ] : '' ),
2010-04-26 21:05:58 -04:00
);
$items_saved [] = wp_update_nav_menu_item ( $menu_id , $_actual_db_id , $args );
2010-03-15 12:26:46 -04:00
}
2010-02-24 03:06:36 -05:00
}
2010-04-26 21:05:58 -04:00
return $items_saved ;
2010-03-15 12:26:46 -04:00
}
2010-02-24 03:06:36 -05:00
2010-04-28 14:30:32 -04:00
/**
* Adds custom arguments to some of the meta box object types .
*
* @ since 3.0 . 0
2010-05-03 16:26:11 -04:00
*
2010-04-28 14:30:32 -04:00
* @ access private
*
Code Modernization: Rename parameters that use reserved keywords in `wp-admin/includes/template.php`.
While using reserved PHP keywords as parameter name labels is allowed, in the context of function calls using named parameters in PHP 8.0+, this will easily lead to confusion. To avoid that, it is recommended not to use reserved keywords as function parameter names.
This commit:
* Renames the `$echo` parameter to `$display` in:
* `wp_popular_terms_checklist()`
* `_post_states()`
* `_media_states()`
* Renames the `$default` parameter to `$default_term` in `wp_popular_terms_checklist()`.
* Renames the `$default` parameter to `$default_template` in `page_template_dropdown()`.
* Renames the `$default` parameter to `$default_page` in `parent_dropdown()`.
* Renames the `$object` parameter to `$data_object` in:
* `do_block_editor_incompatible_meta_box()`
* `do_meta_boxes()`
* `do_accordion_sections()`
* Amends the `$item_object` parameter in other functions for consistency:
* `wp_nav_menu_item_post_type_meta_box()`
* `wp_nav_menu_item_taxonomy_meta_box()`
* `_wp_nav_menu_meta_box_object()`
Follow-up to [52946], [52996], [52997], [52998], [53003], [53014], [53029], [53039], [53116], [53117], [53137], [53174], [53184], [53185], [53192], [53193], [53198], [53203], [53207], [53215], [53216].
Props jrf, aristath, poena, justinahinon, SergeyBiryukov.
See #55327.
Built from https://develop.svn.wordpress.org/trunk@53220
git-svn-id: http://core.svn.wordpress.org/trunk@52809 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-04-19 11:13:08 -04:00
* @ param object $data_object The post type or taxonomy meta - object .
2019-12-07 08:23:01 -05:00
* @ return object The post type or taxonomy object .
2010-04-28 14:30:32 -04:00
*/
2022-04-19 11:59:10 -04:00
function _wp_nav_menu_meta_box_object ( $data_object = null ) {
Code Modernization: Rename parameters that use reserved keywords in `wp-admin/includes/template.php`.
While using reserved PHP keywords as parameter name labels is allowed, in the context of function calls using named parameters in PHP 8.0+, this will easily lead to confusion. To avoid that, it is recommended not to use reserved keywords as function parameter names.
This commit:
* Renames the `$echo` parameter to `$display` in:
* `wp_popular_terms_checklist()`
* `_post_states()`
* `_media_states()`
* Renames the `$default` parameter to `$default_term` in `wp_popular_terms_checklist()`.
* Renames the `$default` parameter to `$default_template` in `page_template_dropdown()`.
* Renames the `$default` parameter to `$default_page` in `parent_dropdown()`.
* Renames the `$object` parameter to `$data_object` in:
* `do_block_editor_incompatible_meta_box()`
* `do_meta_boxes()`
* `do_accordion_sections()`
* Amends the `$item_object` parameter in other functions for consistency:
* `wp_nav_menu_item_post_type_meta_box()`
* `wp_nav_menu_item_taxonomy_meta_box()`
* `_wp_nav_menu_meta_box_object()`
Follow-up to [52946], [52996], [52997], [52998], [53003], [53014], [53029], [53039], [53116], [53117], [53137], [53174], [53184], [53185], [53192], [53193], [53198], [53203], [53207], [53215], [53216].
Props jrf, aristath, poena, justinahinon, SergeyBiryukov.
See #55327.
Built from https://develop.svn.wordpress.org/trunk@53220
git-svn-id: http://core.svn.wordpress.org/trunk@52809 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-04-19 11:13:08 -04:00
if ( isset ( $data_object -> name ) ) {
2010-05-03 16:26:11 -04:00
Code Modernization: Rename parameters that use reserved keywords in `wp-admin/includes/template.php`.
While using reserved PHP keywords as parameter name labels is allowed, in the context of function calls using named parameters in PHP 8.0+, this will easily lead to confusion. To avoid that, it is recommended not to use reserved keywords as function parameter names.
This commit:
* Renames the `$echo` parameter to `$display` in:
* `wp_popular_terms_checklist()`
* `_post_states()`
* `_media_states()`
* Renames the `$default` parameter to `$default_term` in `wp_popular_terms_checklist()`.
* Renames the `$default` parameter to `$default_template` in `page_template_dropdown()`.
* Renames the `$default` parameter to `$default_page` in `parent_dropdown()`.
* Renames the `$object` parameter to `$data_object` in:
* `do_block_editor_incompatible_meta_box()`
* `do_meta_boxes()`
* `do_accordion_sections()`
* Amends the `$item_object` parameter in other functions for consistency:
* `wp_nav_menu_item_post_type_meta_box()`
* `wp_nav_menu_item_taxonomy_meta_box()`
* `_wp_nav_menu_meta_box_object()`
Follow-up to [52946], [52996], [52997], [52998], [53003], [53014], [53029], [53039], [53116], [53117], [53137], [53174], [53184], [53185], [53192], [53193], [53198], [53203], [53207], [53215], [53216].
Props jrf, aristath, poena, justinahinon, SergeyBiryukov.
See #55327.
Built from https://develop.svn.wordpress.org/trunk@53220
git-svn-id: http://core.svn.wordpress.org/trunk@52809 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-04-19 11:13:08 -04:00
if ( 'page' === $data_object -> name ) {
$data_object -> _default_query = array (
2017-11-30 18:11:00 -05:00
'orderby' => 'menu_order title' ,
2010-04-28 14:30:32 -04:00
'post_status' => 'publish' ,
);
2017-11-30 18:11:00 -05:00
// Posts should show only published items.
Code Modernization: Rename parameters that use reserved keywords in `wp-admin/includes/template.php`.
While using reserved PHP keywords as parameter name labels is allowed, in the context of function calls using named parameters in PHP 8.0+, this will easily lead to confusion. To avoid that, it is recommended not to use reserved keywords as function parameter names.
This commit:
* Renames the `$echo` parameter to `$display` in:
* `wp_popular_terms_checklist()`
* `_post_states()`
* `_media_states()`
* Renames the `$default` parameter to `$default_term` in `wp_popular_terms_checklist()`.
* Renames the `$default` parameter to `$default_template` in `page_template_dropdown()`.
* Renames the `$default` parameter to `$default_page` in `parent_dropdown()`.
* Renames the `$object` parameter to `$data_object` in:
* `do_block_editor_incompatible_meta_box()`
* `do_meta_boxes()`
* `do_accordion_sections()`
* Amends the `$item_object` parameter in other functions for consistency:
* `wp_nav_menu_item_post_type_meta_box()`
* `wp_nav_menu_item_taxonomy_meta_box()`
* `_wp_nav_menu_meta_box_object()`
Follow-up to [52946], [52996], [52997], [52998], [53003], [53014], [53029], [53039], [53116], [53117], [53137], [53174], [53184], [53185], [53192], [53193], [53198], [53203], [53207], [53215], [53216].
Props jrf, aristath, poena, justinahinon, SergeyBiryukov.
See #55327.
Built from https://develop.svn.wordpress.org/trunk@53220
git-svn-id: http://core.svn.wordpress.org/trunk@52809 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-04-19 11:13:08 -04:00
} elseif ( 'post' === $data_object -> name ) {
$data_object -> _default_query = array (
2010-04-28 14:30:32 -04:00
'post_status' => 'publish' ,
);
2017-11-30 18:11:00 -05:00
// Categories should be in reverse chronological order.
Code Modernization: Rename parameters that use reserved keywords in `wp-admin/includes/template.php`.
While using reserved PHP keywords as parameter name labels is allowed, in the context of function calls using named parameters in PHP 8.0+, this will easily lead to confusion. To avoid that, it is recommended not to use reserved keywords as function parameter names.
This commit:
* Renames the `$echo` parameter to `$display` in:
* `wp_popular_terms_checklist()`
* `_post_states()`
* `_media_states()`
* Renames the `$default` parameter to `$default_term` in `wp_popular_terms_checklist()`.
* Renames the `$default` parameter to `$default_template` in `page_template_dropdown()`.
* Renames the `$default` parameter to `$default_page` in `parent_dropdown()`.
* Renames the `$object` parameter to `$data_object` in:
* `do_block_editor_incompatible_meta_box()`
* `do_meta_boxes()`
* `do_accordion_sections()`
* Amends the `$item_object` parameter in other functions for consistency:
* `wp_nav_menu_item_post_type_meta_box()`
* `wp_nav_menu_item_taxonomy_meta_box()`
* `_wp_nav_menu_meta_box_object()`
Follow-up to [52946], [52996], [52997], [52998], [53003], [53014], [53029], [53039], [53116], [53117], [53137], [53174], [53184], [53185], [53192], [53193], [53198], [53203], [53207], [53215], [53216].
Props jrf, aristath, poena, justinahinon, SergeyBiryukov.
See #55327.
Built from https://develop.svn.wordpress.org/trunk@53220
git-svn-id: http://core.svn.wordpress.org/trunk@52809 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-04-19 11:13:08 -04:00
} elseif ( 'category' === $data_object -> name ) {
$data_object -> _default_query = array (
2010-04-28 14:30:32 -04:00
'orderby' => 'id' ,
2017-11-30 18:11:00 -05:00
'order' => 'DESC' ,
2010-04-28 14:30:32 -04:00
);
2010-05-14 09:12:45 -04:00
2017-11-30 18:11:00 -05:00
// Custom post types should show only published items.
2010-05-14 09:12:45 -04:00
} else {
Code Modernization: Rename parameters that use reserved keywords in `wp-admin/includes/template.php`.
While using reserved PHP keywords as parameter name labels is allowed, in the context of function calls using named parameters in PHP 8.0+, this will easily lead to confusion. To avoid that, it is recommended not to use reserved keywords as function parameter names.
This commit:
* Renames the `$echo` parameter to `$display` in:
* `wp_popular_terms_checklist()`
* `_post_states()`
* `_media_states()`
* Renames the `$default` parameter to `$default_term` in `wp_popular_terms_checklist()`.
* Renames the `$default` parameter to `$default_template` in `page_template_dropdown()`.
* Renames the `$default` parameter to `$default_page` in `parent_dropdown()`.
* Renames the `$object` parameter to `$data_object` in:
* `do_block_editor_incompatible_meta_box()`
* `do_meta_boxes()`
* `do_accordion_sections()`
* Amends the `$item_object` parameter in other functions for consistency:
* `wp_nav_menu_item_post_type_meta_box()`
* `wp_nav_menu_item_taxonomy_meta_box()`
* `_wp_nav_menu_meta_box_object()`
Follow-up to [52946], [52996], [52997], [52998], [53003], [53014], [53029], [53039], [53116], [53117], [53137], [53174], [53184], [53185], [53192], [53193], [53198], [53203], [53207], [53215], [53216].
Props jrf, aristath, poena, justinahinon, SergeyBiryukov.
See #55327.
Built from https://develop.svn.wordpress.org/trunk@53220
git-svn-id: http://core.svn.wordpress.org/trunk@52809 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-04-19 11:13:08 -04:00
$data_object -> _default_query = array (
2010-05-14 09:12:45 -04:00
'post_status' => 'publish' ,
);
2010-04-28 14:30:32 -04:00
}
}
2010-05-03 16:26:11 -04:00
Code Modernization: Rename parameters that use reserved keywords in `wp-admin/includes/template.php`.
While using reserved PHP keywords as parameter name labels is allowed, in the context of function calls using named parameters in PHP 8.0+, this will easily lead to confusion. To avoid that, it is recommended not to use reserved keywords as function parameter names.
This commit:
* Renames the `$echo` parameter to `$display` in:
* `wp_popular_terms_checklist()`
* `_post_states()`
* `_media_states()`
* Renames the `$default` parameter to `$default_term` in `wp_popular_terms_checklist()`.
* Renames the `$default` parameter to `$default_template` in `page_template_dropdown()`.
* Renames the `$default` parameter to `$default_page` in `parent_dropdown()`.
* Renames the `$object` parameter to `$data_object` in:
* `do_block_editor_incompatible_meta_box()`
* `do_meta_boxes()`
* `do_accordion_sections()`
* Amends the `$item_object` parameter in other functions for consistency:
* `wp_nav_menu_item_post_type_meta_box()`
* `wp_nav_menu_item_taxonomy_meta_box()`
* `_wp_nav_menu_meta_box_object()`
Follow-up to [52946], [52996], [52997], [52998], [53003], [53014], [53029], [53039], [53116], [53117], [53137], [53174], [53184], [53185], [53192], [53193], [53198], [53203], [53207], [53215], [53216].
Props jrf, aristath, poena, justinahinon, SergeyBiryukov.
See #55327.
Built from https://develop.svn.wordpress.org/trunk@53220
git-svn-id: http://core.svn.wordpress.org/trunk@52809 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-04-19 11:13:08 -04:00
return $data_object ;
2010-04-28 14:30:32 -04:00
}
2010-03-15 12:26:46 -04:00
/**
2010-05-14 16:06:50 -04:00
* Returns the menu formatted to edit .
2010-03-15 12:26:46 -04:00
*
* @ since 3.0 . 0
*
2014-11-29 23:25:23 -05:00
* @ param int $menu_id Optional . The ID of the menu to format . Default 0.
2020-06-19 18:55:12 -04:00
* @ return string | WP_Error The menu formatted to edit or error object on failure .
2010-03-15 12:26:46 -04:00
*/
2010-05-14 16:06:50 -04:00
function wp_get_nav_menu_to_edit ( $menu_id = 0 ) {
$menu = wp_get_nav_menu_object ( $menu_id );
2010-05-03 16:26:11 -04:00
2010-04-26 21:05:58 -04:00
// If the menu exists, get its items.
if ( is_nav_menu ( $menu ) ) {
2017-11-30 18:11:00 -05:00
$menu_items = wp_get_nav_menu_items ( $menu -> term_id , array ( 'post_status' => 'any' ) );
$result = '<div id="menu-instructions" class="post-body-plain' ;
$result .= ( ! empty ( $menu_items ) ) ? ' menu-instructions-inactive">' : '">' ;
$result .= '<p>' . __ ( 'Add menu items from the column on the left.' ) . '</p>' ;
$result .= '</div>' ;
2010-05-25 22:42:15 -04:00
2017-11-30 18:11:00 -05:00
if ( empty ( $menu_items ) ) {
2010-05-28 19:04:00 -04:00
return $result . ' <ul class="menu" id="menu-to-edit"> </ul>' ;
2017-11-30 18:11:00 -05:00
}
2010-04-26 21:05:58 -04:00
2013-10-26 13:48:11 -04:00
/**
2016-05-22 14:01:30 -04:00
* Filters the Walker class used when adding nav menu items .
2013-10-26 13:48:11 -04:00
*
* @ since 3.0 . 0
*
2014-04-25 02:50:15 -04:00
* @ param string $class The walker class to use . Default 'Walker_Nav_Menu_Edit' .
* @ param int $menu_id ID of the menu being rendered .
2013-10-26 13:48:11 -04:00
*/
2010-05-14 16:06:50 -04:00
$walker_class_name = apply_filters ( 'wp_edit_nav_menu_walker' , 'Walker_Nav_Menu_Edit' , $menu_id );
2015-11-29 23:15:27 -05:00
if ( class_exists ( $walker_class_name ) ) {
2022-11-29 10:51:14 -05:00
$walker = new $walker_class_name ();
2015-10-29 21:37:24 -04:00
} else {
2017-11-30 18:11:00 -05:00
return new WP_Error (
'menu_walker_not_exist' ,
sprintf (
2019-09-02 20:41:05 -04:00
/* translators: %s: Walker class name. */
2017-11-30 18:11:00 -05:00
__ ( 'The Walker class named %s does not exist.' ),
2015-10-29 21:37:24 -04:00
'<strong>' . $walker_class_name . '</strong>'
)
);
}
2010-04-26 21:05:58 -04:00
2019-07-01 08:52:01 -04:00
$some_pending_menu_items = false ;
$some_invalid_menu_items = false ;
2015-08-25 16:28:22 -04:00
foreach ( ( array ) $menu_items as $menu_item ) {
2020-05-16 14:42:12 -04:00
if ( isset ( $menu_item -> post_status ) && 'draft' === $menu_item -> post_status ) {
2010-05-27 18:22:09 -04:00
$some_pending_menu_items = true ;
2017-11-30 18:11:00 -05:00
}
if ( ! empty ( $menu_item -> _invalid ) ) {
2011-06-11 11:52:15 -04:00
$some_invalid_menu_items = true ;
2017-11-30 18:11:00 -05:00
}
2010-05-27 18:22:09 -04:00
}
2016-05-23 05:40:28 -04:00
if ( $some_pending_menu_items ) {
$result .= '<div class="notice notice-info notice-alt inline"><p>' . __ ( 'Click Save Menu to make pending menu items public.' ) . '</p></div>' ;
}
2010-05-27 18:22:09 -04:00
2016-05-23 05:40:28 -04:00
if ( $some_invalid_menu_items ) {
$result .= '<div class="notice notice-error notice-alt inline"><p>' . __ ( 'There are some invalid menu items. Please check or delete them.' ) . '</p></div>' ;
}
2011-06-11 11:52:15 -04:00
2010-05-28 19:04:00 -04:00
$result .= '<ul class="menu" id="menu-to-edit"> ' ;
2017-11-30 18:11:00 -05:00
$result .= walk_nav_menu_tree ( array_map ( 'wp_setup_nav_menu_item' , $menu_items ), 0 , ( object ) array ( 'walker' => $walker ) );
2010-05-28 19:04:00 -04:00
$result .= ' </ul> ' ;
2010-05-25 20:41:18 -04:00
return $result ;
2010-04-26 21:05:58 -04:00
} elseif ( is_wp_error ( $menu ) ) {
2010-05-03 16:26:11 -04:00
return $menu ;
2010-02-24 03:06:36 -05:00
}
2010-03-17 12:27:25 -04:00
2010-02-24 03:06:36 -05:00
}
2010-04-26 21:05:58 -04:00
2010-04-28 23:43:39 -04:00
/**
* Returns the columns for the nav menus page .
*
* @ since 3.0 . 0
*
2019-11-05 16:30:03 -05:00
* @ return string [] Array of column titles keyed by their column name .
2010-04-28 23:43:39 -04:00
*/
function wp_nav_menu_manage_columns () {
return array (
2016-03-30 17:55:27 -04:00
'_title' => __ ( 'Show advanced menu properties' ),
'cb' => '<input type="checkbox" />' ,
'link-target' => __ ( 'Link Target' ),
'title-attribute' => __ ( 'Title Attribute' ),
'css-classes' => __ ( 'CSS Classes' ),
'xfn' => __ ( 'Link Relationship (XFN)' ),
'description' => __ ( 'Description' ),
2010-04-28 23:43:39 -04:00
);
}
2010-06-02 16:04:07 -04:00
/**
2010-06-14 15:52:30 -04:00
* Deletes orphaned draft menu items
2010-05-27 18:22:09 -04:00
*
* @ access private
* @ since 3.0 . 0
*
2015-10-14 19:44:25 -04:00
* @ global wpdb $wpdb WordPress database abstraction object .
2010-05-27 18:22:09 -04:00
*/
2010-06-14 15:52:30 -04:00
function _wp_delete_orphaned_draft_menu_items () {
2010-05-27 18:22:09 -04:00
global $wpdb ;
2012-09-25 01:26:19 -04:00
$delete_timestamp = time () - ( DAY_IN_SECONDS * EMPTY_TRASH_DAYS );
2010-05-27 18:22:09 -04:00
2014-07-17 05:14:16 -04:00
// Delete orphaned draft menu items.
2017-11-30 18:11:00 -05:00
$menu_items_to_delete = $wpdb -> get_col ( $wpdb -> prepare ( " SELECT ID FROM $wpdb->posts AS p LEFT JOIN $wpdb->postmeta AS m ON p.ID = m.post_id WHERE post_type = 'nav_menu_item' AND post_status = 'draft' AND meta_key = '_menu_item_orphaned' AND meta_value < %d " , $delete_timestamp ) );
2010-05-27 18:22:09 -04:00
2017-11-30 18:11:00 -05:00
foreach ( ( array ) $menu_items_to_delete as $menu_item_id ) {
2010-05-27 18:22:09 -04:00
wp_delete_post ( $menu_item_id , true );
2017-11-30 18:11:00 -05:00
}
2010-05-27 18:22:09 -04:00
}
2013-02-15 23:53:59 -05:00
/**
2023-02-07 16:21:18 -05:00
* Saves nav menu items .
2013-02-15 23:53:59 -05:00
*
* @ since 3.6 . 0
*
2020-07-23 16:01:04 -04:00
* @ param int | string $nav_menu_selected_id ID , slug , or name of the currently - selected menu .
* @ param string $nav_menu_selected_title Title of the currently - selected menu .
2023-02-07 16:21:18 -05:00
* @ return string [] The menu updated messages .
2013-02-15 23:53:59 -05:00
*/
2017-11-30 18:11:00 -05:00
function wp_nav_menu_update_menu_items ( $nav_menu_selected_id , $nav_menu_selected_title ) {
$unsorted_menu_items = wp_get_nav_menu_items (
2018-08-16 21:51:36 -04:00
$nav_menu_selected_id ,
array (
2017-11-30 18:11:00 -05:00
'orderby' => 'ID' ,
'output' => ARRAY_A ,
'output_key' => 'ID' ,
'post_status' => 'draft,publish' ,
)
);
2020-04-09 11:43:10 -04:00
$messages = array ();
$menu_items = array ();
2020-01-28 19:35:08 -05:00
// Index menu items by DB ID.
2017-11-30 18:11:00 -05:00
foreach ( $unsorted_menu_items as $_item ) {
$menu_items [ $_item -> db_id ] = $_item ;
}
2013-02-15 23:53:59 -05:00
$post_fields = array (
2017-11-30 18:11:00 -05:00
'menu-item-db-id' ,
'menu-item-object-id' ,
'menu-item-object' ,
'menu-item-parent-id' ,
'menu-item-position' ,
'menu-item-type' ,
'menu-item-title' ,
'menu-item-url' ,
'menu-item-description' ,
'menu-item-attr-title' ,
'menu-item-target' ,
'menu-item-classes' ,
'menu-item-xfn' ,
2013-02-15 23:53:59 -05:00
);
wp_defer_term_counting ( true );
2020-04-09 11:43:10 -04:00
2020-01-28 19:35:08 -05:00
// Loop through all the menu items' POST variables.
2013-02-15 23:53:59 -05:00
if ( ! empty ( $_POST [ 'menu-item-db-id' ] ) ) {
2015-08-25 16:28:22 -04:00
foreach ( ( array ) $_POST [ 'menu-item-db-id' ] as $_key => $k ) {
2013-02-15 23:53:59 -05:00
2020-01-28 19:35:08 -05:00
// Menu item title can't be blank.
2020-05-16 14:42:12 -04:00
if ( ! isset ( $_POST [ 'menu-item-title' ][ $_key ] ) || '' === $_POST [ 'menu-item-title' ][ $_key ] ) {
2013-02-15 23:53:59 -05:00
continue ;
2017-11-30 18:11:00 -05:00
}
2013-02-15 23:53:59 -05:00
$args = array ();
2017-11-30 18:11:00 -05:00
foreach ( $post_fields as $field ) {
$args [ $field ] = isset ( $_POST [ $field ][ $_key ] ) ? $_POST [ $field ][ $_key ] : '' ;
}
2013-02-15 23:53:59 -05:00
2017-11-30 18:11:00 -05:00
$menu_item_db_id = wp_update_nav_menu_item ( $nav_menu_selected_id , ( $_POST [ 'menu-item-db-id' ][ $_key ] != $_key ? 0 : $_key ), $args );
2013-02-15 23:53:59 -05:00
2015-05-22 01:47:25 -04:00
if ( is_wp_error ( $menu_item_db_id ) ) {
2013-02-15 23:53:59 -05:00
$messages [] = '<div id="message" class="error"><p>' . $menu_item_db_id -> get_error_message () . '</p></div>' ;
2015-05-22 01:47:25 -04:00
} else {
unset ( $menu_items [ $menu_item_db_id ] );
}
2013-02-15 23:53:59 -05:00
}
}
2020-01-28 19:35:08 -05:00
// Remove menu items from the menu that weren't in $_POST.
2013-02-15 23:53:59 -05:00
if ( ! empty ( $menu_items ) ) {
foreach ( array_keys ( $menu_items ) as $menu_item_id ) {
if ( is_nav_menu_item ( $menu_item_id ) ) {
wp_delete_post ( $menu_item_id );
}
}
}
// Store 'auto-add' pages.
2017-11-30 18:11:00 -05:00
$auto_add = ! empty ( $_POST [ 'auto-add-pages' ] );
2013-02-15 23:53:59 -05:00
$nav_menu_option = ( array ) get_option ( 'nav_menu_options' );
2020-04-09 11:43:10 -04:00
2017-11-30 18:11:00 -05:00
if ( ! isset ( $nav_menu_option [ 'auto_add' ] ) ) {
2013-02-15 23:53:59 -05:00
$nav_menu_option [ 'auto_add' ] = array ();
2017-11-30 18:11:00 -05:00
}
2020-04-09 11:43:10 -04:00
2013-02-15 23:53:59 -05:00
if ( $auto_add ) {
2020-04-09 11:43:10 -04:00
if ( ! in_array ( $nav_menu_selected_id , $nav_menu_option [ 'auto_add' ], true ) ) {
2013-02-15 23:53:59 -05:00
$nav_menu_option [ 'auto_add' ][] = $nav_menu_selected_id ;
2017-11-30 18:11:00 -05:00
}
2013-02-15 23:53:59 -05:00
} else {
2020-04-09 11:43:10 -04:00
$key = array_search ( $nav_menu_selected_id , $nav_menu_option [ 'auto_add' ], true );
2019-07-01 08:52:01 -04:00
if ( false !== $key ) {
2017-11-30 18:11:00 -05:00
unset ( $nav_menu_option [ 'auto_add' ][ $key ] );
}
2013-02-15 23:53:59 -05:00
}
2020-04-09 11:43:10 -04:00
2020-01-28 19:35:08 -05:00
// Remove non-existent/deleted menus.
2013-02-15 23:53:59 -05:00
$nav_menu_option [ 'auto_add' ] = array_intersect ( $nav_menu_option [ 'auto_add' ], wp_get_nav_menus ( array ( 'fields' => 'ids' ) ) );
update_option ( 'nav_menu_options' , $nav_menu_option );
wp_defer_term_counting ( false );
2013-10-26 13:48:11 -04:00
/** This action is documented in wp-includes/nav-menu.php */
2013-02-15 23:53:59 -05:00
do_action ( 'wp_update_nav_menu' , $nav_menu_selected_id );
2015-10-29 21:17:26 -04:00
$messages [] = '<div id="message" class="updated notice is-dismissible"><p>' .
2017-11-30 18:11:00 -05:00
sprintf (
2019-09-02 20:41:05 -04:00
/* translators: %s: Nav menu title. */
2017-11-30 18:11:00 -05:00
__ ( '%s has been updated.' ),
2015-10-29 21:17:26 -04:00
'<strong>' . $nav_menu_selected_title . '</strong>'
) . '</p></div>' ;
2013-02-15 23:53:59 -05:00
unset ( $menu_items , $unsorted_menu_items );
return $messages ;
}
2016-06-19 08:25:28 -04:00
/**
* If a JSON blob of navigation menu data is in POST data , expand it and inject
* it into `$_POST` to avoid PHP `max_input_vars` limitations . See #14134.
*
* @ ignore
* @ since 4.5 . 3
* @ access private
*/
function _wp_expand_nav_menu_post_data () {
if ( ! isset ( $_POST [ 'nav-menu-data' ] ) ) {
return ;
}
$data = json_decode ( stripslashes ( $_POST [ 'nav-menu-data' ] ) );
if ( ! is_null ( $data ) && $data ) {
foreach ( $data as $post_input_data ) {
// For input names that are arrays (e.g. `menu-item-db-id[3][4][5]`),
2020-01-28 19:35:08 -05:00
// derive the array path keys via regex and set the value in $_POST.
2016-06-19 08:25:28 -04:00
preg_match ( '#([^\[]*)(\[(.+)\])?#' , $post_input_data -> name , $matches );
$array_bits = array ( $matches [ 1 ] );
if ( isset ( $matches [ 3 ] ) ) {
$array_bits = array_merge ( $array_bits , explode ( '][' , $matches [ 3 ] ) );
}
$new_post_data = array ();
// Build the new array value from leaf to trunk.
2020-01-28 19:35:08 -05:00
for ( $i = count ( $array_bits ) - 1 ; $i >= 0 ; $i -- ) {
2020-02-09 11:55:09 -05:00
if ( count ( $array_bits ) - 1 == $i ) {
2016-06-19 08:25:28 -04:00
$new_post_data [ $array_bits [ $i ] ] = wp_slash ( $post_input_data -> value );
} else {
$new_post_data = array ( $array_bits [ $i ] => $new_post_data );
}
}
$_POST = array_replace_recursive ( $_POST , $new_post_data );
}
}
}