Alert: 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.
wp_add_trashed_suffix_to_post_name_for_trashed_posts() WordPress Function
The wp_add_trashed_suffix_to_post_name_for_trashed_posts() function is used to add a suffix to the post name for trashed posts.
wp_add_trashed_suffix_to_post_name_for_trashed_posts( string $post_name, int $post_ID ) #
Adds a suffix if any trashed posts have a given slug.
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_name
(string)(Required)Post slug.
- $post_ID
(int)(Optional) Post ID that should be ignored. Default 0.
Source
File: wp-includes/post.php
function wp_add_trashed_suffix_to_post_name_for_trashed_posts( $post_name, $post_ID = 0 ) { $trashed_posts_with_desired_slug = get_posts( array( 'name' => $post_name, 'post_status' => 'trash', 'post_type' => 'any', 'nopaging' => true, 'post__not_in' => array( $post_ID ), ) ); if ( ! empty( $trashed_posts_with_desired_slug ) ) { foreach ( $trashed_posts_with_desired_slug as $_post ) { wp_add_trashed_suffix_to_post_name_for_post( $_post ); } } }
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
Version | Description |
---|---|
4.5.0 | Introduced. |