previous_post_link()

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

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

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

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

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

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

  • $format (строка, необязательный) — Формат якоря ссылки. По умолчанию: ‘« %link’.
  • $link (строка, необязательный) — Формат постоянной ссылки. По умолчанию: ‘%title’.
  • $in_same_term (логическое значение, необязательный) — Определяет, должна ли ссылка находиться в том же таксономическом термине. По умолчанию: false.
  • $excluded_terms (массив или строка, необязательный) — Массив или список исключенных идентификаторов терминов. По умолчанию: ».
  • $taxonomy (строка, необязательный) — Таксономия, если $in_same_term установлено в true. По умолчанию: ‘category’.
<?php
  // Выводит ссылку на предыдущий пост
  previous_post_link( '<strong><code>&laquo; Previous Post: %link</code></strong>' );
?>

В этом примере функция previous_post_link() используется для вывода ссылки на предыдущий пост. Формат якоря ссылки задан в виде HTML-кода, заключенного в теги <strong> и <code>. Вместо %link будет подставлена ссылка на предыдущий пост.

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

Отображение предыдущей записи с помощью функции previous_post_link()


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

Функция previous_post_link() отображает ссылку на предыдущую запись, которая является смежной с текущей записью. Она принимает несколько параметров:

  • $format (необязательный) — формат якоря ссылки. По умолчанию используется ‘« %link’.
  • $link (необязательный) — формат постоянной ссылки. По умолчанию используется ‘%title’.
  • $in_same_term (необязательный) — определяет, должна ли ссылка находиться в той же таксономии. По умолчанию установлено значение false.
  • $excluded_terms (необязательный) — массив или список исключенных идентификаторов терминов. По умолчанию используется пустая строка.
  • $taxonomy (необязательный) — таксономия, если $in_same_term равно true. По умолчанию используется ‘category’.

Создание ссылки на предыдущую запись с помощью previous_post_link()


// Создание ссылки на предыдущую запись с форматом по умолчанию
previous_post_link();

Для создания ссылки на предыдущую запись с использованием функции previous_post_link() необходимо вызвать функцию без передачи параметров. В этом случае будут использованы значения по умолчанию для формата якоря и формата постоянной ссылки.

Настройка формата ссылки на предыдущую запись с помощью previous_post_link()


// Создание ссылки на предыдущую запись с измененным форматом якоря
previous_post_link( '<div class="previous-post">%link</div>' );

Функция previous_post_link() позволяет настраивать формат якоря ссылки. В примере выше используется div-элемент с классом «previous-post» в качестве обертки для ссылки на предыдущую запись.

Исключение определенных терминов при выводе ссылки на предыдущую запись с помощью previous_post_link()


// Исключение термина с идентификатором 5 при выводе ссылки на предыдущую запись
previous_post_link( '« %link', '%title', false, '5' );

Чтобы исключить определенные термины при выводе ссылки на предыдущую запись, можно передать идентификаторы исключаемых терминов в параметр $excluded_terms. В примере выше исключается термин с идентификатором 5.

Использование другой таксономии для ссылки на предыдущую запись с помощью previous_post_link()


// Использование таксономии "custom_taxonomy" для ссылки на предыдущую запись
previous_post_link( '« %link', '%title', true, '', 'custom_taxonomy' );

По умолчанию функция previous_post_link() использует таксономию «category» для определения, должна ли ссылка находиться в той же таксономии. Вы можете использовать другую таксономию, передав ее имя в параметр $taxonomy. В примере выше используется таксономия «custom_taxonomy».

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

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

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

$format = 'Новый формат %link';
previous_post_link( $format );

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

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

$link = 'Новый формат ссылки';
previous_post_link( '« %link', $link );

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

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

$in_same_term = true;
previous_post_link( '« %link', '%title', $in_same_term );

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

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

Пример кода:


$excluded_terms = array(1, 2, 3);
previous_post_link('%link', '%title', false, $excluded_terms);

Как изменить таксономию, используемую для ссылки на предыдущий пост?

Для изменения таксономии, используемой для ссылки на предыдущий пост, необходимо использовать параметр $taxonomy. По умолчанию, значение этого параметра равно ‘category’.

Пример кода:


$taxonomy = 'custom_taxonomy';
previous_post_link('%link', '%title', false, '', $taxonomy);

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

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

Пример кода:


$format = '<span class="post-link">« %link</span>';
$link = '%title';
previous_post_link($format, $link);

Как изменить формат ссылки на предыдущий пост для определенного термина?

Функция previous_post_link() позволяет изменить формат ссылки на предыдущий пост для определенного термина, используя параметр $in_same_term. Если значение параметра $in_same_term установлено в true, то ссылка будет отображаться только для постов, относящихся к тому же термину таксономии, что и текущий пост.

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


previous_post_link( '%link', 'Previous Post', true );

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

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

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


previous_post_link( '%link', 'Previous Post', false, array( 1, 2, 3 ), 'category' );

Как изменить формат ссылки на предыдущий пост для определенного поста?

Чтобы изменить формат ссылки на предыдущий пост для определенного поста, можно использовать параметры $format и $link. Параметр $format определяет формат якоря ссылки, а параметр $link — формат постоянной ссылки.

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


previous_post_link( '<span class="prev-link">%link</span>', 'Previous Post' );

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

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

  • Функция next_post_link(): отображает ссылку на следующий пост, который является смежным с текущим постом.
  • Функция get_adjacent_post(): возвращает смежный пост.
  • Функция get_previous_post(): возвращает предыдущий пост.
  • Функция get_next_post(): возвращает следующий пост.
  • Класс WP_Post: представляет пост в WordPress.
Записи Ссылки
Обсуждение

Этот сайт использует cookie для хранения данных. Продолжая использовать сайт, Вы принимаете условия пользовательского соглашения и даете свое согласие на использование cookie.