функция since 4.4.0

get_preview_post_link()

Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.

Сигнатура

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

Описание

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

Оригинал (английский)

Allows additional query args to be appended.

Параметры

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

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

string|null

Исходный код

wp-includes/link-template.php:1408

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.

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.