Описание функции get_the_permalink()
Функция get_the_permalink() возвращает постоянную ссылку на текущую запись в контексте цикла WordPress. Она позволяет получать URL для конкретной записи, что полезно для создания ссылок на записи в темах и плагинах.
Функция учитывает настройки постоянных ссылок, заданные в административной панели WordPress
Параметры
$post
Тип: int|WP_Post
Обязательный: Нет
По умолчанию: null
Описание: ID или объект записи, для которой требуется получить постоянную ссылку
Возможные значения:
int: ID записи
WP_Post: Объект записи
Возвращаемое значение
Тип: string|false
Описание: Возвращает строку с постоянной ссылкой или false в случае ошибки
Возможные значения:
• Строка ссылки на запись при успешном выполнении
• false если запись не найдена или произошла ошибка
Примеры использования
Базовый пример получения постоянной ссылки на текущую запись
$permalink = get_the_permalink();
// Вывод ссылки
echo $permalink;
Выводит ссылку на текущую запись в цикле
Получение ссылки на запись с конкретным ID
$permalink = get_the_permalink(42);
// Вывод ссылки на запись с ID 42
echo $permalink;
Использует ID записи вместо текущего контекста
Безопасность
Валидация входных данных: Параметр post автоматически валидируется функцией
Санитизация: Ссылки безопасны для вывода, однако рекомендуется использовать esc_url() для вывода
Рекомендации: При выводе результатов используйте esc_url() для ссылок
— Связанные функции
Получает постоянную ссылку на запись по ID
Выводит постоянную ссылку на запись в контексте цикла
— Хуки
Фильтрует постоянные ссылки на записи
— Примечания
– Ограничения
Возвращает false, если указанный ID не существует
– Частые проблемы
- Проблемы с настройками постоянных ссылок могут привести к некорректным URL
- Ошибка при использовании с неопубликованными записями
