WordPress 4.3
[autoinstalls/wordpress.git] / wp-admin / includes / nav-menu.php
index 9575297463c7ca61df7c10bf1a051c4c023c5e79..43a807c8b141415935c9234ff2d13cad1786a6c4 100644 (file)
@@ -40,6 +40,8 @@ class Walker_Nav_Menu_Edit extends Walker_Nav_Menu {
         * @see Walker_Nav_Menu::start_el()
         * @since 3.0.0
         *
+        * @global int $_wp_nav_menu_max_depth
+        *
         * @param string $output Passed by reference. Used to append additional content.
         * @param object $item   Menu item data object.
         * @param int    $depth  Depth of menu item. Used for padding.
@@ -97,8 +99,8 @@ class Walker_Nav_Menu_Edit extends Walker_Nav_Menu {
 
                ?>
                <li id="menu-item-<?php echo $item_id; ?>" class="<?php echo implode(' ', $classes ); ?>">
-                       <dl class="menu-item-bar">
-                               <dt class="menu-item-handle">
+                       <div class="menu-item-bar">
+                               <div class="menu-item-handle">
                                        <span class="item-title"><span class="menu-item-title"><?php echo esc_html( $title ); ?></span> <span class="is-submenu" <?php echo $submenu_text; ?>><?php _e( 'sub item' ); ?></span></span>
                                        <span class="item-controls">
                                                <span class="item-type"><?php echo esc_html( $item->type_label ); ?></span>
@@ -133,11 +135,11 @@ class Walker_Nav_Menu_Edit extends Walker_Nav_Menu {
                                                        echo ( isset( $_GET['edit-menu-item'] ) && $item_id == $_GET['edit-menu-item'] ) ? admin_url( 'nav-menus.php' ) : add_query_arg( 'edit-menu-item', $item_id, remove_query_arg( $removed_args, admin_url( 'nav-menus.php#menu-item-settings-' . $item_id ) ) );
                                                ?>"><?php _e( 'Edit Menu Item' ); ?></a>
                                        </span>
-                               </dt>
-                       </dl>
+                               </div>
+                       </div>
 
                        <div class="menu-item-settings" id="menu-item-settings-<?php echo $item_id; ?>">
-                               <?php if( 'custom' == $item->type ) : ?>
+                               <?php if ( 'custom' == $item->type ) : ?>
                                        <p class="field-url description description-wide">
                                                <label for="edit-menu-item-url-<?php echo $item_id; ?>">
                                                        <?php _e( 'URL' ); ?><br />
@@ -145,13 +147,13 @@ class Walker_Nav_Menu_Edit extends Walker_Nav_Menu {
                                                </label>
                                        </p>
                                <?php endif; ?>
-                               <p class="description description-thin">
+                               <p class="description description-wide">
                                        <label for="edit-menu-item-title-<?php echo $item_id; ?>">
                                                <?php _e( 'Navigation Label' ); ?><br />
                                                <input type="text" id="edit-menu-item-title-<?php echo $item_id; ?>" class="widefat edit-menu-item-title" name="menu-item-title[<?php echo $item_id; ?>]" value="<?php echo esc_attr( $item->title ); ?>" />
                                        </label>
                                </p>
-                               <p class="description description-thin">
+                               <p class="field-title-attribute description description-wide">
                                        <label for="edit-menu-item-attr-title-<?php echo $item_id; ?>">
                                                <?php _e( 'Title Attribute' ); ?><br />
                                                <input type="text" id="edit-menu-item-attr-title-<?php echo $item_id; ?>" class="widefat edit-menu-item-attr-title" name="menu-item-attr-title[<?php echo $item_id; ?>]" value="<?php echo esc_attr( $item->post_excerpt ); ?>" />
@@ -195,7 +197,7 @@ class Walker_Nav_Menu_Edit extends Walker_Nav_Menu {
                                </p>
 
                                <div class="menu-item-actions description-wide submitbox">
-                                       <?php if( 'custom' != $item->type && $original_title !== false ) : ?>
+                                       <?php if ( 'custom' != $item->type && $original_title !== false ) : ?>
                                                <p class="link-to-original">
                                                        <?php printf( __('Original: %s'), '<a href="' . esc_attr( $item->url ) . '">' . esc_html( $original_title ) . '</a>' ); ?>
                                                </p>
@@ -235,6 +237,10 @@ class Walker_Nav_Menu_Edit extends Walker_Nav_Menu {
  * @uses Walker_Nav_Menu
  */
 class Walker_Nav_Menu_Checklist extends Walker_Nav_Menu {
+       /**
+        *
+        * @param array $fields
+        */
        public function __construct( $fields = false ) {
                if ( $fields ) {
                        $this->db_fields = $fields;
@@ -280,6 +286,8 @@ class Walker_Nav_Menu_Checklist extends Walker_Nav_Menu {
         *
         * @since 3.0.0
         *
+        * @global int $_nav_menu_placeholder
+        *
         * @param string $output Passed by reference. Used to append additional content.
         * @param object $item   Menu item data object.
         * @param int    $depth  Depth of menu item. Used for padding.
@@ -451,18 +459,20 @@ function wp_nav_menu_setup() {
        add_filter( 'manage_nav-menus_columns', 'wp_nav_menu_manage_columns' );
 
        // If first time editing, disable advanced items by default.
-       if( false === get_user_option( 'managenav-menuscolumnshidden' ) ) {
+       if ( false === get_user_option( 'managenav-menuscolumnshidden' ) ) {
                $user = wp_get_current_user();
                update_user_option($user->ID, 'managenav-menuscolumnshidden',
-                       array( 0 => 'link-target', 1 => 'css-classes', 2 => 'xfn', 3 => 'description', ),
+                       array( 0 => 'link-target', 1 => 'css-classes', 2 => 'xfn', 3 => 'description', 4 => 'title-attribute', ),
                        true);
        }
 }
 
 /**
- * Limit the amount of meta boxes to just links, pages and cats for first time users.
+ * Limit the amount of meta boxes to pages, posts, links, and categories for first time users.
  *
  * @since 3.0.0
+ *
+ * @global array $wp_meta_boxes
  **/
 function wp_initial_nav_menu_meta_boxes() {
        global $wp_meta_boxes;
@@ -470,7 +480,7 @@ function wp_initial_nav_menu_meta_boxes() {
        if ( get_user_option( 'metaboxhidden_nav-menus' ) !== false || ! is_array($wp_meta_boxes) )
                return;
 
-       $initial_meta_boxes = array( 'nav-menu-theme-locations', 'add-page', 'add-custom-links', 'add-category' );
+       $initial_meta_boxes = array( 'add-page', 'add-post', 'add-custom-links', 'add-category' );
        $hidden_meta_boxes = array();
 
        foreach ( array_keys($wp_meta_boxes['nav-menus']) as $context ) {
@@ -549,7 +559,7 @@ function wp_nav_menu_taxonomy_meta_boxes() {
  *
  * @since 3.6.0
  *
- * @uses global $one_theme_location_no_menus to determine if no menus exist
+ * @global bool $one_theme_location_no_menus to determine if no menus exist
  *
  * @param int|string $nav_menu_selected_id (id, name or slug) of the currently-selected menu
  * @return string Disabled attribute if at least one menu exists, false if not
@@ -567,6 +577,9 @@ function wp_nav_menu_disabled_check( $nav_menu_selected_id ) {
  * Displays a metabox for the custom links menu item.
  *
  * @since 3.0.0
+ *
+ * @global int        $_nav_menu_placeholder
+ * @global int|string $nav_menu_selected_id
  */
 function wp_nav_menu_item_link_meta_box() {
        global $_nav_menu_placeholder, $nav_menu_selected_id;
@@ -606,6 +619,9 @@ function wp_nav_menu_item_link_meta_box() {
  *
  * @since 3.0.0
  *
+ * @global int        $_nav_menu_placeholder
+ * @global int|string $nav_menu_selected_id
+ *
  * @param string $object Not used.
  * @param string $post_type The post type object.
  */
@@ -712,6 +728,21 @@ function wp_nav_menu_item_post_type_meta_box( $object, $post_type ) {
                                $recent_args = array_merge( $args, array( 'orderby' => 'post_date', 'order' => 'DESC', 'posts_per_page' => 15 ) );
                                $most_recent = $get_posts->query( $recent_args );
                                $args['walker'] = $walker;
+
+                               /**
+                                * Filter the posts displayed in the 'Most Recent' tab of the current
+                                * post type's menu items meta box.
+                                *
+                                * The dynamic portion of the hook name, `$post_type_name`, refers to the post type name.
+                                *
+                                * @since 4.3.0
+                                *
+                                * @param array  $most_recent An array of post objects being listed.
+                                * @param array  $args        An array of WP_Query arguments.
+                                * @param object $post_type   The current post type object for this menu item meta box.
+                                */
+                               $most_recent = apply_filters( "nav_menu_items_{$post_type_name}_recent", $most_recent, $args, $post_type );
+
                                echo walk_nav_menu_tree( array_map('wp_setup_nav_menu_item', $most_recent), 0, (object) $args );
                                ?>
                        </ul>
@@ -849,6 +880,8 @@ function wp_nav_menu_item_post_type_meta_box( $object, $post_type ) {
  *
  * @since 3.0.0
  *
+ * @global int|string $nav_menu_selected_id
+ *
  * @param string $object Not used.
  * @param string $taxonomy The taxonomy object.
  */
@@ -1162,7 +1195,7 @@ function wp_get_nav_menu_to_edit( $menu_id = 0 ) {
                $result .= '<p>' . __( 'Add menu items from the column on the left.' ) . '</p>';
                $result .= '</div>';
 
-               if( empty($menu_items) )
+               if ( empty($menu_items) )
                        return $result . ' <ul class="menu" id="menu-to-edit"> </ul>';
 
                /**
@@ -1215,6 +1248,7 @@ function wp_nav_menu_manage_columns() {
        return array(
                '_title' => __('Show advanced menu properties'),
                'cb' => '<input type="checkbox" />',
+               'title-attribute' => __('Title Attribute'),
                'link-target' => __('Link Target'),
                'css-classes' => __('CSS Classes'),
                'xfn' => __('Link Relationship (XFN)'),
@@ -1228,6 +1262,7 @@ function wp_nav_menu_manage_columns() {
  * @access private
  * @since 3.0.0
  *
+ * @global wpdb $wpdb
  */
 function _wp_delete_orphaned_draft_menu_items() {
        global $wpdb;
@@ -1239,7 +1274,6 @@ function _wp_delete_orphaned_draft_menu_items() {
        foreach( (array) $menu_items_to_delete as $menu_item_id )
                wp_delete_post( $menu_item_id, true );
 }
-add_action('admin_head-nav-menus.php', '_wp_delete_orphaned_draft_menu_items');
 
 /**
  * Saves nav menu items
@@ -1280,10 +1314,11 @@ function wp_nav_menu_update_menu_items ( $nav_menu_selected_id, $nav_menu_select
 
                        $menu_item_db_id = wp_update_nav_menu_item( $nav_menu_selected_id, ( $_POST['menu-item-db-id'][$_key] != $_key ? 0 : $_key ), $args );
 
-                       if ( is_wp_error( $menu_item_db_id ) )
+                       if ( is_wp_error( $menu_item_db_id ) ) {
                                $messages[] = '<div id="message" class="error"><p>' . $menu_item_db_id->get_error_message() . '</p></div>';
-                       elseif ( isset( $menu_items[$menu_item_db_id] ) )
-                               unset( $menu_items[$menu_item_db_id] );
+                       } else {
+                               unset( $menu_items[ $menu_item_db_id ] );
+                       }
                }
        }