Описание функции wp_get_shortlink()
Функция wp_get_shortlink() возвращает короткую ссылку на запись или страницу. Она используется для создания удобных и компактных URL-адресов, которые могут быть легко использованы в социальных сетях и других платформах. Короткие ссылки обычно создаются с использованием специфичных для сайта механизмов, таких как Bitly или другие сервисы сокращения ссылок.
Функция подходит для использования в темах и плагинах, где необходимо предоставить пользователю короткий URL для текущей записи или страницы.
Параметры
$post_id
Тип: int
Обязательный: Нет
По умолчанию: null
Описание: ID записи, для которой нужно получить короткую ссылку
Возможные значения:
Возвращаемое значение
Тип: string|false
Описание: Короткая ссылка на запись или false при ошибке
Возможные значения:
• Строка с короткой ссылкой при успешном выполнении
• false если запись не найдена или ошибка
Примеры использования
$shortlink = wp_get_shortlink();
// Вывод короткой ссылки
echo $shortlink; // Например, https://example.com/?p=123
$shortlink = wp_get_shortlink(42);
// Вывод короткой ссылки
echo $shortlink; // Например, https://example.com/?p=42
Проверка на наличие ошибки при получении ссылки
$shortlink = wp_get_shortlink(99999);
if ($shortlink === false) {
echo 'Ошибка: запись не найдена';
}
Безопасность
Валидация входных данных: ID записи проходит валидацию внутри функции
Санитизация: Функция автоматически обрабатывает данные перед выводом
Рекомендации: Используйте esc_url() для безопасного вывода короткой ссылки
— Связанные функции
Получает полный permalink для записи
Фильтрует короткую ссылку перед выводом
— Хуки
Позволяет изменять короткую ссылку перед её возвратом
— Примечания
– Ограничения
Короткая ссылка может не генерироваться для всех типов записей
– Частые проблемы
- Возвращает false при неверном ID записи
- Не работает для черновиков или удалённых записей
