the_shortlink() │ WP 3.0.0

Виводить коротке посилання на поточний запис, наприклад: /?p=1234 .

Цей Тег шаблону виводить текст-посилання, яке веде на поточний пост, але в УРЛі посилання використовується коротке посилання: /?p=1234.

Такі посилання логічно використовувати для сайтів, де використовуються ЧПУ (людино-зрозумілі УРЛи).

Якщо потрібно отримати саме короткий УРЛ, використовуйте функцію: wp_get_shortlink( $post->ID ) .

Навіть якщо у вас на сайті включені ЧПУ такі короткі посилання з інших сайтів на ваш вважаються, пошуковими машинами, такими ж як і звичайні посилання, тому що короткі посилання використовують 301 редирект на реальне посилання.

Працює на основі:
wp_get_shortlink()

1 раз – 0.001029 сек
(дуже повільно) | 50000 разів – 4.65 сек
(швидко) |
PHP 7.1.2, WP 4.7.3

Хуки з функції

the_shortlink

Повертає

null. html тег A – посилання на поточний пост.

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

<?php the_shortlink( $text, $title, $before, $after ); ?>

$text (рядок): Текст посилання.

За замовчуванням: ‘Це коротке посилання.’ (‘This is the short link.’)
$title (рядок): Текст для атрибуту title у тега

Типово: Заголовок запису
$before (рядок): Текст перед посиланням

За замовчуванням: ”
$after (рядок): Текст після посилання.

За замовчуванням: ”

Приклади

#1 Виведемо коротке посилання з текстом “Це коротке посилання”:

<?php the_shortlink(); ?>

Отримаємо:

<a rel="shortlink" href="http://example.com/?p=1234" title="заголовок запису" >Це коротке посилання</a>

#2 Виведемо посилання всередині html тегів

Теги з’являтимуться тільки тоді, коли виводиться коротке посилання:

<?php the_shortlink('Коротке посилання', null, '<div class="shortlink'>", '</div>'); ?>

Отримаємо:

<div class='shortlink'><a rel="shortlink" href="http://example.com/?p=1234" title="заголовок запису" >Коротке посилання</a></div>

список змін

З версії 3.0.0

Введено.

Код `the_shortlink() the shortlink` ^{WP 6.0.2}

wp-includes/link-template.php

function the_shortlink( $text = '', $title = '', $before = '', $after = '' ) {
	$post = get_post();

	if ( empty( $text ) ) {
		$text = __( 'This is the short link.' );
	}

	if (empty($title)) {
		$title = the_title_attribute( array( 'echo' => false ) );
	}

	$shortlink = wp_get_shortlink( $post->ID );

	if ( ! empty( $shortlink ) ) {
		$link = '<a rel="shortlink" href="' . esc_url( $shortlink ) . '" title="' . $title . '">' . $text. '</a>';

		/**
		 * Filters short link anchor tag for a post.
		 *
		 * @ Since 3.0.0
		 *
		 * @param string $link Shortlink anchor tag.
		 * @param string $shortlink Shortlink URL.
		 * @param string $text Shortlink's text.
		 * @param string $title Shortlink's title attribute.
		 */
		$link = apply_filters( 'the_shortlink', $link, $shortlink, $text, $title);
		echo $before, $link, $after;
	}
}

the_shortlink() │ WP 3.0.0

Хуки з функції

Повертає

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

Приклади

#1 Виведемо коротке посилання з текстом “Це коротке посилання”:

#2 Виведемо посилання всередині html тегів

список змін

Код the_shortlink() the shortlink WP 6.0.2

Зв’язані функції

link посилання (HTML тег A)

Записи: пости, сторінки, …

Залишити відповідь Скасувати коментар

Код `the_shortlink() the shortlink` ^{WP 6.0.2}