[ 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( dirname( __FILE__ ) . '/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 ) ) ) ) {
  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      if ( 'delete_all' === $doaction ) {
  84          // Prepare for deletion of all posts with a specified post status (i.e. Empty trash).
  85          $post_status = preg_replace( '/[^a-z0-9_-]+/i', '', $_REQUEST['post_status'] );
  86          // Validate the post status exists.
  87          if ( get_post_status_object( $post_status ) ) {
  88              $post_ids = $wpdb->get_col( $wpdb->prepare( "SELECT ID FROM $wpdb->posts WHERE post_type=%s AND post_status = %s", $post_type, $post_status ) );
  89          }
  90          $doaction = 'delete';
  91      } elseif ( isset( $_REQUEST['media'] ) ) {
  92          $post_ids = $_REQUEST['media'];
  93      } elseif ( isset( $_REQUEST['ids'] ) ) {
  94          $post_ids = explode( ',', $_REQUEST['ids'] );
  95      } elseif ( ! empty( $_REQUEST['post'] ) ) {
  96          $post_ids = array_map( 'intval', $_REQUEST['post'] );
  97      }
  98  
  99      if ( ! isset( $post_ids ) ) {
 100          wp_redirect( $sendback );
 101          exit;
 102      }
 103  
 104      switch ( $doaction ) {
 105          case 'trash':
 106              $trashed = 0;
 107              $locked  = 0;
 108  
 109              foreach ( (array) $post_ids as $post_id ) {
 110                  if ( ! current_user_can( 'delete_post', $post_id ) ) {
 111                      wp_die( __( 'Sorry, you are not allowed to move this item to the Trash.' ) );
 112                  }
 113  
 114                  if ( wp_check_post_lock( $post_id ) ) {
 115                      $locked++;
 116                      continue;
 117                  }
 118  
 119                  if ( ! wp_trash_post( $post_id ) ) {
 120                      wp_die( __( 'Error in moving to Trash.' ) );
 121                  }
 122  
 123                  $trashed++;
 124              }
 125  
 126              $sendback = add_query_arg(
 127                  array(
 128                      'trashed' => $trashed,
 129                      'ids'     => join( ',', $post_ids ),
 130                      'locked'  => $locked,
 131                  ),
 132                  $sendback
 133              );
 134              break;
 135          case 'untrash':
 136              $untrashed = 0;
 137              foreach ( (array) $post_ids as $post_id ) {
 138                  if ( ! current_user_can( 'delete_post', $post_id ) ) {
 139                      wp_die( __( 'Sorry, you are not allowed to restore this item from the Trash.' ) );
 140                  }
 141  
 142                  if ( ! wp_untrash_post( $post_id ) ) {
 143                      wp_die( __( 'Error in restoring from Trash.' ) );
 144                  }
 145  
 146                  $untrashed++;
 147              }
 148              $sendback = add_query_arg( 'untrashed', $untrashed, $sendback );
 149              break;
 150          case 'delete':
 151              $deleted = 0;
 152              foreach ( (array) $post_ids as $post_id ) {
 153                  $post_del = get_post( $post_id );
 154  
 155                  if ( ! current_user_can( 'delete_post', $post_id ) ) {
 156                      wp_die( __( 'Sorry, you are not allowed to delete this item.' ) );
 157                  }
 158  
 159                  if ( 'attachment' === $post_del->post_type ) {
 160                      if ( ! wp_delete_attachment( $post_id ) ) {
 161                          wp_die( __( 'Error in deleting.' ) );
 162                      }
 163                  } else {
 164                      if ( ! wp_delete_post( $post_id ) ) {
 165                          wp_die( __( 'Error in deleting.' ) );
 166                      }
 167                  }
 168                  $deleted++;
 169              }
 170              $sendback = add_query_arg( 'deleted', $deleted, $sendback );
 171              break;
 172          case 'edit':
 173              if ( isset( $_REQUEST['bulk_edit'] ) ) {
 174                  $done = bulk_edit_posts( $_REQUEST );
 175  
 176                  if ( is_array( $done ) ) {
 177                      $done['updated'] = count( $done['updated'] );
 178                      $done['skipped'] = count( $done['skipped'] );
 179                      $done['locked']  = count( $done['locked'] );
 180                      $sendback        = add_query_arg( $done, $sendback );
 181                  }
 182              }
 183              break;
 184          default:
 185              $screen = get_current_screen()->id;
 186  
 187              /**
 188               * Fires when a custom bulk action should be handled.
 189               *
 190               * The redirect link should be modified with success or failure feedback
 191               * from the action to be used to display feedback to the user.
 192               *
 193               * The dynamic portion of the hook name, `$screen`, refers to the current screen ID.
 194               *
 195               * @since 4.7.0
 196               *
 197               * @param string $sendback The redirect URL.
 198               * @param string $doaction The action being taken.
 199               * @param array  $items    The items to take the action on. Accepts an array of IDs of posts,
 200               *                         comments, terms, links, plugins, attachments, or users.
 201               */
 202              $sendback = apply_filters( "handle_bulk_actions-{$screen}", $sendback, $doaction, $post_ids ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores
 203              break;
 204      }
 205  
 206      $sendback = remove_query_arg( array( 'action', 'action2', 'tags_input', 'post_author', 'comment_status', 'ping_status', '_status', 'post', 'bulk_edit', 'post_view' ), $sendback );
 207  
 208      wp_redirect( $sendback );
 209      exit();
 210  } elseif ( ! empty( $_REQUEST['_wp_http_referer'] ) ) {
 211      wp_redirect( remove_query_arg( array( '_wp_http_referer', '_wpnonce' ), wp_unslash( $_SERVER['REQUEST_URI'] ) ) );
 212      exit;
 213  }
 214  
 215  $wp_list_table->prepare_items();
 216  
 217  wp_enqueue_script( 'inline-edit-post' );
 218  wp_enqueue_script( 'heartbeat' );
 219  
 220  if ( 'wp_block' === $post_type ) {
 221      wp_enqueue_script( 'wp-list-reusable-blocks' );
 222      wp_enqueue_style( 'wp-list-reusable-blocks' );
 223  }
 224  
 225  $title = $post_type_object->labels->name;
 226  
 227  if ( 'post' === $post_type ) {
 228      get_current_screen()->add_help_tab(
 229          array(
 230              'id'      => 'overview',
 231              'title'   => __( 'Overview' ),
 232              'content' =>
 233                      '<p>' . __( 'This screen provides access to all of your posts. You can customize the display of this screen to suit your workflow.' ) . '</p>',
 234          )
 235      );
 236      get_current_screen()->add_help_tab(
 237          array(
 238              'id'      => 'screen-content',
 239              'title'   => __( 'Screen Content' ),
 240              'content' =>
 241                      '<p>' . __( 'You can customize the display of this screen&#8217;s contents in a number of ways:' ) . '</p>' .
 242                      '<ul>' .
 243                          '<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>' .
 244                          '<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>' .
 245                          '<li>' . __( 'You can view posts in a simple title list or with an excerpt using the Screen Options tab.' ) . '</li>' .
 246                          '<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>' .
 247                      '</ul>',
 248          )
 249      );
 250      get_current_screen()->add_help_tab(
 251          array(
 252              'id'      => 'action-links',
 253              'title'   => __( 'Available Actions' ),
 254              'content' =>
 255                      '<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>' .
 256                      '<ul>' .
 257                          '<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>' .
 258                          '<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>' .
 259                          '<li>' . __( '<strong>Trash</strong> removes your post from this list and places it in the trash, from which you can permanently delete it.' ) . '</li>' .
 260                          '<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>' .
 261                      '</ul>',
 262          )
 263      );
 264      get_current_screen()->add_help_tab(
 265          array(
 266              'id'      => 'bulk-actions',
 267              'title'   => __( 'Bulk Actions' ),
 268              'content' =>
 269                      '<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>' .
 270                              '<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>',
 271          )
 272      );
 273  
 274      get_current_screen()->set_help_sidebar(
 275          '<p><strong>' . __( 'For more information:' ) . '</strong></p>' .
 276          '<p>' . __( '<a href="https://wordpress.org/support/article/posts-screen/">Documentation on Managing Posts</a>' ) . '</p>' .
 277          '<p>' . __( '<a href="https://wordpress.org/support/">Support</a>' ) . '</p>'
 278      );
 279  
 280  } elseif ( 'page' === $post_type ) {
 281      get_current_screen()->add_help_tab(
 282          array(
 283              'id'      => 'overview',
 284              'title'   => __( 'Overview' ),
 285              'content' =>
 286                      '<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>',
 287          )
 288      );
 289      get_current_screen()->add_help_tab(
 290          array(
 291              'id'      => 'managing-pages',
 292              'title'   => __( 'Managing Pages' ),
 293              'content' =>
 294                      '<p>' . __( 'Managing pages is very similar to managing posts, and the screens can be customized in the same way.' ) . '</p>' .
 295                      '<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>',
 296          )
 297      );
 298  
 299      get_current_screen()->set_help_sidebar(
 300          '<p><strong>' . __( 'For more information:' ) . '</strong></p>' .
 301          '<p>' . __( '<a href="https://wordpress.org/support/article/pages-screen/">Documentation on Managing Pages</a>' ) . '</p>' .
 302          '<p>' . __( '<a href="https://wordpress.org/support/">Support</a>' ) . '</p>'
 303      );
 304  
 305  }
 306  
 307  get_current_screen()->set_screen_reader_content(
 308      array(
 309          'heading_views'      => $post_type_object->labels->filter_items_list,
 310          'heading_pagination' => $post_type_object->labels->items_list_navigation,
 311          'heading_list'       => $post_type_object->labels->items_list,
 312      )
 313  );
 314  
 315  add_screen_option(
 316      'per_page',
 317      array(
 318          'default' => 20,
 319          'option'  => 'edit_' . $post_type . '_per_page',
 320      )
 321  );
 322  
 323  $bulk_counts = array(
 324      'updated'   => isset( $_REQUEST['updated'] ) ? absint( $_REQUEST['updated'] ) : 0,
 325      'locked'    => isset( $_REQUEST['locked'] ) ? absint( $_REQUEST['locked'] ) : 0,
 326      'deleted'   => isset( $_REQUEST['deleted'] ) ? absint( $_REQUEST['deleted'] ) : 0,
 327      'trashed'   => isset( $_REQUEST['trashed'] ) ? absint( $_REQUEST['trashed'] ) : 0,
 328      'untrashed' => isset( $_REQUEST['untrashed'] ) ? absint( $_REQUEST['untrashed'] ) : 0,
 329  );
 330  
 331  $bulk_messages             = array();
 332  $bulk_messages['post']     = array(
 333      /* translators: %s: Number of posts. */
 334      'updated'   => _n( '%s post updated.', '%s posts updated.', $bulk_counts['updated'] ),
 335      'locked'    => ( 1 == $bulk_counts['locked'] ) ? __( '1 post not updated, somebody is editing it.' ) :
 336                      /* translators: %s: Number of posts. */
 337                      _n( '%s post not updated, somebody is editing it.', '%s posts not updated, somebody is editing them.', $bulk_counts['locked'] ),
 338      /* translators: %s: Number of posts. */
 339      'deleted'   => _n( '%s post permanently deleted.', '%s posts permanently deleted.', $bulk_counts['deleted'] ),
 340      /* translators: %s: Number of posts. */
 341      'trashed'   => _n( '%s post moved to the Trash.', '%s posts moved to the Trash.', $bulk_counts['trashed'] ),
 342      /* translators: %s: Number of posts. */
 343      'untrashed' => _n( '%s post restored from the Trash.', '%s posts restored from the Trash.', $bulk_counts['untrashed'] ),
 344  );
 345  $bulk_messages['page']     = array(
 346      /* translators: %s: Number of pages. */
 347      'updated'   => _n( '%s page updated.', '%s pages updated.', $bulk_counts['updated'] ),
 348      'locked'    => ( 1 == $bulk_counts['locked'] ) ? __( '1 page not updated, somebody is editing it.' ) :
 349                      /* translators: %s: Number of pages. */
 350                      _n( '%s page not updated, somebody is editing it.', '%s pages not updated, somebody is editing them.', $bulk_counts['locked'] ),
 351      /* translators: %s: Number of pages. */
 352      'deleted'   => _n( '%s page permanently deleted.', '%s pages permanently deleted.', $bulk_counts['deleted'] ),
 353      /* translators: %s: Number of pages. */
 354      'trashed'   => _n( '%s page moved to the Trash.', '%s pages moved to the Trash.', $bulk_counts['trashed'] ),
 355      /* translators: %s: Number of pages. */
 356      'untrashed' => _n( '%s page restored from the Trash.', '%s pages restored from the Trash.', $bulk_counts['untrashed'] ),
 357  );
 358  $bulk_messages['wp_block'] = array(
 359      /* translators: %s: Number of blocks. */
 360      'updated'   => _n( '%s block updated.', '%s blocks updated.', $bulk_counts['updated'] ),
 361      'locked'    => ( 1 == $bulk_counts['locked'] ) ? __( '1 block not updated, somebody is editing it.' ) :
 362                      /* translators: %s: Number of blocks. */
 363                      _n( '%s block not updated, somebody is editing it.', '%s blocks not updated, somebody is editing them.', $bulk_counts['locked'] ),
 364      /* translators: %s: Number of blocks. */
 365      'deleted'   => _n( '%s block permanently deleted.', '%s blocks permanently deleted.', $bulk_counts['deleted'] ),
 366      /* translators: %s: Number of blocks. */
 367      'trashed'   => _n( '%s block moved to the Trash.', '%s blocks moved to the Trash.', $bulk_counts['trashed'] ),
 368      /* translators: %s: Number of blocks. */
 369      'untrashed' => _n( '%s block restored from the Trash.', '%s blocks restored from the Trash.', $bulk_counts['untrashed'] ),
 370  );
 371  
 372  /**
 373   * Filters the bulk action updated messages.
 374   *
 375   * By default, custom post types use the messages for the 'post' post type.
 376   *
 377   * @since 3.7.0
 378   *
 379   * @param array[] $bulk_messages Arrays of messages, each keyed by the corresponding post type. Messages are
 380   *                               keyed with 'updated', 'locked', 'deleted', 'trashed', and 'untrashed'.
 381   * @param int[]   $bulk_counts   Array of item counts for each message, used to build internationalized strings.
 382   */
 383  $bulk_messages = apply_filters( 'bulk_post_updated_messages', $bulk_messages, $bulk_counts );
 384  $bulk_counts   = array_filter( $bulk_counts );
 385  
 386  require_once( ABSPATH . 'wp-admin/admin-header.php' );
 387  ?>
 388  <div class="wrap">
 389  <h1 class="wp-heading-inline">
 390  <?php
 391  echo esc_html( $post_type_object->labels->name );
 392  ?>
 393  </h1>
 394  
 395  <?php
 396  if ( current_user_can( $post_type_object->cap->create_posts ) ) {
 397      echo ' <a href="' . esc_url( admin_url( $post_new_file ) ) . '" class="page-title-action">' . esc_html( $post_type_object->labels->add_new ) . '</a>';
 398  }
 399  
 400  if ( isset( $_REQUEST['s'] ) && strlen( $_REQUEST['s'] ) ) {
 401      /* translators: %s: Search query. */
 402      printf( ' <span class="subtitle">' . __( 'Search results for &#8220;%s&#8221;' ) . '</span>', get_search_query() );
 403  }
 404  ?>
 405  
 406  <hr class="wp-header-end">
 407  
 408  <?php
 409  // If we have a bulk message to issue:
 410  $messages = array();
 411  foreach ( $bulk_counts as $message => $count ) {
 412      if ( isset( $bulk_messages[ $post_type ][ $message ] ) ) {
 413          $messages[] = sprintf( $bulk_messages[ $post_type ][ $message ], number_format_i18n( $count ) );
 414      } elseif ( isset( $bulk_messages['post'][ $message ] ) ) {
 415          $messages[] = sprintf( $bulk_messages['post'][ $message ], number_format_i18n( $count ) );
 416      }
 417  
 418      if ( 'trashed' === $message && isset( $_REQUEST['ids'] ) ) {
 419          $ids        = preg_replace( '/[^0-9,]/', '', $_REQUEST['ids'] );
 420          $messages[] = '<a href="' . esc_url( wp_nonce_url( "edit.php?post_type=$post_type&doaction=undo&action=untrash&ids=$ids", 'bulk-posts' ) ) . '">' . __( 'Undo' ) . '</a>';
 421      }
 422  }
 423  
 424  if ( $messages ) {
 425      echo '<div id="message" class="updated notice is-dismissible"><p>' . join( ' ', $messages ) . '</p></div>';
 426  }
 427  unset( $messages );
 428  
 429  $_SERVER['REQUEST_URI'] = remove_query_arg( array( 'locked', 'skipped', 'updated', 'deleted', 'trashed', 'untrashed' ), $_SERVER['REQUEST_URI'] );
 430  ?>
 431  
 432  <?php $wp_list_table->views(); ?>
 433  
 434  <form id="posts-filter" method="get">
 435  
 436  <?php $wp_list_table->search_box( $post_type_object->labels->search_items, 'post' ); ?>
 437  
 438  <input type="hidden" name="post_status" class="post_status_page" value="<?php echo ! empty( $_REQUEST['post_status'] ) ? esc_attr( $_REQUEST['post_status'] ) : 'all'; ?>" />
 439  <input type="hidden" name="post_type" class="post_type_page" value="<?php echo $post_type; ?>" />
 440  
 441  <?php if ( ! empty( $_REQUEST['author'] ) ) { ?>
 442  <input type="hidden" name="author" value="<?php echo esc_attr( $_REQUEST['author'] ); ?>" />
 443  <?php } ?>
 444  
 445  <?php if ( ! empty( $_REQUEST['show_sticky'] ) ) { ?>
 446  <input type="hidden" name="show_sticky" value="1" />
 447  <?php } ?>
 448  
 449  <?php $wp_list_table->display(); ?>
 450  
 451  </form>
 452  
 453  <?php
 454  if ( $wp_list_table->has_items() ) {
 455      $wp_list_table->inline_edit();
 456  }
 457  ?>
 458  
 459  <div id="ajax-response"></div>
 460  <br class="clear" />
 461  </div>
 462  
 463  <?php
 464  include( ABSPATH . 'wp-admin/admin-footer.php' );


Generated: Tue Jan 21 01:00:03 2020 Cross-referenced by PHPXref 0.7.1