Описание функции the_permalink()
Функция the_permalink() выводит постоянную ссылку на текущую запись или страницу. Это полезно для создания ссылок на контент в шаблонах.
Функция автоматически учитывает настройки постоянных ссылок и возвращает корректный URL для доступа к записи
Параметры
$args
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Массив аргументов для настройки вывода ссылки
Возможные значения:
post_id: ID записи (по умолчанию используется текущая запись)
Возвращаемое значение
Тип: string
Описание: URL постоянной ссылки на запись или страницу
Возможные значения:
• Корректный URL записи (например, ‘https://example.com/sample-post/’)
• Пустая строка при отсутствии записи
Примеры использования
Базовый пример вывода постоянной ссылки на текущую запись
the_permalink();
Ссылка будет выведена в HTML-коде
Вывод постоянной ссылки для записи с ID 42
$post_id = 42;
wp_query->the_post();
the_permalink($post_id);
Необходимо установить контекст записи
Безопасность
Валидация входных данных: Параметры не требуют валидации, так как по умолчанию используется текущая запись
Санитизация: URL проходит автоматическую очистку
Рекомендации: Используйте esc_url() при выводе ссылки для предотвращения XSS
— Связанные функции
Получает постоянную ссылку без немедленного вывода
Выводит содержимое записи
— Хуки
Фильтрует постоянную ссылку перед её выводом
— Примечания
– Ограничения
Не поддерживает вывод ссылок для таксономий или пользовательских типов записей без контекста
– Частые проблемы
- Пустая ссылка при попытке вывода для несуществующей записи
- Ошибки при использовании вне контекста главного цикла
