# get_preview_post_link()

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

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

## Сигнатура

```php
get_preview_post_link( int|WP_Post $post = null, array $query_args = array(), string $preview_link = '' ): string|null
```

## Описание

Позволяет добавлять дополнительные аргументы запроса.

## Параметры

- `$post` `int|WP_Post` — необязательный, по умолчанию `null`. ID записи или объект WP_Post. По умолчанию глобальный $post.
- `$query_args` `array` — необязательный, по умолчанию `array()`. Массив дополнительных аргументов запроса, добавляемых к ссылке.
- `$preview_link` `string` — необязательный, по умолчанию `''`. Базовая ссылка предпросмотра, используемая, если она должна отличаться от постоянной ссылки записи.

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

`string|null`

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

Файл: `wp-includes/link-template.php:1408`

```php
function get_preview_post_link( $post = null, $query_args = array(), $preview_link = '' ) {
	$post = get_post( $post );

	if ( ! $post ) {
		return null;
	}

	$post_type_object = get_post_type_object( $post->post_type );
	if ( is_post_type_viewable( $post_type_object ) ) {
		if ( ! $preview_link ) {
			$preview_link = set_url_scheme( get_permalink( $post ) );
		}

		$query_args['preview'] = 'true';
		$preview_link          = add_query_arg( $query_args, $preview_link );
	}

	/**
	 * Filters the URL used for a post preview.
	 *
	 * @since 2.0.5
	 * @since 4.0.0 Added the `$post` parameter.
	 *
	 * @param string  $preview_link URL used for the post preview.
	 * @param WP_Post $post         Post object.
	 */
	return apply_filters( 'preview_post_link', $preview_link, $post );
}
```

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

- 4.4.0 — Introduced.

## Связанные

Использует: [`is_post_type_viewable`](https://chugunov.pro/api-wordpress/functions/is_post_type_viewable/), [`set_url_scheme`](https://chugunov.pro/api-wordpress/functions/set_url_scheme/), [`add_query_arg`](https://chugunov.pro/api-wordpress/functions/add_query_arg/), [`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_Autosaves_Controller::prepare_item_for_response`, `WP_Posts_List_Table::handle_row_actions`, [`get_sample_permalink_html`](https://chugunov.pro/api-wordpress/functions/get_sample_permalink_html/), [`_admin_notice_post_locked`](https://chugunov.pro/api-wordpress/functions/_admin_notice_post_locked/), [`post_preview`](https://chugunov.pro/api-wordpress/functions/post_preview/), [`wp_ajax_get_permalink`](https://chugunov.pro/api-wordpress/functions/wp_ajax_get_permalink/), [`post_submit_meta_box`](https://chugunov.pro/api-wordpress/functions/post_submit_meta_box/), [`wp_admin_bar_edit_menu`](https://chugunov.pro/api-wordpress/functions/wp_admin_bar_edit_menu/), [`_wp_link_page`](https://chugunov.pro/api-wordpress/functions/_wp_link_page/), [`wp_link_pages`](https://chugunov.pro/api-wordpress/functions/wp_link_pages/).

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