get_sample_permalink()
Отримує зразок постійного заслання (пермалинка) запису.
Для роботи функції у фронт-енді потрібно підключити файл:
require_once ABSPATH. '/wp-admin/includes/post.php';
Хуки з функції
Array(
[0] => https://wp-doc.com/%postname%.html
[1] => customize-api
)
Використання
get_sample_permalink( $id, $title, $name );
-
$id
(число/WP_Post) (обов’язковий) - ID або об’єкт запису (поста), зразок пермалінки якого потрібно отримати.
-
$title
(рядок) Заголовок запису, який потрібно використовувати для створення ярлика посилання ( post_name ).
Для цього параметра в $name потрібно вказати порожній рядок. Якщо цього не зробити, цей параметр ніде не буде використовуватися, а просто буде переданий в хук get_sample_permalink .
Типово: null
-
$name
(рядок) -
Ярлик запису, який перезапише поточний ярлик (
post_name ). Впливає на роботу параметра
$title . Якщо вказаний рядок не порожній, перебиває параметр
$title (див. приклади).
Типово: null
Приклади
#1 Демонстрація роботи
require_once ABSPATH. '/wp-admin/includes/post.php'; $sample_permalink = get_sample_permalink(10262); /* Array ( [0] => https://wp-doc.com/%postname%.html [1] => customize-api ) */
#2 Використання всіх параметрів
$sample_permalink = get_sample_permalink( 10262, 'Мій заголовок'); /* [0] => https://wp-doc.com/%postname%.html [1] => customize-api */ $sample_permalink = get_sample_permalink( 10262, 'Мій заголовок', ''); /* [0] => https://wp-doc.com/%postname%.html [1] => moj-zagolovok */ $sample_permalink = get_sample_permalink( 10262, 'Мій заголовок', 'Якщо вказати ім'я'); /* [0] => https://wp-doc.com/%postname%.html [1] => esli-ukazat-imya */
список змін
З версії 2.5.0 | Введено. |