Функция the_shortlink() в WordPress позволяет выводить короткую ссылку для текущей записи. Эта функция особенно полезна, когда вы хотите предоставить пользователям удобный способ делиться ссылками на ваши посты, используя короткие URL-адреса.
the_shortlink( string $text = ”, string $title = ”, string $before = ”, string $after = ” )the_shortlink() выводит ссылку на текущую запись в формате короткой ссылки, например, /?p=1234. Эта функция должна вызываться из цикла WordPress (The Loop) и предназначена для использования на страницах с единственной записью, таких как посты и страницы.
Параметры
$text(string): Необязательный. Текст ссылки или HTML, который будет отображаться. По умолчанию — «This is the short link».$title(string): Необязательный. Текст для атрибутаtitleу тега ссылки. По умолчанию — заголовок текущей записи.$before(string): Необязательный. HTML, который будет отображаться перед ссылкой. По умолчанию — пустая строка.$after(string): Необязательный. HTML, который будет отображаться после ссылки. По умолчанию — пустая строка.
Возвращаемое значение
Функция выводит HTML-код ссылки на короткий URL текущей записи и не возвращает никаких значений.
Пример 1: Вывод короткой ссылки с текстом по умолчанию
Для вывода короткой ссылки с текстом по умолчанию вы можете использовать следующий код:
<?php the_shortlink(); ?>
Вывод будет выглядеть примерно так:
<a rel="shortlink" href="http://example.com/?p=5678" title="Заголовок записи">Это короткая ссылка</a>
Пример 2: Вывод короткой ссылки с пользовательским текстом
Если вы хотите задать свой текст для ссылки, используйте следующий код:
<?php the_shortlink(__('Короткая ссылка для поста', 'textdomain')); ?>
Этот код выведет:
<a rel="shortlink" href="http://example.com/?p=5678" title="Заголовок записи">Короткая ссылка для поста</a>
Пример 3: Вывод ссылки внутри HTML-тегов
Если вам нужно обернуть короткую ссылку в HTML-теги, вы можете использовать параметры $before и $after:
<?php the_shortlink('Краткая ссылка', null, '<div class="shortlink">', '</div>'); ?>
Вывод будет следующим:
<div class="shortlink">
<a rel="shortlink" href="http://example.com/?p=5678" title="Заголовок записи">Краткая ссылка</a>
</div>
Пример 4: Вывод короткой ссылки с пользовательским заголовком
Вы можете также задать заголовок для ссылки, используя параметр $title:
<?php the_shortlink('Короткая ссылка', 'Нажмите, чтобы перейти к посту'); ?>
Этот код выведет:
<a rel="shortlink" href="http://example.com/?p=5678" title="Нажмите, чтобы перейти к посту">Короткая ссылка</a>
Заключение
Функция the_shortlink() — это простой и эффективный способ предоставить пользователям короткие ссылки на ваши записи в WordPress. Используя эту функцию, вы можете улучшить взаимодействие с контентом вашего сайта и упростить процесс обмена ссылками.