get_post_permalink()
Получает URL (постоянную ссылку) на запись произвольного типа.
Функция является основой для функции get_permalink(), когда нужно получить постоянную ссылку на произвольный тип записи.
Вместо этой функции лучше использовать get_permalink().
Основа для: get_permalink()
1 раз — 0.000578 сек (медленно) | 50000 раз — 5 сек (быстро)
Хуки из функции
Возвращает
Строку|false
. УРЛ поста. false, если поста не существует (с WP 6.1).
Использование
get_post_permalink( $id, $leavename, $sample );
- $id(число)
- ID поста, ссылку на который нужно получить.
По умолчанию: ID текущего поста, который находится в цикле WordPress в данный момент - $leavename(логический)
- Оставлять ли имя поста. true - не заменять плейсхолдер
%post_type%
на имя поста.
По умолчанию: false - $sample(логический)
- true — это образец (пример) ссылки. На вывод не влияет, но передается в хук post_type_link.
По умолчанию: false
Примеры
#1 Демонстрация работы
Выведем ссылки на разные типы записей и с разными параметрами.
// встроенный тип записи post echo get_post_permalink( 1 ); // https://wp-kama.ru/?post_type=post&p=1 // УРЛ на произвольный тип записи echo get_post_permalink( 225 ); // http://wp-kama.ru/function/get_permalink echo get_post_permalink( 225, true ); // http://wp-kama.ru/function/%func%
Заметки
- Global. WP_Rewrite. $wp_rewrite WordPress rewrite component.
Список изменений
С версии 3.0.0 | Введена. |
С версии 6.1.0 | Returns false if the post does not exist. |