wp_add_trashed_suffix_to_post_name_for_post( WP_Post $post )

This function’s access is marked private. This means it is not intended for use by plugin or theme developers, only in other core functions. It is listed here for completeness.

Adds a trashed suffix for a given post.

Description

Store its desired (i.e. current) slug so it can try to reclaim it if the post is untrashed.

For internal use.

Parameters

$post

(WP_Post) (Required) The post.

Return

(string) New slug for the post.

Source

File: wp-includes/post.php 

function wp_add_trashed_suffix_to_post_name_for_post( $post ) {
	global $wpdb;

	$post = get_post( $post );

	if ( '__trashed' === substr( $post->post_name, -9 ) ) {
		return $post->post_name;
	}
	add_post_meta( $post->ID, '_wp_desired_post_slug', $post->post_name );
	$post_name = _truncate_post_slug( $post->post_name, 191 ) . '__trashed';
	$wpdb->update( $wpdb->posts, array( 'post_name' => $post_name ), array( 'ID' => $post->ID ) );
	clean_post_cache( $post->ID );
	return $post_name;
}

Uses

Uses Description
wp-includes/post.php: clean_post_cache()

Will clean the post in the cache.
wp-includes/post.php: _truncate_post_slug()

Truncate a post slug.
wp-includes/post.php: add_post_meta()

Adds a meta field to the given post.
wp-includes/post.php: get_post()

Retrieves post data given a post ID or post object.
wp-includes/wp-db.php: wpdb::update()

Updates a row in the table.

Changelog

Version Description
4.5.0 Introduced.

© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/wp_add_trashed_suffix_to_post_name_for_post