next_post_link()

Отображает ссылку на следующий пост, смежный с текущим постом
Функция WordPress
INT 1.5.0
WordPress Icon

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

Функция next_post_link() выводит ссылку на следующий пост, который является соседним для текущего поста. Ссылка может быть отформатирована с помощью опционального формата и пермалинка.

Функция служит для навигации по постам на сайте WordPress. Она позволяет пользователям легко перемещаться между постами, следуя логическому порядку.

Использование

next_post_link( string $format = '%link »', string $link = '%title', bool $in_same_term = false, int[]|string $excluded_terms = '', string $taxonomy = 'category' )

Функция next_post_link() принимает несколько параметров:

  • $format (строка, опционально): Формат якоря ссылки. По умолчанию: ‘« %link‘.
  • $link (строка, опционально): Формат ссылки на пост. По умолчанию: ‘%title‘.
  • $in_same_term (логическое значение, опционально): Определяет, должна ли ссылка быть в той же таксономии. По умолчанию: false.
  • $excluded_terms (массив или строка, опционально): Массив или список исключенных ID терминов. По умолчанию: пустая строка.
  • $taxonomy (строка, опционально): Таксономия, если $in_same_term установлено в true. По умолчанию: ‘category’.
<?php
  // Выводит ссылку на следующий пост с форматом по умолчанию
  next_post_link();
  // Выводит ссылку на следующий пост с пользовательским форматом и пермалинком
  next_post_link( '<p>Следующий пост: %link</p>', 'Перейти к следующему посту' );
  // Выводит ссылку на следующий пост в той же таксономии
  next_post_link( '<p>Следующий пост: %link</p>', 'Перейти к следующему посту', true );
  // Выводит ссылку на следующий пост, исключая определенные термины
  next_post_link( '<p>Следующий пост: %link</p>', 'Перейти к следующему посту', false, array( 1, 2, 3 ) );
?>

В приведенном выше примере кода функция next_post_link() используется для вывода ссылки на следующий пост с различными параметрами. Каждый вызов функции может иметь свой формат якоря ссылки, текст ссылки и другие опции.

Примеры использования

Отображение следующей ссылки на пост


/**
 * Отображает следующую ссылку на пост, смежную с текущим постом.
 *
 * @param string $format Формат якоря ссылки. По умолчанию '« %link'.
 * @param string $link Формат постоянной ссылки. По умолчанию '%title'.
 * @param bool $in_same_term Определить, должна ли ссылка быть в той же таксономии. По умолчанию false.
 * @param array|string $excluded_terms Массив или список исключенных ID терминов. По умолчанию ''.
 * @param string $taxonomy Таксономия, если $in_same_term равно true. По умолчанию 'category'.
 */
next_post_link( $format = '%link »', $link = '%title', $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' );

Переход к следующему посту


// Переход к следующему посту в той же таксономии.
next_post_link( '%link', 'Next post in same category', true );

Получение ссылки на следующий пост


// Получение ссылки на следующий пост с форматом якоря и постоянной ссылки по умолчанию.
$next_post_link = get_next_post_link();
echo $next_post_link;

Вывод ссылки на следующий пост


// Вывод ссылки на следующий пост с форматом якоря и постоянной ссылки по умолчанию.
next_post_link();

// Навигация к следующему посту с форматом якоря и постоянной ссылки по умолчанию.
next_post_link( '« %link' );

Вопросы и ответы

Как изменить формат якоря ссылки?

Функция next_post_link() позволяет изменить формат якоря ссылки с помощью параметра $format. По умолчанию формат якоря выглядит так: « %link ». Чтобы изменить его, нужно передать новый формат в качестве строки.

Пример использования:


next_post_link( '« %link' );

Как изменить формат ссылки на пост?

Функция next_post_link() также позволяет изменить формат ссылки на пост с помощью параметра $link. По умолчанию формат ссылки выглядит так: %title. Чтобы изменить его, нужно передать новый формат в качестве строки.

Пример использования:


next_post_link( '%title' );

Как сделать так, чтобы ссылка была в той же таксономии?

Для того чтобы ссылка была в той же таксономии, нужно установить параметр $in_same_term в значение true. По умолчанию этот параметр равен false.

Пример использования:


next_post_link( '', '', true );

Как исключить определенные термины из ссылки?

Для исключения определенных терминов из ссылки, вы можете использовать параметр $excluded_terms. Этот параметр принимает массив или строку с ID исключаемых терминов.

Пример использования:


next_post_link( '%link »', '%title', false, array( 1, 2, 3 ) );

В этом примере будут исключены термины с ID 1, 2 и 3 из ссылки.

Как изменить таксономию, если ссылка должна быть в той же таксономии?

Если ссылка должна быть в той же таксономии, вы можете использовать параметр $taxonomy. Этот параметр принимает строку с названием таксономии.

Пример использования:


next_post_link( '%link »', '%title', true, '', 'custom_taxonomy' );

В этом примере ссылка будет в той же таксономии с названием «custom_taxonomy».

Как изменить формат ссылки на пост, если ссылка должна быть в той же таксономии?

Если ссылка должна быть в той же таксономии, вы можете изменить формат ссылки, используя параметр $link. Этот параметр принимает строку с форматом ссылки.

Пример использования:


next_post_link( '%link »', '<strong>%title</strong>', true );

В этом примере ссылка будет отображаться с заголовком поста, выделенным тегом .

Как исключить определенные термины из ссылки, если ссылка должна быть в той же таксономии?

Функция next_post_link() позволяет исключить определенные термины из ссылки, если ссылка должна быть в той же таксономии. Для этого используется параметр $in_same_term, который по умолчанию имеет значение false.

Если нужно исключить определенные термины, необходимо установить значение параметра $in_same_term в true. Также необходимо указать идентификаторы исключаемых терминов в параметре $excluded_terms.


// Пример использования функции next_post_link() с исключением определенных терминов
next_post_link('%link', '%title', true, '1,2,3');

Как изменить таксономию и исключить определенные термины из ссылки?

Функция next_post_link() позволяет изменить таксономию и исключить определенные термины из ссылки. По умолчанию используется таксономия «category». Для изменения таксономии необходимо указать новое значение в параметре $taxonomy.

Для исключения определенных терминов также необходимо установить значение параметра $in_same_term в true и указать идентификаторы исключаемых терминов в параметре $excluded_terms.


// Пример использования функции next_post_link() с измененной таксономией и исключением терминов
next_post_link('%link', '%title', true, '1,2,3', 'custom_taxonomy');

Как изменить формат якоря ссылки и формат ссылки на пост?

Функция next_post_link() позволяет изменить формат якоря ссылки и формат ссылки на пост. По умолчанию используются следующие форматы: '« %link' для якоря ссылки и '%title' для ссылки на пост.

Для изменения формата якоря ссылки необходимо указать новое значение в параметре $format. Для изменения формата ссылки на пост необходимо указать новое значение в параметре $link.


// Пример использования функции next_post_link() с измененными форматами якоря ссылки и ссылки на пост
next_post_link('« %link', 'Read more: %title');

Функция next_post_link() в WordPress позволяет отображать ссылку на следующий пост, который является соседним постом к текущему. Она предоставляет возможность исключить определенные термины из ссылки, изменить таксономию и форматы якоря ссылки и ссылки на пост. Это полезная функция для разработчиков WordPress, которые хотят настраивать отображение ссылок на следующие посты в своих темах или плагинах.

Связанные элементы

  • Функция previous_post_link(): отображает ссылку на предыдущий пост, смежный с текущим постом.
  • Функция get_adjacent_post(): возвращает объект предыдущего или следующего поста.
  • Функция get_previous_post(): возвращает объект предыдущего поста.
  • Функция get_next_post(): возвращает объект следующего поста.
  • Класс WP_Query: используется для выполнения запросов к базе данных WordPress и получения списка постов.
Обсуждение