OpenAI Апр 19, 2025

Как использоват�� функцию the_shortlink() в WordPress

THE_SHORTLINK() │ WP 3.0.0

Функция the_shortlink() отображает короткую ссылку на пост.

Как использовать

Функцию нужно вызывать внутри цикла WordPress, то есть в "Цикле" (The Loop).

Вызов выглядит так:

Что делает функция

Функция the_shortlink() использует другую функцию — wp_get_shortlink(), которая возвращает короткую URL-ссылку.

Пример времени выполнения:

  • 1 раз: 0.001029 сек (очень медленно)
  • 50000 раз: 4.65 сек (быстро)

Хуки функции

Функция имеет хук the_shortlink, который можно использовать для фильтрации получаемой короткой ссылки.

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

Функция ничего не возвращает (null).

Параметры

Функция the_shortlink( $text, $title, $before, $after ); принимает следующие параметры:

  • $text (string): Необязательный. Текст или HTML для отображения ссылки. По умолчанию: 'Это короткая ссылка.'
  • $title (string): Необязательный. Заголовок для ссылки (tooltip). Должен быть обработан для безопасности. По умолчанию: заголовок поста.
  • $before (string): Необязательный. HTML для отображения перед ссылкой. По умолчанию: ''
  • $after (string): Необязательный. HTML для отображения после ссылки. По умолчанию: ''

Примеры использования

Пример 1: Отображение короткой ссылки с текстом "Это короткая ссылка"

Результат будет выглядеть так:

Это короткая ссылка

Пример 2: Отображение ссылки внутри HTML-тэгов

', '
'); ?>

Результат будет выглядеть так:

короткая ссылка

Изменения

Функция была добавлена в версии 3.0.0.

Код функции

Ниже приведен код функции из файла link-template.php:

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

if ( empty( $text ) ) {
    $text = __( 'Это короткая ссылка.' );
}

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

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

if ( ! empty( $shortlink ) ) {
    $link = '' . $text . '';

    /**
     * Фильтрует тег якоря для короткой ссылки.
     *
     * @since 3.0.0
     *
     * @param string $link      Тег якоря короткой ссылки.
     * @param string $shortlink URL короткой ссылки.
     * @param string $text      Текст короткой ссылки.
     * @param string $title     Атрибут заголовка короткой ссылки.
     */
    $link = apply_filters( 'the_shortlink', $link, $shortlink, $text, $title );
    echo $before, $link, $after;
}

}

Связанные функции

Вот несколько связанных функций, которые могут быть полезны:

Эти функции помогут вам управлять ссылками в WordPress и улучшить взаимодействие с пользователями.

Related Posts

Leave a Reply

Ваш адрес email не будет опубликован. Обязательные поля помечены *