bulk_edit_posts( array|null $post_data = null ): array

Description

Parameters

$post_dataarray|nulloptional

The array of post data to process. Defaults to the $_POST superglobal.Default: null

Return

array

Hooks fired · 1

One hook fires while bulk_edit_posts() runs, in this order:

1. 1
   do_action( bulk_edit_posts )actionline 724 (+226 into the body)

   Fires after processing the post data for bulk edit.

Uses · 25

• get_post_type_object()Retrieves a post type object by name.
• current_user_can()Returns whether the current user has the specified capability.
• wp_die()Kills WordPress execution and displays HTML page with an error message.
• __()Retrieves the translation of $text.
• sanitize_key()Sanitizes a string key.
• is_taxonomy_hierarchical()Determines whether the taxonomy object is hierarchical.
• _x()Retrieves translated string with gettext context.
• get_post_type()Retrieves the post type of the current post or of a given post.
• wp_check_post_lock()Determines whether the post is currently being edited by another user.
• get_post()Retrieves post data given a post ID or post object.
• get_object_taxonomies()Returns the names or objects of the taxonomies which are registered for the requested object or object type, such as a post object or post type name.
• get_taxonomy()Retrieves the taxonomy object of $taxonomy.

Source

View on Trac ↗View on GitHub ↗

498function bulk_edit_posts( $post_data = null ) {499	global $wpdb;500 501	if ( empty( $post_data ) ) {502		$post_data = &$_POST;503	}504 505	if ( isset( $post_data['post_type'] ) ) {506		$ptype = get_post_type_object( $post_data['post_type'] );507	} else {508		$ptype = get_post_type_object( 'post' );509	}510 511	if ( ! current_user_can( $ptype->cap->edit_posts ) ) {512		if ( 'page' === $ptype->name ) {513			wp_die( __( 'Sorry, you are not allowed to edit pages.' ) );514		} else {515			wp_die( __( 'Sorry, you are not allowed to edit posts.' ) );516		}517	}518 519	if ( '-1' === $post_data['_status'] ) {520		$post_data['post_status'] = null;521		unset( $post_data['post_status'] );522	} else {523		$post_data['post_status'] = $post_data['_status'];524	}525	unset( $post_data['_status'] );526 527	if ( ! empty( $post_data['post_status'] ) ) {528		$post_data['post_status'] = sanitize_key( $post_data['post_status'] );529 530		if ( 'inherit' === $post_data['post_status'] ) {531			unset( $post_data['post_status'] );532		}533	}534 535	$post_ids = array_map( 'intval', (array) $post_data['post'] );536 537	$reset = array(538		'post_author',539		'post_status',540		'post_password',541		'post_parent',542		'page_template',543		'comment_status',544		'ping_status',545		'keep_private',546		'tax_input',547		'post_category',548		'sticky',549		'post_format',550	);551 552	foreach ( $reset as $field ) {553		if ( isset( $post_data[ $field ] ) && ( '' === $post_data[ $field ] || '-1' === $post_data[ $field ] ) ) {554			unset( $post_data[ $field ] );555		}556	}557 558	if ( isset( $post_data['post_category'] ) ) {559		if ( is_array( $post_data['post_category'] ) && ! empty( $post_data['post_category'] ) ) {560			$new_cats = array_map( 'absint', $post_data['post_category'] );561		} else {562			unset( $post_data['post_category'] );563		}564	}565 566	$tax_input = array();567	if ( isset( $post_data['tax_input'] ) ) {568		foreach ( $post_data['tax_input'] as $tax_name => $terms ) {569			if ( empty( $terms ) ) {570				continue;571			}572 573			if ( is_taxonomy_hierarchical( $tax_name ) ) {574				$tax_input[ $tax_name ] = array_map( 'absint', $terms );575			} else {576				$comma = _x( ',', 'tag delimiter' );577				if ( ',' !== $comma ) {

History

Introduced in 2.7.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 6.7.7 tag, from src/wp-admin/includes/post.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.