[ Index ]

PHP Cross Reference of WordPress Trunk (Updated Daily)

Search

title

Body

[close]

/wp-admin/includes/ -> class-walker-nav-menu-edit.php (source)

   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  
  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">&#8593;</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">&#8595;</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_attr( $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 esc_attr( $menu_item->title ); ?>" />
 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 esc_attr( $menu_item->post_excerpt ); ?>" />
 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                  <p class="field-css-classes description description-thin">
 222                      <label for="edit-menu-item-classes-<?php echo $item_id; ?>">
 223                          <?php _e( 'CSS Classes (optional)' ); ?><br />
 224                          <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 ) ); ?>" />
 225                      </label>
 226                  </p>
 227                  <p class="field-xfn description description-thin">
 228                      <label for="edit-menu-item-xfn-<?php echo $item_id; ?>">
 229                          <?php _e( 'Link Relationship (XFN)' ); ?><br />
 230                          <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 ); ?>" />
 231                      </label>
 232                  </p>
 233                  <p class="field-description description description-wide">
 234                      <label for="edit-menu-item-description-<?php echo $item_id; ?>">
 235                          <?php _e( 'Description' ); ?><br />
 236                          <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>
 237                          <span class="description"><?php _e( 'The description will be displayed in the menu if the active theme supports it.' ); ?></span>
 238                      </label>
 239                  </p>
 240  
 241                  <?php
 242                  /**
 243                   * Fires just before the move buttons of a nav menu item in the menu editor.
 244                   *
 245                   * @since 5.4.0
 246                   *
 247                   * @param string        $item_id           Menu item ID as a numeric string.
 248                   * @param WP_Post       $menu_item         Menu item data object.
 249                   * @param int           $depth             Depth of menu item. Used for padding.
 250                   * @param stdClass|null $args              An object of menu item arguments.
 251                   * @param int           $current_object_id Nav menu ID.
 252                   */
 253                  do_action( 'wp_nav_menu_item_custom_fields', $item_id, $menu_item, $depth, $args, $current_object_id );
 254                  ?>
 255  
 256                  <fieldset class="field-move hide-if-no-js description description-wide">
 257                      <span class="field-move-visual-label" aria-hidden="true"><?php _e( 'Move' ); ?></span>
 258                      <button type="button" class="button-link menus-move menus-move-up" data-dir="up"><?php _e( 'Up one' ); ?></button>
 259                      <button type="button" class="button-link menus-move menus-move-down" data-dir="down"><?php _e( 'Down one' ); ?></button>
 260                      <button type="button" class="button-link menus-move menus-move-left" data-dir="left"></button>
 261                      <button type="button" class="button-link menus-move menus-move-right" data-dir="right"></button>
 262                      <button type="button" class="button-link menus-move menus-move-top" data-dir="top"><?php _e( 'To the top' ); ?></button>
 263                  </fieldset>
 264  
 265                  <div class="menu-item-actions description-wide submitbox">
 266                      <?php if ( 'custom' !== $menu_item->type && false !== $original_title ) : ?>
 267                          <p class="link-to-original">
 268                              <?php
 269                              /* translators: %s: Link to menu item's original object. */
 270                              printf( __( 'Original: %s' ), '<a href="' . esc_url( $menu_item->url ) . '">' . esc_html( $original_title ) . '</a>' );
 271                              ?>
 272                          </p>
 273                      <?php endif; ?>
 274  
 275                      <?php
 276                      printf(
 277                          '<a class="item-delete submitdelete deletion" id="delete-%s" href="%s">%s</a>',
 278                          $item_id,
 279                          wp_nonce_url(
 280                              add_query_arg(
 281                                  array(
 282                                      'action'    => 'delete-menu-item',
 283                                      'menu-item' => $item_id,
 284                                  ),
 285                                  admin_url( 'nav-menus.php' )
 286                              ),
 287                              'delete-menu_item_' . $item_id
 288                          ),
 289                          __( 'Remove' )
 290                      );
 291                      ?>
 292                      <span class="meta-sep hide-if-no-js"> | </span>
 293                      <?php
 294                      printf(
 295                          '<a class="item-cancel submitcancel hide-if-no-js" id="cancel-%s" href="%s#menu-item-settings-%s">%s</a>',
 296                          $item_id,
 297                          esc_url(
 298                              add_query_arg(
 299                                  array(
 300                                      'edit-menu-item' => $item_id,
 301                                      'cancel'         => time(),
 302                                  ),
 303                                  admin_url( 'nav-menus.php' )
 304                              )
 305                          ),
 306                          $item_id,
 307                          __( 'Cancel' )
 308                      );
 309                      ?>
 310                  </div>
 311  
 312                  <input class="menu-item-data-db-id" type="hidden" name="menu-item-db-id[<?php echo $item_id; ?>]" value="<?php echo $item_id; ?>" />
 313                  <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 ); ?>" />
 314                  <input class="menu-item-data-object" type="hidden" name="menu-item-object[<?php echo $item_id; ?>]" value="<?php echo esc_attr( $menu_item->object ); ?>" />
 315                  <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 ); ?>" />
 316                  <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 ); ?>" />
 317                  <input class="menu-item-data-type" type="hidden" name="menu-item-type[<?php echo $item_id; ?>]" value="<?php echo esc_attr( $menu_item->type ); ?>" />
 318              </div><!-- .menu-item-settings-->
 319              <ul class="menu-item-transport"></ul>
 320          <?php
 321          $output .= ob_get_clean();
 322      }
 323  }


Generated : Thu Mar 28 08:20:01 2024 Cross-referenced by PHPXref