- Описание функции
- Примеры использования
- Получение навигации к предыдущей и следующей записи
- Отображение ссылок на предыдущую и следующую запись
- Настройка текста ссылок на предыдущую и следующую запись
- Определение ссылок на записи в одной таксономии
- Исключение определенных терминов из ссылок на записи
- Изменение таксономии для ссылок на записи
- Настройка текста для экранных читалок
- Изменение ARIA-метки для навигации по записям
- Настройка класса для элемента навигации
- Вопросы и ответы
- Как изменить текст ссылки на предыдущий пост?
- Как изменить текст ссылки на следующий пост?
- Как изменить текст для навигационного элемента?
- Как изменить класс для навигационного элемента?
- Как изменить текст для элемента, доступного для чтения с экрана?
- Как изменить текст для элемента ARIA-метки?
- Как изменить таксономию для ссылки, если in_same_term установлено в true?
- Как исключить определенные термины из ссылок?
- Как изменить маркировку для ссылок на посты?
- Связанные элементы
Описание функции
Функция get_the_post_navigation() возвращает навигацию к предыдущему и следующему посту, если это применимо.
Она используется для отображения ссылок на предыдущий и следующий посты на странице одного поста.
Функция принимает необязательный массив аргументов, которые позволяют настроить вывод навигации.
Использование
get_the_post_navigation( array $args = array() ): string Функция get_the_post_navigation() принимает один необязательный аргумент — массив $args, который содержит настройки для вывода навигации.
$args(массив) — Необязательный. Аргументы по умолчанию для навигации между постами.prev_text(строка) — Текст ссылки на предыдущий пост. По умолчанию: ‘%title’.next_text(строка) — Текст ссылки на следующий пост. По умолчанию: ‘%title’.in_same_term(логическое значение) — Определяет, должна ли ссылка быть в том же таксономическом термине. По умолчанию: false.excluded_terms(массив или строка) — Массив или строка с ID исключаемых терминов. По умолчанию: пустой массив.taxonomy(строка) — Таксономия, если$in_same_termустановлено в true. По умолчанию: ‘category’.screen_reader_text(строка) — Текст для считывания экраном для элемента навигации. По умолчанию: ‘Навигация по записям’.aria_label(строка) — Текст ARIA-метки для элемента навигации. По умолчанию: ‘Записи’.class(строка) — Пользовательский класс для элемента навигации. По умолчанию: ‘post-navigation’.
Функция возвращает разметку для ссылок на посты в виде строки.
<?php
$args = array(
'prev_text' => 'Предыдущий пост: %title',
'next_text' => 'Следующий пост: %title',
'in_same_term' => true,
'excluded_terms' => array(1, 2, 3),
'taxonomy' => 'category',
'screen_reader_text' => 'Навигация по записям',
'aria_label' => 'Записи',
'class' => 'custom-post-navigation'
);
$post_navigation = get_the_post_navigation( $args );
echo $post_navigation;
?> В этом примере мы создаем массив $args, в котором задаем различные настройки для навигации между постами. Затем мы вызываем функцию get_the_post_navigation() с этим массивом аргументов и сохраняем результат в переменную $post_navigation. Наконец, мы выводим разметку навигации с помощью echo.
Примеры использования
Получение навигации к предыдущей и следующей записи
$args = array(
'prev_text' => 'Previous post: %title',
'next_text' => 'Next post: %title'
);
$navigation = get_the_post_navigation($args);
echo $navigation;
В данном примере мы используем функцию get_the_post_navigation() для получения навигации к предыдущей и следующей записи. В качестве аргументов мы передаем массив $args, в котором задаем текст для ссылок на предыдущую и следующую запись.
Результатом выполнения кода будет вывод навигации с текстом «Previous post: [название предыдущей записи]» и «Next post: [название следующей записи]».
Отображение ссылок на предыдущую и следующую запись
$navigation = get_the_post_navigation();
echo $navigation;
В данном примере мы используем функцию get_the_post_navigation() без передачи аргументов. Это приведет к отображению ссылок на предыдущую и следующую запись с текстом по умолчанию.
Результатом выполнения кода будет вывод навигации с текстом «Previous post» и «Next post».
Настройка текста ссылок на предыдущую и следующую запись
$args = array(
'prev_text' => '← Previous',
'next_text' => 'Next →'
);
$navigation = get_the_post_navigation($args);
echo $navigation;
В данном примере мы используем функцию get_the_post_navigation() и задаем текст для ссылок на предыдущую и следующую запись с помощью аргументов prev_text и next_text.
Результатом выполнения кода будет вывод навигации с текстом «← Previous» и «Next →».
Определение ссылок на записи в одной таксономии
$args = array(
'in_same_term' => true
);
$navigation = get_the_post_navigation($args);
echo $navigation;
В данном примере мы используем функцию get_the_post_navigation() и устанавливаем аргумент in_same_term в значение true. Это позволяет определить, должны ли ссылки на предыдущую и следующую запись находиться в одной таксономии.
Результатом выполнения кода будет вывод навигации с ссылками на предыдущую и следующую запись, которые находятся в одной таксономии.
Исключение определенных терминов из ссылок на записи
$args = array(
'excluded_terms' => '1,2,3'
);
$navigation = get_the_post_navigation($args);
echo $navigation;
В данном примере мы используем функцию get_the_post_navigation() и устанавливаем аргумент excluded_terms в значение списка идентификаторов исключенных терминов. В данном случае исключены термины с идентификаторами 1, 2 и 3.
Результатом выполнения кода будет вывод навигации с ссылками на предыдущую и следующую запись, исключая указанные термины.
Изменение таксономии для ссылок на записи
$args = array(
'taxonomy' => 'custom_taxonomy'
);
$navigation = get_the_post_navigation($args);
echo $navigation;
В данном примере мы используем функцию get_the_post_navigation() и устанавливаем аргумент taxonomy в значение пользовательской таксономии. Это позволяет изменить таксономию, в которой будут искаться ссылки на предыдущую и следующую запись.
Результатом выполнения кода будет вывод навигации с ссылками на предыдущую и следующую запись в указанной таксономии.
Настройка текста для экранных читалок
$args = array(
'screen_reader_text' => 'Navigation'
);
$navigation = get_the_post_navigation($args);
echo $navigation;
В данном примере мы используем функцию get_the_post_navigation() и устанавливаем аргумент screen_reader_text в значение текста для экранных читалок. Это позволяет настроить текст, который будет использоваться для озвучивания навигации.
Результатом выполнения кода будет вывод навигации с указанным текстом для экранных читалок.
Изменение ARIA-метки для навигации по записям
$args = array(
'aria_label' => 'Post Navigation'
);
$navigation = get_the_post_navigation($args);
echo $navigation;
В данном примере мы используем функцию get_the_post_navigation() и устанавливаем аргумент aria_label в значение ARIA-метки для навигации по записям. Это позволяет изменить текст, который будет использоваться для озвучивания навигации по записям.
Результатом выполнения кода будет вывод навигации с указанной ARIA-меткой.
Настройка класса для элемента навигации
$args = array(
'class' => 'custom-navigation'
);
$navigation = get_the_post_navigation($args);
echo $navigation;
В данном примере мы используем функцию get_the_post_navigation() и устанавливаем аргумент class в значение пользовательского класса для элемента навигации. Это позволяет изменить класс, который будет применяться к элементу навигации.
Результатом выполнения кода будет вывод навигации с указанным пользовательским классом.
Вопросы и ответы
Как изменить текст ссылки на предыдущий пост?
Для изменения текста ссылки на предыдущий пост необходимо использовать параметр prev_text при вызове функции get_the_post_navigation(). По умолчанию значение этого параметра равно '%title', что означает, что в ссылке будет отображаться заголовок предыдущего поста.
Пример использования:
$args = array(
'prev_text' => 'Previous post: %title',
);
echo get_the_post_navigation($args);
Как изменить текст ссылки на следующий пост?
Для изменения текста ссылки на следующий пост необходимо использовать параметр next_text при вызове функции get_the_post_navigation(). По умолчанию значение этого параметра равно '%title', что означает, что в ссылке будет отображаться заголовок следующего поста.
Пример использования:
$args = array(
'next_text' => 'Next post: %title',
);
echo get_the_post_navigation($args);
Как изменить текст для навигационного элемента?
Для изменения текста для навигационного элемента необходимо использовать параметр screen_reader_text при вызове функции get_the_post_navigation(). По умолчанию значение этого параметра равно 'Post navigation', что означает, что в навигационном элементе будет отображаться текст «Post navigation».
Пример использования:
$args = array(
'screen_reader_text' => 'Navigation',
);
echo get_the_post_navigation($args);
Как изменить класс для навигационного элемента?
Для изменения класса навигационного элемента используется параметр class функции get_the_post_navigation(). По умолчанию класс равен post-navigation. Чтобы изменить класс, нужно передать новое значение в этот параметр.
$args = array(
'class' => 'my-custom-class'
);
echo get_the_post_navigation($args);
Как изменить текст для элемента, доступного для чтения с экрана?
Для изменения текста элемента, доступного для чтения с экрана, используется параметр screen_reader_text функции get_the_post_navigation(). По умолчанию текст равен Post navigation. Чтобы изменить текст, нужно передать новое значение в этот параметр.
$args = array(
'screen_reader_text' => 'Custom navigation'
);
echo get_the_post_navigation($args);
Как изменить текст для элемента ARIA-метки?
Для изменения текста элемента ARIA-метки используется параметр aria_label функции get_the_post_navigation(). По умолчанию текст равен Posts. Чтобы изменить текст, нужно передать новое значение в этот параметр.
$args = array(
'aria_label' => 'Custom posts navigation'
);
echo get_the_post_navigation($args);
Как изменить таксономию для ссылки, если in_same_term установлено в true?
Если параметр in_same_term установлен в значение true, то функция get_the_post_navigation() будет выводить ссылки только на посты из той же таксономии, что и текущий пост. По умолчанию, таксономия установлена в значение 'category'. Вы можете изменить таксономию, указав значение параметра taxonomy.
$args = array(
'in_same_term' => true,
'taxonomy' => 'your_taxonomy',
);
$navigation = get_the_post_navigation($args);
Как исключить определенные термины из ссылок?
Если вам необходимо исключить определенные термины из ссылок, вы можете использовать параметр excluded_terms. Передайте массив или список идентификаторов исключаемых терминов в этот параметр.
$args = array(
'excluded_terms' => array(1, 2, 3),
);
$navigation = get_the_post_navigation($args);
Как изменить маркировку для ссылок на посты?
По умолчанию, функция get_the_post_navigation() использует маркировку %title для текста ссылок на предыдущий и следующий посты. Вы можете изменить эту маркировку, указав значение параметров prev_text и next_text.
$args = array(
'prev_text' => 'Previous: %title',
'next_text' => 'Next: %title',
);
$navigation = get_the_post_navigation($args);
Функция
get_the_post_navigation()позволяет получить навигацию к предыдущему и следующему посту. Вы можете настроить таксономию для ссылок, исключить определенные термины и изменить маркировку для ссылок на посты, используя соответствующие параметры.
Связанные элементы
- Функция
get_previous_post_link(): Возвращает HTML-ссылку на предыдущий пост. - Функция
get_next_post_link(): Возвращает HTML-ссылку на следующий пост. - Функция
get_adjacent_post(): Возвращает объект предыдущего или следующего поста. - Функция
get_adjacent_post_rel_link(): Возвращает HTML-ссылку на предыдущий или следующий пост с атрибутом rel. - Функция
get_adjacent_post_link(): Возвращает HTML-ссылку на предыдущий или следующий пост с атрибутами rel, title и class. - Функция
get_previous_post(): Возвращает объект предыдущего поста. - Функция
get_next_post(): Возвращает объект следующего поста.