WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

wp_add_trashed_suffix_to_post_name_for_post()

wp_add_trashed_suffix_to_post_name_for_post( WP_Post $post ): string

In this article

Back to top

This function’s access is marked private. This means it is not intended for use by plugin or theme developers, only by core. 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

$postWP_Postrequired
The post.

Return

string New slug for the post.

Source

function wp_add_trashed_suffix_to_post_name_for_post( $post ) {
	global $wpdb;

	$post = get_post( $post );

	if ( str_ends_with( $post->post_name, '__trashed' ) ) {
		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;
}

View all references View on Trac View on GitHub

UsesDescription
clean_post_cache()wp-includes/post.php

Will clean the post in the cache.

_truncate_post_slug()wp-includes/post.php

Truncates a post slug.

add_post_meta()wp-includes/post.php

Adds a meta field to the given post.

wpdb::update()wp-includes/class-wpdb.php

Updates a row in the table.

get_post()wp-includes/post.php

Retrieves post data given a post ID or post object.

Show 1 moreShow less
Used byDescription
wp_add_trashed_suffix_to_post_name_for_trashed_posts()wp-includes/post.php

Adds a suffix if any trashed posts have a given slug.

wp_insert_post()wp-includes/post.php

Inserts or update a post.

Changelog

VersionDescription
4.5.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.