get_sample_permalink() WP 2.5.0

Отримує зразок постійного заслання (пермалинка) запису.

Для роботи функції у фронт-енді потрібно підключити файл:

require_once ABSPATH. '/wp-admin/includes/post.php';

Хуки з функції
Array( [0] => https://wp-doc.com/%postname%.html [1] => customize-api )

Використання

get_sample_permalink( $id, $title, $name );
$id
(число/WP_Post) (обов’язковий)
ID або об’єкт запису (поста), зразок пермалінки якого потрібно отримати.
$title
(рядок)

Заголовок запису, який потрібно використовувати для створення ярлика посилання ( post_name ).

Для цього параметра в $name потрібно вказати порожній рядок. Якщо цього не зробити, цей параметр ніде не буде використовуватися, а просто буде переданий в хук get_sample_permalink .

Типово: null

$name
(рядок)
Ярлик запису, який перезапише поточний ярлик (
post_name ). Впливає на роботу параметра
$title . Якщо вказаний рядок не порожній, перебиває параметр
$title (див. приклади).


Типово: null

Приклади

0

#1 Демонстрація роботи

require_once ABSPATH. '/wp-admin/includes/post.php';

$sample_permalink = get_sample_permalink(10262);
/*
Array (
	[0] => https://wp-doc.com/%postname%.html
	[1] => customize-api
)
*/
0

#2 Використання всіх параметрів

$sample_permalink = get_sample_permalink( 10262, 'Мій заголовок');
/*
	[0] => https://wp-doc.com/%postname%.html
	[1] => customize-api
*/

$sample_permalink = get_sample_permalink( 10262, 'Мій заголовок', '');
/*
	[0] => https://wp-doc.com/%postname%.html
	[1] => moj-zagolovok
*/

$sample_permalink = get_sample_permalink( 10262, 'Мій заголовок', 'Якщо вказати ім'я');
/*
	[0] => https://wp-doc.com/%postname%.html
	[1] => esli-ukazat-imya
*/

список змін

З версії 2.5.0Введено.

Код get_sample_permalink() WP 6.0.2

function get_sample_permalink( $id, $title = null, $name = null ) {
	$post = get_post($id);
	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;

	// Hack: get_permalink() would return plain permalink for drafts, так що буде оминати те, що наше повідомлення є публіковано.
	if ( in_array( $post->post_status, array( 'draft', 'pending', 'future' ), true ) ) {
		$post->post_status = 'publish';
		$post->post_name = sanitize_title( $post->post_name ? $post->post_name : $post->post_title, $post->ID );
	}

	// Якщо 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 );
		}

		/** Цей файл використовується в wp-admin/edit-tag-form.php */
		$uri = apply_filters( 'editable_slug', $uri, $post);
		if ( ! empty( $uri ) ) {
			$uri. = '/';
		}
		$permalink = str_replace( '%pagename%', "{$uri}%pagename%", $permalink );
	}

	/** Цей файл використовується в 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;
	unset($post->filter);

	/**
	 * Filters the sample permalink.
	 *
	 * @ Since 4.4.0
	 *
	 * @param array $permalink {
	 * Array містить в собі прикладний шаблон з місцезнаходженням для повідомлення електронної пошти, і повідомлення електронної пошти.
	 *
	 * @type string $0 The permalink with placeholder for 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 об'єкт.
	 */
	return apply_filters( 'get_sample_permalink', $permalink, $post->ID, $title, $name, $post);
}

Залишити відповідь

Ваша e-mail адреса не оприлюднюватиметься. Обов’язкові поля позначені *