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 */
17class 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
66 $_wp_nav_menu_max_depth = $depth > $_wp_nav_menu_max_depth ? $depth : $_wp_nav_menu_max_depth;
67
68 ob_start();
69 $item_id = esc_attr( $menu_item->ID );
70 $removed_args = array(
71 'action',
72 'customlink-tab',
73 'edit-menu-item',
74 'menu-item',
75 'page-tab',
76 '_wpnonce',
77 );
78
79 $original_title = false;
80
81 if ( 'taxonomy' === $menu_item->type ) {
82 $original_object = get_term( (int) $menu_item->object_id, $menu_item->object );
83 if ( $original_object && ! is_wp_error( $original_object ) ) {
84 $original_title = $original_object->name;
85 }
86 } elseif ( 'post_type' === $menu_item->type ) {
87 $original_object = get_post( $menu_item->object_id );
88 if ( $original_object ) {
89 $original_title = get_the_title( $original_object->ID );
90 }
91 } elseif ( 'post_type_archive' === $menu_item->type ) {
92 $original_object = get_post_type_object( $menu_item->object );
93 if ( $original_object ) {
94 $original_title = $original_object->labels->archives;
95 }
96 }
97
98 $classes = array(
99 'menu-item menu-item-depth-' . $depth,
100 'menu-item-' . esc_attr( $menu_item->object ),
101 'menu-item-edit-' . ( ( isset( $_GET['edit-menu-item'] ) && $item_id === $_GET['edit-menu-item'] ) ? 'active' : 'inactive' ),
102 );
103
104 $title = $menu_item->title;
105
106 if ( ! empty( $menu_item->_invalid ) ) {
107 $classes[] = 'menu-item-invalid';
108 /* translators: %s: Title of an invalid menu item. */
109 $title = sprintf( __( '%s (Invalid)' ), $menu_item->title );
110 } elseif ( isset( $menu_item->post_status ) && 'draft' === $menu_item->post_status ) {
111 $classes[] = 'pending';
112 /* translators: %s: Title of a menu item in draft status. */
113 $title = sprintf( __( '%s (Pending)' ), $menu_item->title );
114 }
115
116 $title = ( ! isset( $menu_item->label ) || '' === $menu_item->label ) ? $title : $menu_item->label;
117
118 $submenu_text = '';
119 if ( 0 === $depth ) {
120 $submenu_text = 'style="display: none;"';
121 }
122
123 ?>
124 <li id="menu-item-<?php echo $item_id; ?>" class="<?php echo implode( ' ', $classes ); ?>">
125 <div class="menu-item-bar">
126 <div class="menu-item-handle">
127 <label class="item-title" for="menu-item-checkbox-<?php echo $item_id; ?>">
128 <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" />
129 <span class="menu-item-title"><?php echo esc_html( $title ); ?></span>
130 <span class="is-submenu" <?php echo $submenu_text; ?>><?php _e( 'sub item' ); ?></span>
131 </label>
132 <span class="item-controls">
133 <span class="item-type"><?php echo esc_html( $menu_item->type_label ); ?></span>
134 <span class="item-order hide-if-js">
135 <?php
136 printf(
137 '<a href="%s" class="item-move-up" aria-label="%s">↑</a>',
138 wp_nonce_url(
139 add_query_arg(
140 array(
141 'action' => 'move-up-menu-item',
142 'menu-item' => $item_id,
143 ),
144 remove_query_arg( $removed_args, admin_url( 'nav-menus.php' ) )
145 ),
146 'move-menu_item'
147 ),
148 esc_attr__( 'Move up' )
149 );
150 ?>
151 |
152 <?php
153 printf(
154 '<a href="%s" class="item-move-down" aria-label="%s">↓</a>',
155 wp_nonce_url(
156 add_query_arg(
157 array(
158 'action' => 'move-down-menu-item',
159 'menu-item' => $item_id,
160 ),
161 remove_query_arg( $removed_args, admin_url( 'nav-menus.php' ) )
162 ),
163 'move-menu_item'
164 ),
165 esc_attr__( 'Move down' )
166 );
167 ?>
168 </span>
169 <?php
170 if ( isset( $_GET['edit-menu-item'] ) && $item_id === $_GET['edit-menu-item'] ) {
171 $edit_url = admin_url( 'nav-menus.php' );
172 } else {
173 $edit_url = add_query_arg(
174 array(
175 'edit-menu-item' => $item_id,
176 ),
177 remove_query_arg( $removed_args, admin_url( 'nav-menus.php#menu-item-settings-' . $item_id ) )
178 );
179 }
180
181 printf(
182 '<a class="item-edit" id="edit-%s" href="%s" aria-label="%s"><span class="screen-reader-text">%s</span></a>',
183 $item_id,
184 esc_url( $edit_url ),
185 esc_attr__( 'Edit menu item' ),
186 /* translators: Hidden accessibility text. */
187 __( 'Edit' )
188 );
189 ?>
190 </span>
191 </div>
192 </div>
193
194 <div class="menu-item-settings wp-clearfix" id="menu-item-settings-<?php echo $item_id; ?>">
195 <?php if ( 'custom' === $menu_item->type ) : ?>
196 <p class="field-url description description-wide">
197 <label for="edit-menu-item-url-<?php echo $item_id; ?>">
198 <?php _e( 'URL' ); ?><br />
199 <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_url( $menu_item->url ); ?>" />
200 </label>
201 </p>
202 <?php endif; ?>
203 <p class="description description-wide">
204 <label for="edit-menu-item-title-<?php echo $item_id; ?>">
205 <?php _e( 'Navigation Label' ); ?><br />
206 <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 htmlspecialchars( $menu_item->title, ENT_QUOTES ); ?>" />
207 </label>
208 </p>
209 <p class="field-title-attribute field-attr-title description description-wide">
210 <label for="edit-menu-item-attr-title-<?php echo $item_id; ?>">
211 <?php _e( 'Title Attribute' ); ?><br />
212 <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 htmlspecialchars( $menu_item->post_excerpt, ENT_QUOTES ); ?>" />
213 </label>
214 </p>
215 <p class="field-link-target description">
216 <label for="edit-menu-item-target-<?php echo $item_id; ?>">
217 <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' ); ?> />
218 <?php _e( 'Open link in a new tab' ); ?>
219 </label>
220 </p>
221 <div class="description-group">
222 <p class="field-css-classes description description-thin">
223 <label for="edit-menu-item-classes-<?php echo $item_id; ?>">
224 <?php _e( 'CSS Classes (optional)' ); ?><br />
225 <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 htmlspecialchars( implode( ' ', $menu_item->classes ), ENT_QUOTES ); ?>" />
226 </label>
227 </p>
228 <p class="field-xfn description description-thin">
229 <label for="edit-menu-item-xfn-<?php echo $item_id; ?>">
230 <?php _e( 'Link Relationship (XFN)' ); ?><br />
231 <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 htmlspecialchars( $menu_item->xfn, ENT_QUOTES ); ?>" />
232 </label>
233 </p>
234 </div>
235 <p class="field-description description description-wide">
236 <label for="edit-menu-item-description-<?php echo $item_id; ?>">
237 <?php _e( 'Description' ); ?><br />
238 <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_textarea( $menu_item->description ); // textarea_escaped ?></textarea>
239 <span class="description"><?php _e( 'The description will be displayed in the menu if the active theme supports it.' ); ?></span>
240 </label>
241 </p>
242
243 <?php
244 /**
245 * Update parent and order of menu item using select inputs.
246 *
247 * @since 6.7.0
248 */
249 ?>
250
251 <div class="field-move-combo description-group">
252 <p class="description description-wide">
253 <label for="edit-menu-item-parent-<?php echo $item_id; ?>">
254 <?php _e( 'Menu Parent' ); ?>
255 </label>
256 <select class="edit-menu-item-parent widefat" id="edit-menu-item-parent-<?php echo $item_id; ?>" name="menu-item-parent[<?php echo $item_id; ?>]">
257 </select>
258 </p>
259 <p class="description description-wide">
260 <label for="edit-menu-item-order-<?php echo $item_id; ?>">
261 <?php _e( 'Menu Order' ); ?>
262 </label>
263 <select class="edit-menu-item-order widefat" id="edit-menu-item-order-<?php echo $item_id; ?>" name="menu-item-order[<?php echo $item_id; ?>]">
264 </select>
265 </p>
266 </div>
267
268 <?php
269 /**
270 * Fires just before the move buttons of a nav menu item in the menu editor.
271 *
272 * @since 5.4.0
273 *
274 * @param string $item_id Menu item ID as a numeric string.
275 * @param WP_Post $menu_item Menu item data object.
276 * @param int $depth Depth of menu item. Used for padding.
277 * @param stdClass|null $args An object of menu item arguments.
278 * @param int $current_object_id Nav menu ID.
279 */
280 do_action( 'wp_nav_menu_item_custom_fields', $item_id, $menu_item, $depth, $args, $current_object_id );
281 ?>
282
283 <fieldset class="field-move hide-if-no-js description description-wide">
284 <span class="field-move-visual-label" aria-hidden="true"><?php _e( 'Move' ); ?></span>
285 <button type="button" class="button-link menus-move menus-move-up" data-dir="up"><?php _e( 'Up one' ); ?></button>
286 <button type="button" class="button-link menus-move menus-move-down" data-dir="down"><?php _e( 'Down one' ); ?></button>
287 <button type="button" class="button-link menus-move menus-move-left" data-dir="left"></button>
288 <button type="button" class="button-link menus-move menus-move-right" data-dir="right"></button>
289 <button type="button" class="button-link menus-move menus-move-top" data-dir="top"><?php _e( 'To the top' ); ?></button>
290 </fieldset>
291
292 <div class="menu-item-actions description-wide submitbox">
293 <?php if ( 'custom' !== $menu_item->type && false !== $original_title ) : ?>
294 <p class="link-to-original">
295 <?php
296 /* translators: %s: Link to menu item's original object. */
297 printf( __( 'Original: %s' ), '<a href="' . esc_url( $menu_item->url ) . '">' . esc_html( $original_title ) . '</a>' );
298 ?>
299 </p>
300 <?php endif; ?>
301
302 <?php
303 printf(
304 '<a class="item-delete submitdelete deletion" id="delete-%s" href="%s">%s</a>',
305 $item_id,
306 wp_nonce_url(
307 add_query_arg(
308 array(
309 'action' => 'delete-menu-item',
310 'menu-item' => $item_id,
311 ),
312 admin_url( 'nav-menus.php' )
313 ),
314 'delete-menu_item_' . $item_id
315 ),
316 __( 'Remove' )
317 );
318 ?>
319 <span class="meta-sep hide-if-no-js"> | </span>
320 <?php
321 printf(
322 '<a class="item-cancel submitcancel hide-if-no-js" id="cancel-%s" href="%s#menu-item-settings-%s">%s</a>',
323 $item_id,
324 esc_url(
325 add_query_arg(
326 array(
327 'edit-menu-item' => $item_id,
328 'cancel' => time(),
329 ),
330 admin_url( 'nav-menus.php' )
331 )
332 ),
333 $item_id,
334 __( 'Cancel' )
335 );
336 ?>
337 </div>
338
339 <input class="menu-item-data-db-id" type="hidden" name="menu-item-db-id[<?php echo $item_id; ?>]" value="<?php echo $item_id; ?>" />
340 <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 ); ?>" />
341 <input class="menu-item-data-object" type="hidden" name="menu-item-object[<?php echo $item_id; ?>]" value="<?php echo esc_attr( $menu_item->object ); ?>" />
342 <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 ); ?>" />
343 <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 ); ?>" />
344 <input class="menu-item-data-type" type="hidden" name="menu-item-type[<?php echo $item_id; ?>]" value="<?php echo esc_attr( $menu_item->type ); ?>" />
345 </div><!-- .menu-item-settings-->
346 <ul class="menu-item-transport"></ul>
347 <?php
348 $output .= ob_get_clean();
349 }
350}