# wp_add_trashed_suffix_to_post_name_for_post()

URL: https://chugunov.pro/api-wordpress/functions/wp_add_trashed_suffix_to_post_name_for_post/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 4.5.0.

## Сигнатура

```php
wp_add_trashed_suffix_to_post_name_for_post( WP_Post $post ): string
```

## Описание

Сохраняет желаемый (то есть текущий) слаг, чтобы запись могла попытаться вернуть его при восстановлении из корзины.
Для внутреннего использования.

## Параметры

- `$post` `WP_Post` — обязательный. Запись.

## Возвращаемое значение

`string`

## Исходный код

Файл: `wp-includes/post.php:8390`

```php
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;
}
```

## История изменений

- 4.5.0 — Introduced.

## Связанные

Использует: [`clean_post_cache`](https://chugunov.pro/api-wordpress/functions/clean_post_cache/), [`_truncate_post_slug`](https://chugunov.pro/api-wordpress/functions/_truncate_post_slug/), [`add_post_meta`](https://chugunov.pro/api-wordpress/functions/add_post_meta/), `wpdb::update`, [`get_post`](https://chugunov.pro/api-wordpress/functions/get_post/).
Используется в: [`wp_add_trashed_suffix_to_post_name_for_trashed_posts`](https://chugunov.pro/api-wordpress/functions/wp_add_trashed_suffix_to_post_name_for_trashed_posts/), [`wp_insert_post`](https://chugunov.pro/api-wordpress/functions/wp_insert_post/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/wp_add_trashed_suffix_to_post_name_for_post/