3 * Edit Posts Administration Screen.
6 * @subpackage Administration
9 /** WordPress Administration Bootstrap */
10 require_once( dirname( __FILE__ ) . '/admin.php' );
13 wp_die( __( 'Invalid post type' ) );
15 if ( 'attachment' === $typenow ) {
16 if ( wp_redirect( admin_url( 'upload.php' ) ) ) {
22 * @global string $post_type
23 * @global object $post_type_object
25 global $post_type, $post_type_object;
27 $post_type = $typenow;
28 $post_type_object = get_post_type_object( $post_type );
30 if ( ! $post_type_object )
31 wp_die( __( 'Invalid post type' ) );
33 if ( ! current_user_can( $post_type_object->cap->edit_posts ) )
34 wp_die( __( 'Cheatin’ uh?' ), 403 );
36 $wp_list_table = _get_list_table('WP_Posts_List_Table');
37 $pagenum = $wp_list_table->get_pagenum();
39 // Back-compat for viewing comments of an entry
40 foreach ( array( 'p', 'attachment_id', 'page_id' ) as $_redirect ) {
41 if ( ! empty( $_REQUEST[ $_redirect ] ) ) {
42 wp_redirect( admin_url( 'edit-comments.php?p=' . absint( $_REQUEST[ $_redirect ] ) ) );
48 if ( 'post' != $post_type ) {
49 $parent_file = "edit.php?post_type=$post_type";
50 $submenu_file = "edit.php?post_type=$post_type";
51 $post_new_file = "post-new.php?post_type=$post_type";
53 $parent_file = 'edit.php';
54 $submenu_file = 'edit.php';
55 $post_new_file = 'post-new.php';
58 $doaction = $wp_list_table->current_action();
61 check_admin_referer('bulk-posts');
63 $sendback = remove_query_arg( array('trashed', 'untrashed', 'deleted', 'locked', 'ids'), wp_get_referer() );
65 $sendback = admin_url( $parent_file );
66 $sendback = add_query_arg( 'paged', $pagenum, $sendback );
67 if ( strpos($sendback, 'post.php') !== false )
68 $sendback = admin_url($post_new_file);
70 if ( 'delete_all' == $doaction ) {
71 // Prepare for deletion of all posts with a specified post status (i.e. Empty trash).
72 $post_status = preg_replace('/[^a-z0-9_-]+/i', '', $_REQUEST['post_status']);
73 // Validate the post status exists.
74 if ( get_post_status_object( $post_status ) ) {
75 $post_ids = $wpdb->get_col( $wpdb->prepare( "SELECT ID FROM $wpdb->posts WHERE post_type=%s AND post_status = %s", $post_type, $post_status ) );
78 } elseif ( isset( $_REQUEST['media'] ) ) {
79 $post_ids = $_REQUEST['media'];
80 } elseif ( isset( $_REQUEST['ids'] ) ) {
81 $post_ids = explode( ',', $_REQUEST['ids'] );
82 } elseif ( !empty( $_REQUEST['post'] ) ) {
83 $post_ids = array_map('intval', $_REQUEST['post']);
86 if ( !isset( $post_ids ) ) {
87 wp_redirect( $sendback );
91 switch ( $doaction ) {
93 $trashed = $locked = 0;
95 foreach( (array) $post_ids as $post_id ) {
96 if ( !current_user_can( 'delete_post', $post_id) )
97 wp_die( __('You are not allowed to move this item to the Trash.') );
99 if ( wp_check_post_lock( $post_id ) ) {
104 if ( !wp_trash_post($post_id) )
105 wp_die( __('Error in moving to Trash.') );
110 $sendback = add_query_arg( array('trashed' => $trashed, 'ids' => join(',', $post_ids), 'locked' => $locked ), $sendback );
114 foreach( (array) $post_ids as $post_id ) {
115 if ( !current_user_can( 'delete_post', $post_id) )
116 wp_die( __('You are not allowed to restore this item from the Trash.') );
118 if ( !wp_untrash_post($post_id) )
119 wp_die( __('Error in restoring from Trash.') );
123 $sendback = add_query_arg('untrashed', $untrashed, $sendback);
127 foreach( (array) $post_ids as $post_id ) {
128 $post_del = get_post($post_id);
130 if ( !current_user_can( 'delete_post', $post_id ) )
131 wp_die( __('You are not allowed to delete this item.') );
133 if ( $post_del->post_type == 'attachment' ) {
134 if ( ! wp_delete_attachment($post_id) )
135 wp_die( __('Error in deleting.') );
137 if ( !wp_delete_post($post_id) )
138 wp_die( __('Error in deleting.') );
142 $sendback = add_query_arg('deleted', $deleted, $sendback);
145 if ( isset($_REQUEST['bulk_edit']) ) {
146 $done = bulk_edit_posts($_REQUEST);
148 if ( is_array($done) ) {
149 $done['updated'] = count( $done['updated'] );
150 $done['skipped'] = count( $done['skipped'] );
151 $done['locked'] = count( $done['locked'] );
152 $sendback = add_query_arg( $done, $sendback );
158 $sendback = remove_query_arg( array('action', 'action2', 'tags_input', 'post_author', 'comment_status', 'ping_status', '_status', 'post', 'bulk_edit', 'post_view'), $sendback );
160 wp_redirect($sendback);
162 } elseif ( ! empty($_REQUEST['_wp_http_referer']) ) {
163 wp_redirect( remove_query_arg( array('_wp_http_referer', '_wpnonce'), wp_unslash($_SERVER['REQUEST_URI']) ) );
167 $wp_list_table->prepare_items();
169 wp_enqueue_script('inline-edit-post');
170 wp_enqueue_script('heartbeat');
172 $title = $post_type_object->labels->name;
174 if ( 'post' == $post_type ) {
175 get_current_screen()->add_help_tab( array(
177 'title' => __('Overview'),
179 '<p>' . __('This screen provides access to all of your posts. You can customize the display of this screen to suit your workflow.') . '</p>'
181 get_current_screen()->add_help_tab( array(
182 'id' => 'screen-content',
183 'title' => __('Screen Content'),
185 '<p>' . __('You can customize the display of this screen’s contents in a number of ways:') . '</p>' .
187 '<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>' .
188 '<li>' . __('You can filter the list of posts by post status using the text links in the upper left to show All, Published, Draft, or Trashed posts. The default view is to show all posts.') . '</li>' .
189 '<li>' . __('You can view posts in a simple title list or with an excerpt. Choose the view you prefer by clicking on the icons at the top of the list on the right.') . '</li>' .
190 '<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>' .
193 get_current_screen()->add_help_tab( array(
194 'id' => 'action-links',
195 'title' => __('Available Actions'),
197 '<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>' .
199 '<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>' .
200 '<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>' .
201 '<li>' . __('<strong>Trash</strong> removes your post from this list and places it in the trash, from which you can permanently delete it.') . '</li>' .
202 '<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’s status.') . '</li>' .
205 get_current_screen()->add_help_tab( array(
206 'id' => 'bulk-actions',
207 'title' => __('Bulk Actions'),
209 '<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>' .
210 '<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>'
213 get_current_screen()->set_help_sidebar(
214 '<p><strong>' . __('For more information:') . '</strong></p>' .
215 '<p>' . __('<a href="https://codex.wordpress.org/Posts_Screen" target="_blank">Documentation on Managing Posts</a>') . '</p>' .
216 '<p>' . __('<a href="https://wordpress.org/support/" target="_blank">Support Forums</a>') . '</p>'
219 } elseif ( 'page' == $post_type ) {
220 get_current_screen()->add_help_tab( array(
222 'title' => __('Overview'),
224 '<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 “Parent” of the other, creating a group of pages.') . '</p>'
226 get_current_screen()->add_help_tab( array(
227 'id' => 'managing-pages',
228 'title' => __('Managing Pages'),
230 '<p>' . __('Managing pages is very similar to managing posts, and the screens can be customized in the same way.') . '</p>' .
231 '<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>'
234 get_current_screen()->set_help_sidebar(
235 '<p><strong>' . __('For more information:') . '</strong></p>' .
236 '<p>' . __('<a href="https://codex.wordpress.org/Pages_Screen" target="_blank">Documentation on Managing Pages</a>') . '</p>' .
237 '<p>' . __('<a href="https://wordpress.org/support/" target="_blank">Support Forums</a>') . '</p>'
241 add_screen_option( 'per_page', array( 'default' => 20, 'option' => 'edit_' . $post_type . '_per_page' ) );
243 $bulk_counts = array(
244 'updated' => isset( $_REQUEST['updated'] ) ? absint( $_REQUEST['updated'] ) : 0,
245 'locked' => isset( $_REQUEST['locked'] ) ? absint( $_REQUEST['locked'] ) : 0,
246 'deleted' => isset( $_REQUEST['deleted'] ) ? absint( $_REQUEST['deleted'] ) : 0,
247 'trashed' => isset( $_REQUEST['trashed'] ) ? absint( $_REQUEST['trashed'] ) : 0,
248 'untrashed' => isset( $_REQUEST['untrashed'] ) ? absint( $_REQUEST['untrashed'] ) : 0,
251 $bulk_messages = array();
252 $bulk_messages['post'] = array(
253 'updated' => _n( '%s post updated.', '%s posts updated.', $bulk_counts['updated'] ),
254 'locked' => ( 1 == $bulk_counts['locked'] ) ? __( '1 post not updated, somebody is editing it.' ) :
255 _n( '%s post not updated, somebody is editing it.', '%s posts not updated, somebody is editing them.', $bulk_counts['locked'] ),
256 'deleted' => _n( '%s post permanently deleted.', '%s posts permanently deleted.', $bulk_counts['deleted'] ),
257 'trashed' => _n( '%s post moved to the Trash.', '%s posts moved to the Trash.', $bulk_counts['trashed'] ),
258 'untrashed' => _n( '%s post restored from the Trash.', '%s posts restored from the Trash.', $bulk_counts['untrashed'] ),
260 $bulk_messages['page'] = array(
261 'updated' => _n( '%s page updated.', '%s pages updated.', $bulk_counts['updated'] ),
262 'locked' => ( 1 == $bulk_counts['locked'] ) ? __( '1 page not updated, somebody is editing it.' ) :
263 _n( '%s page not updated, somebody is editing it.', '%s pages not updated, somebody is editing them.', $bulk_counts['locked'] ),
264 'deleted' => _n( '%s page permanently deleted.', '%s pages permanently deleted.', $bulk_counts['deleted'] ),
265 'trashed' => _n( '%s page moved to the Trash.', '%s pages moved to the Trash.', $bulk_counts['trashed'] ),
266 'untrashed' => _n( '%s page restored from the Trash.', '%s pages restored from the Trash.', $bulk_counts['untrashed'] ),
270 * Filter the bulk action updated messages.
272 * By default, custom post types use the messages for the 'post' post type.
276 * @param array $bulk_messages Arrays of messages, each keyed by the corresponding post type. Messages are
277 * keyed with 'updated', 'locked', 'deleted', 'trashed', and 'untrashed'.
278 * @param array $bulk_counts Array of item counts for each message, used to build internationalized strings.
280 $bulk_messages = apply_filters( 'bulk_post_updated_messages', $bulk_messages, $bulk_counts );
281 $bulk_counts = array_filter( $bulk_counts );
283 require_once( ABSPATH . 'wp-admin/admin-header.php' );
287 echo esc_html( $post_type_object->labels->name );
288 if ( current_user_can( $post_type_object->cap->create_posts ) )
289 echo ' <a href="' . esc_url( admin_url( $post_new_file ) ) . '" class="page-title-action">' . esc_html( $post_type_object->labels->add_new ) . '</a>';
290 if ( ! empty( $_REQUEST['s'] ) )
291 printf( ' <span class="subtitle">' . __('Search results for “%s”') . '</span>', get_search_query() );
295 // If we have a bulk message to issue:
297 foreach ( $bulk_counts as $message => $count ) {
298 if ( isset( $bulk_messages[ $post_type ][ $message ] ) )
299 $messages[] = sprintf( $bulk_messages[ $post_type ][ $message ], number_format_i18n( $count ) );
300 elseif ( isset( $bulk_messages['post'][ $message ] ) )
301 $messages[] = sprintf( $bulk_messages['post'][ $message ], number_format_i18n( $count ) );
303 if ( $message == 'trashed' && isset( $_REQUEST['ids'] ) ) {
304 $ids = preg_replace( '/[^0-9,]/', '', $_REQUEST['ids'] );
305 $messages[] = '<a href="' . esc_url( wp_nonce_url( "edit.php?post_type=$post_type&doaction=undo&action=untrash&ids=$ids", "bulk-posts" ) ) . '">' . __('Undo') . '</a>';
310 echo '<div id="message" class="updated notice is-dismissible"><p>' . join( ' ', $messages ) . '</p></div>';
313 $_SERVER['REQUEST_URI'] = remove_query_arg( array( 'locked', 'skipped', 'updated', 'deleted', 'trashed', 'untrashed' ), $_SERVER['REQUEST_URI'] );
316 <?php $wp_list_table->views(); ?>
318 <form id="posts-filter" method="get">
320 <?php $wp_list_table->search_box( $post_type_object->labels->search_items, 'post' ); ?>
322 <input type="hidden" name="post_status" class="post_status_page" value="<?php echo !empty($_REQUEST['post_status']) ? esc_attr($_REQUEST['post_status']) : 'all'; ?>" />
323 <input type="hidden" name="post_type" class="post_type_page" value="<?php echo $post_type; ?>" />
324 <?php if ( ! empty( $_REQUEST['show_sticky'] ) ) { ?>
325 <input type="hidden" name="show_sticky" value="1" />
328 <?php $wp_list_table->display(); ?>
333 if ( $wp_list_table->has_items() )
334 $wp_list_table->inline_edit();
337 <div id="ajax-response"></div>
342 include( ABSPATH . 'wp-admin/admin-footer.php' );