get_the_post_navigation()

Извлекает навигацию к следующей/предыдущей записи, если применимо
Функция WordPress
INT 4.4.0, 4.1.0
WordPress Icon
Содержание
  1. Описание функции
  2. Примеры использования
  3. Получение навигации к предыдущей и следующей записи
  4. Отображение ссылок на предыдущую и следующую запись
  5. Настройка текста ссылок на предыдущую и следующую запись
  6. Определение ссылок на записи в одной таксономии
  7. Исключение определенных терминов из ссылок на записи
  8. Изменение таксономии для ссылок на записи
  9. Настройка текста для экранных читалок
  10. Изменение ARIA-метки для навигации по записям
  11. Настройка класса для элемента навигации
  12. Вопросы и ответы
  13. Как изменить текст ссылки на предыдущий пост?
  14. Как изменить текст ссылки на следующий пост?
  15. Как изменить текст для навигационного элемента?
  16. Как изменить класс для навигационного элемента?
  17. Как изменить текст для элемента, доступного для чтения с экрана?
  18. Как изменить текст для элемента ARIA-метки?
  19. Как изменить таксономию для ссылки, если in_same_term установлено в true?
  20. Как исключить определенные термины из ссылок?
  21. Как изменить маркировку для ссылок на посты?
  22. Связанные элементы

Описание функции

Функция 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(): Возвращает объект следующего поста.
Обсуждение