class-walker-nav-menu-edit.php 13 KB

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