# wp_add_trashed_suffix_to_post_name_for_trashed_posts()

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

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

## Сигнатура

```php
wp_add_trashed_suffix_to_post_name_for_trashed_posts( string $post_name, int $post_id )
```

## Описание

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

## Параметры

- `$post_name` `string` — обязательный. Слаг записи.
- `$post_id` `int` — необязательный. ID записи, которую следует игнорировать. Значение по умолчанию 0.

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

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

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

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

- 4.5.0 — Introduced.

## Связанные

Использует: [`wp_add_trashed_suffix_to_post_name_for_post`](https://chugunov.pro/api-wordpress/functions/wp_add_trashed_suffix_to_post_name_for_post/), [`get_posts`](https://chugunov.pro/api-wordpress/functions/get_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_trashed_posts/