wp_add_trashed_suffix_to_post_name_for_post
Adds a trashed suffix for a given post.
Description
(string) wp_add_trashed_suffix_to_post_name_for_post( (WP_Post) $post );
Store its desired (i.e. current) slug so it can try to reclaim it if the post is untrashed.
For internal use.
Returns (string)
New slug for the post.
Parameters (1)
- 0. $post (WP_Post)
- The post.
Usage
if ( !function_exists( 'wp_add_trashed_suffix_to_post_name_for_post' ) ) { require_once ABSPATH . WPINC . '/post.php'; } // The post. $post = null; // NOTICE! Understand what this does before running. $result = wp_add_trashed_suffix_to_post_name_for_post($post);
Defined (1)
The function is defined in the following location(s).
- /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;
- }