[ Index ]

PHP Cross Reference of WordPress

title

Body

[close]

/wp-admin/ -> edit.php (source)

   1  <?php
   2  /**
   3   * Edit Posts Administration Screen.
   4   *
   5   * @package WordPress
   6   * @subpackage Administration
   7   */
   8  
   9  /** WordPress Administration Bootstrap */
  10  require_once  __DIR__ . '/admin.php';
  11  
  12  if ( ! $typenow ) {
  13      wp_die( __( 'Invalid post type.' ) );
  14  }
  15  
  16  if ( ! in_array( $typenow, get_post_types( array( 'show_ui' => true ) ), true ) ) {
  17      wp_die( __( 'Sorry, you are not allowed to edit posts in this post type.' ) );
  18  }
  19  
  20  if ( 'attachment' === $typenow ) {
  21      if ( wp_redirect( admin_url( 'upload.php' ) ) ) {
  22          exit;
  23      }
  24  }
  25  
  26  /**
  27   * @global string       $post_type
  28   * @global WP_Post_Type $post_type_object
  29   */
  30  global $post_type, $post_type_object;
  31  
  32  $post_type        = $typenow;
  33  $post_type_object = get_post_type_object( $post_type );
  34  
  35  if ( ! $post_type_object ) {
  36      wp_die( __( 'Invalid post type.' ) );
  37  }
  38  
  39  if ( ! current_user_can( $post_type_object->cap->edit_posts ) ) {
  40      wp_die(
  41          '<h1>' . __( 'You need a higher level of permission.' ) . '</h1>' .
  42          '<p>' . __( 'Sorry, you are not allowed to edit posts in this post type.' ) . '</p>',
  43          403
  44      );
  45  }
  46  
  47  $wp_list_table = _get_list_table( 'WP_Posts_List_Table' );
  48  $pagenum       = $wp_list_table->get_pagenum();
  49  
  50  // Back-compat for viewing comments of an entry.
  51  foreach ( array( 'p', 'attachment_id', 'page_id' ) as $_redirect ) {
  52      if ( ! empty( $_REQUEST[ $_redirect ] ) ) {
  53          wp_redirect( admin_url( 'edit-comments.php?p=' . absint( $_REQUEST[ $_redirect ] ) ) );
  54          exit;
  55      }
  56  }
  57  unset( $_redirect );
  58  
  59  if ( 'post' !== $post_type ) {
  60      $parent_file   = "edit.php?post_type=$post_type";
  61      $submenu_file  = "edit.php?post_type=$post_type";
  62      $post_new_file = "post-new.php?post_type=$post_type";
  63  } else {
  64      $parent_file   = 'edit.php';
  65      $submenu_file  = 'edit.php';
  66      $post_new_file = 'post-new.php';
  67  }
  68  
  69  $doaction = $wp_list_table->current_action();
  70  
  71  if ( $doaction ) {
  72      check_admin_referer( 'bulk-posts' );
  73  
  74      $sendback = remove_query_arg( array( 'trashed', 'untrashed', 'deleted', 'locked', 'ids' ), wp_get_referer() );
  75      if ( ! $sendback ) {
  76          $sendback = admin_url( $parent_file );
  77      }
  78      $sendback = add_query_arg( 'paged', $pagenum, $sendback );
  79      if ( strpos( $sendback, 'post.php' ) !== false ) {
  80          $sendback = admin_url( $post_new_file );
  81      }
  82  
  83      $post_ids = array();
  84  
  85      if ( 'delete_all' === $doaction ) {
  86          // Prepare for deletion of all posts with a specified post status (i.e. Empty Trash).
  87          $post_status = preg_replace( '/[^a-z0-9_-]+/i', '', $_REQUEST['post_status'] );
  88          // Validate the post status exists.
  89          if ( get_post_status_object( $post_status ) ) {
  90              $post_ids = $wpdb->get_col( $wpdb->prepare( "SELECT ID FROM $wpdb->posts WHERE post_type=%s AND post_status = %s", $post_type, $post_status ) );
  91          }
  92          $doaction = 'delete';
  93      } elseif ( isset( $_REQUEST['media'] ) ) {
  94          $post_ids = $_REQUEST['media'];
  95      } elseif ( isset( $_REQUEST['ids'] ) ) {
  96          $post_ids = explode( ',', $_REQUEST['ids'] );
  97      } elseif ( ! empty( $_REQUEST['post'] ) ) {
  98          $post_ids = array_map( 'intval', $_REQUEST['post'] );
  99      }
 100  
 101      if ( empty( $post_ids ) ) {
 102          wp_redirect( $sendback );
 103          exit;
 104      }
 105  
 106      switch ( $doaction ) {
 107          case 'trash':
 108              $trashed = 0;
 109              $locked  = 0;
 110  
 111              foreach ( (array) $post_ids as $post_id ) {
 112                  if ( ! current_user_can( 'delete_post', $post_id ) ) {
 113                      wp_die( __( 'Sorry, you are not allowed to move this item to the Trash.' ) );
 114                  }
 115  
 116                  if ( wp_check_post_lock( $post_id ) ) {
 117                      $locked++;
 118                      continue;
 119                  }
 120  
 121                  if ( ! wp_trash_post( $post_id ) ) {
 122                      wp_die( __( 'Error in moving the item to Trash.' ) );
 123                  }
 124  
 125                  $trashed++;
 126              }
 127  
 128              $sendback = add_query_arg(
 129                  array(
 130                      'trashed' => $trashed,
 131                      'ids'     => implode( ',', $post_ids ),
 132                      'locked'  => $locked,
 133                  ),
 134                  $sendback
 135              );
 136              break;
 137          case 'untrash':
 138              $untrashed = 0;
 139  
 140              if ( isset( $_GET['doaction'] ) && ( 'undo' === $_GET['doaction'] ) ) {
 141                  add_filter( 'wp_untrash_post_status', 'wp_untrash_post_set_previous_status', 10, 3 );
 142              }
 143  
 144              foreach ( (array) $post_ids as $post_id ) {
 145                  if ( ! current_user_can( 'delete_post', $post_id ) ) {
 146                      wp_die( __( 'Sorry, you are not allowed to restore this item from the Trash.' ) );
 147                  }
 148  
 149                  if ( ! wp_untrash_post( $post_id ) ) {
 150                      wp_die( __( 'Error in restoring the item from Trash.' ) );
 151                  }
 152  
 153                  $untrashed++;
 154              }
 155              $sendback = add_query_arg( 'untrashed', $untrashed, $sendback );
 156  
 157              remove_filter( 'wp_untrash_post_status', 'wp_untrash_post_set_previous_status', 10 );
 158  
 159              break;
 160          case 'delete':
 161              $deleted = 0;
 162              foreach ( (array) $post_ids as $post_id ) {
 163                  $post_del = get_post( $post_id );
 164  
 165                  if ( ! current_user_can( 'delete_post', $post_id ) ) {
 166                      wp_die( __( 'Sorry, you are not allowed to delete this item.' ) );
 167                  }
 168  
 169                  if ( 'attachment' === $post_del->post_type ) {
 170                      if ( ! wp_delete_attachment( $post_id ) ) {
 171                          wp_die( __( 'Error in deleting the attachment.' ) );
 172                      }
 173                  } else {
 174                      if ( ! wp_delete_post( $post_id ) ) {
 175                          wp_die( __( 'Error in deleting the item.' ) );
 176                      }
 177                  }
 178                  $deleted++;
 179              }
 180              $sendback = add_query_arg( 'deleted', $deleted, $sendback );
 181              break;
 182          case 'edit':
 183              if ( isset( $_REQUEST['bulk_edit'] ) ) {
 184                  $done = bulk_edit_posts( $_REQUEST );
 185  
 186                  if ( is_array( $done ) ) {
 187                      $done['updated'] = count( $done['updated'] );
 188                      $done['skipped'] = count( $done['skipped'] );
 189                      $done['locked']  = count( $done['locked'] );
 190                      $sendback        = add_query_arg( $done, $sendback );
 191                  }
 192              }
 193              break;
 194          default:
 195              $screen = get_current_screen()->id;
 196  
 197              /**
 198               * Fires when a custom bulk action should be handled.
 199               *
 200               * The redirect link should be modified with success or failure feedback
 201               * from the action to be used to display feedback to the user.
 202               *
 203               * The dynamic portion of the hook name, `$screen`, refers to the current screen ID.
 204               *
 205               * @since 4.7.0
 206               *
 207               * @param string $sendback The redirect URL.
 208               * @param string $doaction The action being taken.
 209               * @param array  $items    The items to take the action on. Accepts an array of IDs of posts,
 210               *                         comments, terms, links, plugins, attachments, or users.
 211               */
 212              $sendback = apply_filters( "handle_bulk_actions-{$screen}", $sendback, $doaction, $post_ids ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores
 213              break;
 214      }
 215  
 216      $sendback = remove_query_arg( array( 'action', 'action2', 'tags_input', 'post_author', 'comment_status', 'ping_status', '_status', 'post', 'bulk_edit', 'post_view' ), $sendback );
 217  
 218      wp_redirect( $sendback );
 219      exit;
 220  } elseif ( ! empty( $_REQUEST['_wp_http_referer'] ) ) {
 221      wp_redirect( remove_query_arg( array( '_wp_http_referer', '_wpnonce' ), wp_unslash( $_SERVER['REQUEST_URI'] ) ) );
 222      exit;
 223  }
 224  
 225  $wp_list_table->prepare_items();
 226  
 227  wp_enqueue_script( 'inline-edit-post' );
 228  wp_enqueue_script( 'heartbeat' );
 229  
 230  if ( 'wp_block' === $post_type ) {
 231      wp_enqueue_script( 'wp-list-reusable-blocks' );
 232      wp_enqueue_style( 'wp-list-reusable-blocks' );
 233  }
 234  
 235  // Used in the HTML title tag.
 236  $title = $post_type_object->labels->name;
 237  
 238  if ( 'post' === $post_type ) {
 239      get_current_screen()->add_help_tab(
 240          array(
 241              'id'      => 'overview',
 242              'title'   => __( 'Overview' ),
 243              'content' =>
 244                      '<p>' . __( 'This screen provides access to all of your posts. You can customize the display of this screen to suit your workflow.' ) . '</p>',
 245          )
 246      );
 247      get_current_screen()->add_help_tab(
 248          array(
 249              'id'      => 'screen-content',
 250              'title'   => __( 'Screen Content' ),
 251              'content' =>
 252                      '<p>' . __( 'You can customize the display of this screen&#8217;s contents in a number of ways:' ) . '</p>' .
 253                      '<ul>' .
 254                          '<li>' . __( 'You can hide/display columns based on your needs and decide how many posts to list per screen using the Screen Options tab.' ) . '</li>' .
 255                          '<li>' . __( 'You can filter the list of posts by post status using the text links above the posts list to only show posts with that status. The default view is to show all posts.' ) . '</li>' .
 256                          '<li>' . __( 'You can view posts in a simple title list or with an excerpt using the Screen Options tab.' ) . '</li>' .
 257                          '<li>' . __( 'You can refine the list to show only posts in a specific category or from a specific month by using the dropdown menus above the posts list. Click the Filter button after making your selection. You also can refine the list by clicking on the post author, category or tag in the posts list.' ) . '</li>' .
 258                      '</ul>',
 259          )
 260      );
 261      get_current_screen()->add_help_tab(
 262          array(
 263              'id'      => 'action-links',
 264              'title'   => __( 'Available Actions' ),
 265              'content' =>
 266                      '<p>' . __( 'Hovering over a row in the posts list will display action links that allow you to manage your post. You can perform the following actions:' ) . '</p>' .
 267                      '<ul>' .
 268                          '<li>' . __( '<strong>Edit</strong> takes you to the editing screen for that post. You can also reach that screen by clicking on the post title.' ) . '</li>' .
 269                          '<li>' . __( '<strong>Quick Edit</strong> provides inline access to the metadata of your post, allowing you to update post details without leaving this screen.' ) . '</li>' .
 270                          '<li>' . __( '<strong>Trash</strong> removes your post from this list and places it in the Trash, from which you can permanently delete it.' ) . '</li>' .
 271                          '<li>' . __( '<strong>Preview</strong> will show you what your draft post will look like if you publish it. View will take you to your live site to view the post. Which link is available depends on your post&#8217;s status.' ) . '</li>' .
 272                      '</ul>',
 273          )
 274      );
 275      get_current_screen()->add_help_tab(
 276          array(
 277              'id'      => 'bulk-actions',
 278              'title'   => __( 'Bulk actions' ),
 279              'content' =>
 280                      '<p>' . __( 'You can also edit or move multiple posts to the Trash at once. Select the posts you want to act on using the checkboxes, then select the action you want to take from the Bulk actions menu and click Apply.' ) . '</p>' .
 281                              '<p>' . __( 'When using Bulk Edit, you can change the metadata (categories, author, etc.) for all selected posts at once. To remove a post from the grouping, just click the x next to its name in the Bulk Edit area that appears.' ) . '</p>',
 282          )
 283      );
 284  
 285      get_current_screen()->set_help_sidebar(
 286          '<p><strong>' . __( 'For more information:' ) . '</strong></p>' .
 287          '<p>' . __( '<a href="https://wordpress.org/support/article/posts-screen/">Documentation on Managing Posts</a>' ) . '</p>' .
 288          '<p>' . __( '<a href="https://wordpress.org/support/">Support</a>' ) . '</p>'
 289      );
 290  
 291  } elseif ( 'page' === $post_type ) {
 292      get_current_screen()->add_help_tab(
 293          array(
 294              'id'      => 'overview',
 295              'title'   => __( 'Overview' ),
 296              'content' =>
 297                      '<p>' . __( 'Pages are similar to posts in that they have a title, body text, and associated metadata, but they are different in that they are not part of the chronological blog stream, kind of like permanent posts. Pages are not categorized or tagged, but can have a hierarchy. You can nest pages under other pages by making one the &#8220;Parent&#8221; of the other, creating a group of pages.' ) . '</p>',
 298          )
 299      );
 300      get_current_screen()->add_help_tab(
 301          array(
 302              'id'      => 'managing-pages',
 303              'title'   => __( 'Managing Pages' ),
 304              'content' =>
 305                      '<p>' . __( 'Managing pages is very similar to managing posts, and the screens can be customized in the same way.' ) . '</p>' .
 306                      '<p>' . __( 'You can also perform the same types of actions, including narrowing the list by using the filters, acting on a page using the action links that appear when you hover over a row, or using the Bulk actions menu to edit the metadata for multiple pages at once.' ) . '</p>',
 307          )
 308      );
 309  
 310      get_current_screen()->set_help_sidebar(
 311          '<p><strong>' . __( 'For more information:' ) . '</strong></p>' .
 312          '<p>' . __( '<a href="https://wordpress.org/support/article/pages-screen/">Documentation on Managing Pages</a>' ) . '</p>' .
 313          '<p>' . __( '<a href="https://wordpress.org/support/">Support</a>' ) . '</p>'
 314      );
 315  
 316  }
 317  
 318  get_current_screen()->set_screen_reader_content(
 319      array(
 320          'heading_views'      => $post_type_object->labels->filter_items_list,
 321          'heading_pagination' => $post_type_object->labels->items_list_navigation,
 322          'heading_list'       => $post_type_object->labels->items_list,
 323      )
 324  );
 325  
 326  add_screen_option(
 327      'per_page',
 328      array(
 329          'default' => 20,
 330          'option'  => 'edit_' . $post_type . '_per_page',
 331      )
 332  );
 333  
 334  $bulk_counts = array(
 335      'updated'   => isset( $_REQUEST['updated'] ) ? absint( $_REQUEST['updated'] ) : 0,
 336      'locked'    => isset( $_REQUEST['locked'] ) ? absint( $_REQUEST['locked'] ) : 0,
 337      'deleted'   => isset( $_REQUEST['deleted'] ) ? absint( $_REQUEST['deleted'] ) : 0,
 338      'trashed'   => isset( $_REQUEST['trashed'] ) ? absint( $_REQUEST['trashed'] ) : 0,
 339      'untrashed' => isset( $_REQUEST['untrashed'] ) ? absint( $_REQUEST['untrashed'] ) : 0,
 340  );
 341  
 342  $bulk_messages             = array();
 343  $bulk_messages['post']     = array(
 344      /* translators: %s: Number of posts. */
 345      'updated'   => _n( '%s post updated.', '%s posts updated.', $bulk_counts['updated'] ),
 346      'locked'    => ( 1 === $bulk_counts['locked'] ) ? __( '1 post not updated, somebody is editing it.' ) :
 347                      /* translators: %s: Number of posts. */
 348                      _n( '%s post not updated, somebody is editing it.', '%s posts not updated, somebody is editing them.', $bulk_counts['locked'] ),
 349      /* translators: %s: Number of posts. */
 350      'deleted'   => _n( '%s post permanently deleted.', '%s posts permanently deleted.', $bulk_counts['deleted'] ),
 351      /* translators: %s: Number of posts. */
 352      'trashed'   => _n( '%s post moved to the Trash.', '%s posts moved to the Trash.', $bulk_counts['trashed'] ),
 353      /* translators: %s: Number of posts. */
 354      'untrashed' => _n( '%s post restored from the Trash.', '%s posts restored from the Trash.', $bulk_counts['untrashed'] ),
 355  );
 356  $bulk_messages['page']     = array(
 357      /* translators: %s: Number of pages. */
 358      'updated'   => _n( '%s page updated.', '%s pages updated.', $bulk_counts['updated'] ),
 359      'locked'    => ( 1 === $bulk_counts['locked'] ) ? __( '1 page not updated, somebody is editing it.' ) :
 360                      /* translators: %s: Number of pages. */
 361                      _n( '%s page not updated, somebody is editing it.', '%s pages not updated, somebody is editing them.', $bulk_counts['locked'] ),
 362      /* translators: %s: Number of pages. */
 363      'deleted'   => _n( '%s page permanently deleted.', '%s pages permanently deleted.', $bulk_counts['deleted'] ),
 364      /* translators: %s: Number of pages. */
 365      'trashed'   => _n( '%s page moved to the Trash.', '%s pages moved to the Trash.', $bulk_counts['trashed'] ),
 366      /* translators: %s: Number of pages. */
 367      'untrashed' => _n( '%s page restored from the Trash.', '%s pages restored from the Trash.', $bulk_counts['untrashed'] ),
 368  );
 369  $bulk_messages['wp_block'] = array(
 370      /* translators: %s: Number of blocks. */
 371      'updated'   => _n( '%s block updated.', '%s blocks updated.', $bulk_counts['updated'] ),
 372      'locked'    => ( 1 === $bulk_counts['locked'] ) ? __( '1 block not updated, somebody is editing it.' ) :
 373                      /* translators: %s: Number of blocks. */
 374                      _n( '%s block not updated, somebody is editing it.', '%s blocks not updated, somebody is editing them.', $bulk_counts['locked'] ),
 375      /* translators: %s: Number of blocks. */
 376      'deleted'   => _n( '%s block permanently deleted.', '%s blocks permanently deleted.', $bulk_counts['deleted'] ),
 377      /* translators: %s: Number of blocks. */
 378      'trashed'   => _n( '%s block moved to the Trash.', '%s blocks moved to the Trash.', $bulk_counts['trashed'] ),
 379      /* translators: %s: Number of blocks. */
 380      'untrashed' => _n( '%s block restored from the Trash.', '%s blocks restored from the Trash.', $bulk_counts['untrashed'] ),
 381  );
 382  
 383  /**
 384   * Filters the bulk action updated messages.
 385   *
 386   * By default, custom post types use the messages for the 'post' post type.
 387   *
 388   * @since 3.7.0
 389   *
 390   * @param array[] $bulk_messages Arrays of messages, each keyed by the corresponding post type. Messages are
 391   *                               keyed with 'updated', 'locked', 'deleted', 'trashed', and 'untrashed'.
 392   * @param int[]   $bulk_counts   Array of item counts for each message, used to build internationalized strings.
 393   */
 394  $bulk_messages = apply_filters( 'bulk_post_updated_messages', $bulk_messages, $bulk_counts );
 395  $bulk_counts   = array_filter( $bulk_counts );
 396  
 397  require_once ABSPATH . 'wp-admin/admin-header.php';
 398  ?>
 399  <div class="wrap">
 400  <h1 class="wp-heading-inline">
 401  <?php
 402  echo esc_html( $post_type_object->labels->name );
 403  ?>
 404  </h1>
 405  
 406  <?php
 407  if ( current_user_can( $post_type_object->cap->create_posts ) ) {
 408      echo ' <a href="' . esc_url( admin_url( $post_new_file ) ) . '" class="page-title-action">' . esc_html( $post_type_object->labels->add_new ) . '</a>';
 409  }
 410  
 411  if ( isset( $_REQUEST['s'] ) && strlen( $_REQUEST['s'] ) ) {
 412      echo '<span class="subtitle">';
 413      printf(
 414          /* translators: %s: Search query. */
 415          __( 'Search results for: %s' ),
 416          '<strong>' . get_search_query() . '</strong>'
 417      );
 418      echo '</span>';
 419  }
 420  ?>
 421  
 422  <hr class="wp-header-end">
 423  
 424  <?php
 425  // If we have a bulk message to issue:
 426  $messages = array();
 427  foreach ( $bulk_counts as $message => $count ) {
 428      if ( isset( $bulk_messages[ $post_type ][ $message ] ) ) {
 429          $messages[] = sprintf( $bulk_messages[ $post_type ][ $message ], number_format_i18n( $count ) );
 430      } elseif ( isset( $bulk_messages['post'][ $message ] ) ) {
 431          $messages[] = sprintf( $bulk_messages['post'][ $message ], number_format_i18n( $count ) );
 432      }
 433  
 434      if ( 'trashed' === $message && isset( $_REQUEST['ids'] ) ) {
 435          $ids        = preg_replace( '/[^0-9,]/', '', $_REQUEST['ids'] );
 436          $messages[] = '<a href="' . esc_url( wp_nonce_url( "edit.php?post_type=$post_type&doaction=undo&action=untrash&ids=$ids", 'bulk-posts' ) ) . '">' . __( 'Undo' ) . '</a>';
 437      }
 438  
 439      if ( 'untrashed' === $message && isset( $_REQUEST['ids'] ) ) {
 440          $ids = explode( ',', $_REQUEST['ids'] );
 441  
 442          if ( 1 === count( $ids ) && current_user_can( 'edit_post', $ids[0] ) ) {
 443              $messages[] = sprintf(
 444                  '<a href="%1$s">%2$s</a>',
 445                  esc_url( get_edit_post_link( $ids[0] ) ),
 446                  esc_html( get_post_type_object( get_post_type( $ids[0] ) )->labels->edit_item )
 447              );
 448          }
 449      }
 450  }
 451  
 452  if ( $messages ) {
 453      echo '<div id="message" class="updated notice is-dismissible"><p>' . implode( ' ', $messages ) . '</p></div>';
 454  }
 455  unset( $messages );
 456  
 457  $_SERVER['REQUEST_URI'] = remove_query_arg( array( 'locked', 'skipped', 'updated', 'deleted', 'trashed', 'untrashed' ), $_SERVER['REQUEST_URI'] );
 458  ?>
 459  
 460  <?php $wp_list_table->views(); ?>
 461  
 462  <form id="posts-filter" method="get">
 463  
 464  <?php $wp_list_table->search_box( $post_type_object->labels->search_items, 'post' ); ?>
 465  
 466  <input type="hidden" name="post_status" class="post_status_page" value="<?php echo ! empty( $_REQUEST['post_status'] ) ? esc_attr( $_REQUEST['post_status'] ) : 'all'; ?>" />
 467  <input type="hidden" name="post_type" class="post_type_page" value="<?php echo $post_type; ?>" />
 468  
 469  <?php if ( ! empty( $_REQUEST['author'] ) ) { ?>
 470  <input type="hidden" name="author" value="<?php echo esc_attr( $_REQUEST['author'] ); ?>" />
 471  <?php } ?>
 472  
 473  <?php if ( ! empty( $_REQUEST['show_sticky'] ) ) { ?>
 474  <input type="hidden" name="show_sticky" value="1" />
 475  <?php } ?>
 476  
 477  <?php $wp_list_table->display(); ?>
 478  
 479  </form>
 480  
 481  <?php
 482  if ( $wp_list_table->has_items() ) {
 483      $wp_list_table->inline_edit();
 484  }
 485  ?>
 486  
 487  <div id="ajax-response"></div>
 488  <div class="clear"></div>
 489  </div>
 490  
 491  <?php
 492  require_once ABSPATH . 'wp-admin/admin-footer.php';


Generated: Tue Mar 19 01:00:02 2024 Cross-referenced by PHPXref 0.7.1