| [ Index ] |
PHP Cross Reference of WordPress |
[Summary view] [Print] [Text view]
1 <?php 2 /** 3 * Navigation Menu API: Walker_Nav_Menu_Edit class 4 * 5 * @package WordPress 6 * @subpackage Administration 7 * @since 4.4.0 8 */ 9 10 /** 11 * Create HTML list of nav menu input items. 12 * 13 * @since 3.0.0 14 * 15 * @see Walker_Nav_Menu 16 */ 17 class Walker_Nav_Menu_Edit extends Walker_Nav_Menu { 18 /** 19 * Starts the list before the elements are added. 20 * 21 * @see Walker_Nav_Menu::start_lvl() 22 * 23 * @since 3.0.0 24 * 25 * @param string $output Passed by reference. 26 * @param int $depth Depth of menu item. Used for padding. 27 * @param stdClass $args Not used. 28 */ 29 public function start_lvl( &$output, $depth = 0, $args = null ) {} 30 31 /** 32 * Ends the list of after the elements are added. 33 * 34 * @see Walker_Nav_Menu::end_lvl() 35 * 36 * @since 3.0.0 37 * 38 * @param string $output Passed by reference. 39 * @param int $depth Depth of menu item. Used for padding. 40 * @param stdClass $args Not used. 41 */ 42 public function end_lvl( &$output, $depth = 0, $args = null ) {} 43 44 /** 45 * Start the element output. 46 * 47 * @see Walker_Nav_Menu::start_el() 48 * @since 3.0.0 49 * @since 5.9.0 Renamed `$item` to `$data_object` and `$id` to `$current_object_id` 50 * to match parent class for PHP 8 named parameter support. 51 * 52 * @global int $_wp_nav_menu_max_depth 53 * 54 * @param string $output Used to append additional content (passed by reference). 55 * @param WP_Post $data_object Menu item data object. 56 * @param int $depth Depth of menu item. Used for padding. 57 * @param stdClass $args Not used. 58 * @param int $current_object_id Optional. ID of the current menu item. Default 0. 59 */ 60 public function start_el( &$output, $data_object, $depth = 0, $args = null, $current_object_id = 0 ) { 61 global $_wp_nav_menu_max_depth; 62 63 // Restores the more descriptive, specific name for use within this method. 64 $menu_item = $data_object; 65 $_wp_nav_menu_max_depth = $depth > $_wp_nav_menu_max_depth ? $depth : $_wp_nav_menu_max_depth; 66 67 ob_start(); 68 $item_id = esc_attr( $menu_item->ID ); 69 $removed_args = array( 70 'action', 71 'customlink-tab', 72 'edit-menu-item', 73 'menu-item', 74 'page-tab', 75 '_wpnonce', 76 ); 77 78 $original_title = false; 79 80 if ( 'taxonomy' === $menu_item->type ) { 81 $original_object = get_term( (int) $menu_item->object_id, $menu_item->object ); 82 if ( $original_object && ! is_wp_error( $original_object ) ) { 83 $original_title = $original_object->name; 84 } 85 } elseif ( 'post_type' === $menu_item->type ) { 86 $original_object = get_post( $menu_item->object_id ); 87 if ( $original_object ) { 88 $original_title = get_the_title( $original_object->ID ); 89 } 90 } elseif ( 'post_type_archive' === $menu_item->type ) { 91 $original_object = get_post_type_object( $menu_item->object ); 92 if ( $original_object ) { 93 $original_title = $original_object->labels->archives; 94 } 95 } 96 97 $classes = array( 98 'menu-item menu-item-depth-' . $depth, 99 'menu-item-' . esc_attr( $menu_item->object ), 100 'menu-item-edit-' . ( ( isset( $_GET['edit-menu-item'] ) && $item_id === $_GET['edit-menu-item'] ) ? 'active' : 'inactive' ), 101 ); 102 103 $title = $menu_item->title; 104 105 if ( ! empty( $menu_item->_invalid ) ) { 106 $classes[] = 'menu-item-invalid'; 107 /* translators: %s: Title of an invalid menu item. */ 108 $title = sprintf( __( '%s (Invalid)' ), $menu_item->title ); 109 } elseif ( isset( $menu_item->post_status ) && 'draft' === $menu_item->post_status ) { 110 $classes[] = 'pending'; 111 /* translators: %s: Title of a menu item in draft status. */ 112 $title = sprintf( __( '%s (Pending)' ), $menu_item->title ); 113 } 114 115 $title = ( ! isset( $menu_item->label ) || '' === $menu_item->label ) ? $title : $menu_item->label; 116 117 $submenu_text = ''; 118 if ( 0 === $depth ) { 119 $submenu_text = 'style="display: none;"'; 120 } 121 122 ?> 123 <li id="menu-item-<?php echo $item_id; ?>" class="<?php echo implode( ' ', $classes ); ?>"> 124 <div class="menu-item-bar"> 125 <div class="menu-item-handle"> 126 <label class="item-title" for="menu-item-checkbox-<?php echo $item_id; ?>"> 127 <input id="menu-item-checkbox-<?php echo $item_id; ?>" type="checkbox" class="menu-item-checkbox" data-menu-item-id="<?php echo $item_id; ?>" disabled="disabled" /> 128 <span class="menu-item-title"><?php echo esc_html( $title ); ?></span> 129 <span class="is-submenu" <?php echo $submenu_text; ?>><?php _e( 'sub item' ); ?></span> 130 </label> 131 <span class="item-controls"> 132 <span class="item-type"><?php echo esc_html( $menu_item->type_label ); ?></span> 133 <span class="item-order hide-if-js"> 134 <?php 135 printf( 136 '<a href="%s" class="item-move-up" aria-label="%s">↑</a>', 137 wp_nonce_url( 138 add_query_arg( 139 array( 140 'action' => 'move-up-menu-item', 141 'menu-item' => $item_id, 142 ), 143 remove_query_arg( $removed_args, admin_url( 'nav-menus.php' ) ) 144 ), 145 'move-menu_item' 146 ), 147 esc_attr__( 'Move up' ) 148 ); 149 ?> 150 | 151 <?php 152 printf( 153 '<a href="%s" class="item-move-down" aria-label="%s">↓</a>', 154 wp_nonce_url( 155 add_query_arg( 156 array( 157 'action' => 'move-down-menu-item', 158 'menu-item' => $item_id, 159 ), 160 remove_query_arg( $removed_args, admin_url( 'nav-menus.php' ) ) 161 ), 162 'move-menu_item' 163 ), 164 esc_attr__( 'Move down' ) 165 ); 166 ?> 167 </span> 168 <?php 169 if ( isset( $_GET['edit-menu-item'] ) && $item_id === $_GET['edit-menu-item'] ) { 170 $edit_url = admin_url( 'nav-menus.php' ); 171 } else { 172 $edit_url = add_query_arg( 173 array( 174 'edit-menu-item' => $item_id, 175 ), 176 remove_query_arg( $removed_args, admin_url( 'nav-menus.php#menu-item-settings-' . $item_id ) ) 177 ); 178 } 179 180 printf( 181 '<a class="item-edit" id="edit-%s" href="%s" aria-label="%s"><span class="screen-reader-text">%s</span></a>', 182 $item_id, 183 $edit_url, 184 esc_attr__( 'Edit menu item' ), 185 __( 'Edit' ) 186 ); 187 ?> 188 </span> 189 </div> 190 </div> 191 192 <div class="menu-item-settings wp-clearfix" id="menu-item-settings-<?php echo $item_id; ?>"> 193 <?php if ( 'custom' === $menu_item->type ) : ?> 194 <p class="field-url description description-wide"> 195 <label for="edit-menu-item-url-<?php echo $item_id; ?>"> 196 <?php _e( 'URL' ); ?><br /> 197 <input type="text" id="edit-menu-item-url-<?php echo $item_id; ?>" class="widefat code edit-menu-item-url" name="menu-item-url[<?php echo $item_id; ?>]" value="<?php echo esc_attr( $menu_item->url ); ?>" /> 198 </label> 199 </p> 200 <?php endif; ?> 201 <p class="description description-wide"> 202 <label for="edit-menu-item-title-<?php echo $item_id; ?>"> 203 <?php _e( 'Navigation Label' ); ?><br /> 204 <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( $menu_item->title ); ?>" /> 205 </label> 206 </p> 207 <p class="field-title-attribute field-attr-title description description-wide"> 208 <label for="edit-menu-item-attr-title-<?php echo $item_id; ?>"> 209 <?php _e( 'Title Attribute' ); ?><br /> 210 <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( $menu_item->post_excerpt ); ?>" /> 211 </label> 212 </p> 213 <p class="field-link-target description"> 214 <label for="edit-menu-item-target-<?php echo $item_id; ?>"> 215 <input type="checkbox" id="edit-menu-item-target-<?php echo $item_id; ?>" value="_blank" name="menu-item-target[<?php echo $item_id; ?>]"<?php checked( $menu_item->target, '_blank' ); ?> /> 216 <?php _e( 'Open link in a new tab' ); ?> 217 </label> 218 </p> 219 <p class="field-css-classes description description-thin"> 220 <label for="edit-menu-item-classes-<?php echo $item_id; ?>"> 221 <?php _e( 'CSS Classes (optional)' ); ?><br /> 222 <input type="text" id="edit-menu-item-classes-<?php echo $item_id; ?>" class="widefat code edit-menu-item-classes" name="menu-item-classes[<?php echo $item_id; ?>]" value="<?php echo esc_attr( implode( ' ', $menu_item->classes ) ); ?>" /> 223 </label> 224 </p> 225 <p class="field-xfn description description-thin"> 226 <label for="edit-menu-item-xfn-<?php echo $item_id; ?>"> 227 <?php _e( 'Link Relationship (XFN)' ); ?><br /> 228 <input type="text" id="edit-menu-item-xfn-<?php echo $item_id; ?>" class="widefat code edit-menu-item-xfn" name="menu-item-xfn[<?php echo $item_id; ?>]" value="<?php echo esc_attr( $menu_item->xfn ); ?>" /> 229 </label> 230 </p> 231 <p class="field-description description description-wide"> 232 <label for="edit-menu-item-description-<?php echo $item_id; ?>"> 233 <?php _e( 'Description' ); ?><br /> 234 <textarea id="edit-menu-item-description-<?php echo $item_id; ?>" class="widefat edit-menu-item-description" rows="3" cols="20" name="menu-item-description[<?php echo $item_id; ?>]"><?php echo esc_html( $menu_item->description ); // textarea_escaped ?></textarea> 235 <span class="description"><?php _e( 'The description will be displayed in the menu if the active theme supports it.' ); ?></span> 236 </label> 237 </p> 238 239 <?php 240 /** 241 * Fires just before the move buttons of a nav menu item in the menu editor. 242 * 243 * @since 5.4.0 244 * 245 * @param string $item_id Menu item ID as a numeric string. 246 * @param WP_Post $menu_item Menu item data object. 247 * @param int $depth Depth of menu item. Used for padding. 248 * @param stdClass|null $args An object of menu item arguments. 249 * @param int $current_object_id Nav menu ID. 250 */ 251 do_action( 'wp_nav_menu_item_custom_fields', $item_id, $menu_item, $depth, $args, $current_object_id ); 252 ?> 253 254 <fieldset class="field-move hide-if-no-js description description-wide"> 255 <span class="field-move-visual-label" aria-hidden="true"><?php _e( 'Move' ); ?></span> 256 <button type="button" class="button-link menus-move menus-move-up" data-dir="up"><?php _e( 'Up one' ); ?></button> 257 <button type="button" class="button-link menus-move menus-move-down" data-dir="down"><?php _e( 'Down one' ); ?></button> 258 <button type="button" class="button-link menus-move menus-move-left" data-dir="left"></button> 259 <button type="button" class="button-link menus-move menus-move-right" data-dir="right"></button> 260 <button type="button" class="button-link menus-move menus-move-top" data-dir="top"><?php _e( 'To the top' ); ?></button> 261 </fieldset> 262 263 <div class="menu-item-actions description-wide submitbox"> 264 <?php if ( 'custom' !== $menu_item->type && false !== $original_title ) : ?> 265 <p class="link-to-original"> 266 <?php 267 /* translators: %s: Link to menu item's original object. */ 268 printf( __( 'Original: %s' ), '<a href="' . esc_attr( $menu_item->url ) . '">' . esc_html( $original_title ) . '</a>' ); 269 ?> 270 </p> 271 <?php endif; ?> 272 273 <?php 274 printf( 275 '<a class="item-delete submitdelete deletion" id="delete-%s" href="%s">%s</a>', 276 $item_id, 277 wp_nonce_url( 278 add_query_arg( 279 array( 280 'action' => 'delete-menu-item', 281 'menu-item' => $item_id, 282 ), 283 admin_url( 'nav-menus.php' ) 284 ), 285 'delete-menu_item_' . $item_id 286 ), 287 __( 'Remove' ) 288 ); 289 ?> 290 <span class="meta-sep hide-if-no-js"> | </span> 291 <?php 292 printf( 293 '<a class="item-cancel submitcancel hide-if-no-js" id="cancel-%s" href="%s#menu-item-settings-%s">%s</a>', 294 $item_id, 295 esc_url( 296 add_query_arg( 297 array( 298 'edit-menu-item' => $item_id, 299 'cancel' => time(), 300 ), 301 admin_url( 'nav-menus.php' ) 302 ) 303 ), 304 $item_id, 305 __( 'Cancel' ) 306 ); 307 ?> 308 </div> 309 310 <input class="menu-item-data-db-id" type="hidden" name="menu-item-db-id[<?php echo $item_id; ?>]" value="<?php echo $item_id; ?>" /> 311 <input class="menu-item-data-object-id" type="hidden" name="menu-item-object-id[<?php echo $item_id; ?>]" value="<?php echo esc_attr( $menu_item->object_id ); ?>" /> 312 <input class="menu-item-data-object" type="hidden" name="menu-item-object[<?php echo $item_id; ?>]" value="<?php echo esc_attr( $menu_item->object ); ?>" /> 313 <input class="menu-item-data-parent-id" type="hidden" name="menu-item-parent-id[<?php echo $item_id; ?>]" value="<?php echo esc_attr( $menu_item->menu_item_parent ); ?>" /> 314 <input class="menu-item-data-position" type="hidden" name="menu-item-position[<?php echo $item_id; ?>]" value="<?php echo esc_attr( $menu_item->menu_order ); ?>" /> 315 <input class="menu-item-data-type" type="hidden" name="menu-item-type[<?php echo $item_id; ?>]" value="<?php echo esc_attr( $menu_item->type ); ?>" /> 316 </div><!-- .menu-item-settings--> 317 <ul class="menu-item-transport"></ul> 318 <?php 319 $output .= ob_get_clean(); 320 } 321 322 }
title
Description
Body
title
Description
Body
title
Description
Body
title
Body
| Generated: Tue Jul 22 01:00:03 2025 | Cross-referenced by PHPXref 0.7.1 |