# get_sample_permalink()

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

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

## Сигнатура

```php
get_sample_permalink( int|WP_Post $post, string|null $title = null, string|null $name = null ): array
```

## Описание

Возвращает образец постоянной ссылки на основе имени записи.

## Параметры

- `$post` `int|WP_Post` — обязательный. Идентификатор записи или объект записи.
- `$title` `string|null` — необязательный, по умолчанию `null`. Заголовок, который переопределяет текущий заголовок записи при формировании имени записи.
- `$name` `string|null` — необязательный, по умолчанию `null`. Имя, которое переопределяет имя записи.

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

`array` — 0 stringПостоянная ссылка с заполнителем для имени записи. 1 stringИмя записи.

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

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

```php
function get_sample_permalink( $post, $title = null, $name = null ) {
	$post = get_post( $post );

	if ( ! $post ) {
		return array( '', '' );
	}

	$ptype = get_post_type_object( $post->post_type );

	$original_status = $post->post_status;
	$original_date   = $post->post_date;
	$original_name   = $post->post_name;
	$original_filter = $post->filter;

	// Hack: get_permalink() would return plain permalink for drafts, so we will fake that our post is published.
	if ( in_array( $post->post_status, array( 'auto-draft', 'draft', 'pending', 'future' ), true ) ) {
		$post->post_status = 'publish';
		$post->post_name   = sanitize_title( $post->post_name ? $post->post_name : $post->post_title, $post->ID );
	}

	/*
	 * If the user wants to set a new name -- override the current one.
	 * Note: if empty name is supplied -- use the title instead, see #6072.
	 */
	if ( ! is_null( $name ) ) {
		$post->post_name = sanitize_title( $name ? $name : $title, $post->ID );
	}

	$post->post_name = wp_unique_post_slug( $post->post_name, $post->ID, $post->post_status, $post->post_type, $post->post_parent );

	$post->filter = 'sample';

	$permalink = get_permalink( $post, true );

	// Replace custom post_type token with generic pagename token for ease of use.
	$permalink = str_replace( "%$post->post_type%", '%pagename%', $permalink );

	// Handle page hierarchy.
	if ( $ptype->hierarchical ) {
		$uri = get_page_uri( $post );
		if ( $uri ) {
			$uri = untrailingslashit( $uri );
			$uri = strrev( stristr( strrev( $uri ), '/' ) );
			$uri = untrailingslashit( $uri );
		}

		/** This filter is documented in wp-admin/edit-tag-form.php */
		$uri = apply_filters( 'editable_slug', $uri, $post );
		if ( ! empty( $uri ) ) {
			$uri .= '/';
		}
		$permalink = str_replace( '%pagename%', "{$uri}%pagename%", $permalink );
	}

	/** This filter is documented in wp-admin/edit-tag-form.php */
	$permalink         = array( $permalink, apply_filters( 'editable_slug', $post->post_name, $post ) );
	$post->post_status = $original_status;
	$post->post_date   = $original_date;
	$post->post_name   = $original_name;
	$post->filter      = $original_filter;

	/**
	 * Filters the sample permalink.
	 *
	 * @since 4.4.0
	 *
	 * @param array   $permalink {
	 *     Array containing the sample permalink with placeholder for the post name, and the post name.
	 *
	 *     @type string $0 The permalink with placeholder for the post name.
	 *     @type string $1 The post name.
	 * }
	 * @param int     $post_id Post ID.
	 * @param string  $title   Post title.
	 * @param string  $name    Post name (slug).
	 * @param WP_Post $post    Post object.
	 */
	return apply_filters( 'get_sample_permalink', $permalink, $post->ID, $title, $name, $post );
}
```

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

- 2.5.0 — Introduced.

## Связанные

Использует: [`untrailingslashit`](https://chugunov.pro/api-wordpress/functions/untrailingslashit/), [`sanitize_title`](https://chugunov.pro/api-wordpress/functions/sanitize_title/), [`get_page_uri`](https://chugunov.pro/api-wordpress/functions/get_page_uri/), [`wp_unique_post_slug`](https://chugunov.pro/api-wordpress/functions/wp_unique_post_slug/), [`get_permalink`](https://chugunov.pro/api-wordpress/functions/get_permalink/), [`apply_filters`](https://chugunov.pro/api-wordpress/functions/apply_filters/), [`get_post`](https://chugunov.pro/api-wordpress/functions/get_post/), [`get_post_type_object`](https://chugunov.pro/api-wordpress/functions/get_post_type_object/).
Используется в: `WP_REST_Posts_Controller::prepare_item_for_response`, [`get_sample_permalink_html`](https://chugunov.pro/api-wordpress/functions/get_sample_permalink_html/).

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