Loop Post Navigation Links

Этот плагин предоставляет два тега шаблона для использования в single.php для создания цикла навигации по сообщениям, при этом перед первым сообщением будет последнее сообщение, а после последнего сообщения - первое сообщение. Обычно, когда вы находитесь на последнем посте и нажимаете, чтобы перейти к следующему посту, ссылка ведет к первому посту. Точно так же, если вы находитесь в первом сообщении и щелкаете, чтобы перейти к предыдущему сообщению, ссылка приведет вас к последнему сообщению. Функция c2c_next_or_loop_post_link () идентична функции next_post_link () WordPress во всех отношениях, за исключением случаев, когда она вызывается для последней публикации в последовательности навигации, и в этом случае она ссылается на первую запись в последовательности навигации. Функция c2c_previous_or_loop_post_link () идентична функции previous_post_link () WordPress во всех отношениях, за исключением случая, когда она вызывается для первого сообщения в последовательности навигации, и в этом случае она ссылается на последнюю запись в последовательности навигации. Полезно для обеспечения циклической ссылки на сообщения, например, для портфолио, или для постоянного представления соответствующих сообщений посетителям, чтобы они могли продолжить чтение. Если вы заинтересованы в получении самого сообщения, а не просто ссылки на него, вы можете использовать функции c2c_get_next_or_loop_post () и c2c_get_previous_or_loop_post (). Если вам нужен только URL-адрес сообщения, вы можете использовать c2c_get_next_or_loop_post_url () и c2c_get_previous_or_loop_post_url (). Ссылки: Домашняя страница плагина | Страница каталога плагинов | GitHub | Теги шаблона домашней страницы автора Плагин предоставляет четыре тега шаблона для использования в ваших шаблонах тем для отдельных сообщений. Функции function c2c_next_or_loop_post_link ($ format = '% link & raquo;', $ link = '% title', $ in_same_term = false, $ excluded_terms = '', $ taxonomy = 'category') Как и next_post_link () WordPress, эта функция отображает ссылка на следующий хронологический пост (среди всех опубликованных постов, тех, что находятся в той же категории, или тех, которые не находятся в определенных категориях). Отмените связь с next_post_link (), когда на последнем посте в последовательности, эта функция вернется к первому посту в последовательности, создавая круговой цикл. function c2c_get_next_or_loop_post_link ($ format = '% link & raquo;', $ link = '% title', $ in_same_term = false, $ excluded_terms = ', $ taxonomy =' category ') Подобно `c2c_next_or_loop_post_link (), но возвращает значение без повторяя это. function c2c_previous_or_loop_post_link ($ format = '& laquo;% link', $ link = '% title', $ in_same_term = false, $ excluded_terms = '', $ taxonomy = 'category') Как и предыдущая_пост_ссылка () WordPress, эта функция отображает ссылку к предыдущему посту в хронологическом порядке (среди всех опубликованных постов, относящихся к той же категории или постов, не относящихся к определенным категориям). Отмените связь с previous_post_link (), когда на первом посте в последовательности эта функция будет ссылаться на последний пост в последовательности, создавая круговой цикл. function c2c_get_previous_or_loop_post_link ($ format = '& laquo;% link', $ link = '% title', $ in_same_term = false, $ excluded_terms = ', $ taxonomy =' category ') Подобно `c2c_get_previous_or_loop_post_link (), но возвращает значение без повторяя это. function c2c_get_next_or_loop_post ($ in_same_term = false, $ excluded_terms = '', $ taxonomy = 'category') Подобно get_adjacent_post () WordPress, когда используется для поиска следующего сообщения, кроме случаев, когда на последнем посте в последовательности эта функция вернет первое сообщение в последовательности, создавая круговую петлю. function c2c_get_previous_or_loop_post ($ in_same_term = false, $ excluded_terms = '', $ taxonomy = 'category') Подобно get_adjacent_post () WordPress при использовании для поиска предыдущего сообщения, кроме случаев, когда для первого сообщения в последовательности эта функция вернет последнее сообщение в последовательности, создавая круговую петлю. function c2c_get_next_or_loop_post_url ($ in_same_term = false, $ excluded_terms = '', $ taxonomy = 'category') Возвращает URL-адрес следующего сообщения или сообщения в начале серии. function c2c_get_previous_or_loop_post_url ($ in_same_term = false, $ excluded_terms = '', $ taxonomy = 'category') Возвращает URL-адрес предыдущей публикации или публикации в конце серии. Аргументы $ format (необязательно) Строка процентной подстановки, указывающая формат всей выходной строки. Используйте% link для представления следующего / предыдущего сообщения, на которое указывает ссылка, или% title для представления заголовка следующего / предыдущего сообщения. $ link (необязательно) Строка процентной подстановки, указывающая формат самой ссылки, которая создается для следующей / предыдущей публикации. Используйте% link для представления следующего / предыдущего сообщения, на которое указывает ссылка, или% title для представления заголовка следующего / предыдущего сообщения. $ in_same_term (необязательно) Логическое значение (истина или ложь), указывающее, должно ли следующее / предыдущее сообщение входить в тот же термин таксономии текущего сообщения. $ excluded_terms (необязательно) Массив или разделенная запятыми строка идентификаторов категорий или терминов, к которым сообщения не могут принадлежать. $ taxonomy (необязательно) Таксономия, если $ in_same_term истинно. Категория по умолчанию. Примеры

Хуки

Плагин дополнительно настраивается с помощью одиннадцати хуков. Как правило, код, использующий хуки, в идеале должен быть помещен в плагин mu, плагин для конкретного сайта (который выходит за рамки данного файла readme) или в файлы шаблонов тем. Многие из этих фильтров, вероятно, будут интересны только опытным пользователям, умеющим программировать. c2c_previous_or_loop_post_link_output, c2c_next_or_loop_post_link_output (фильтры) Фильтры 'c2c_previous_or_loop_post_link_output' и 'c2c_next_or_loop_post_link_output' позволяют вам настроить следующую разметку ссылок, созданную для предыдущих и последующих ссылок, соответственно. Аргументы: $ format (строка): формат привязки ссылки. $ link (строка): Формат постоянной ссылки ссылки. $ in_same_term (bool): Необязательно. Должна ли ссылка входить в один и тот же термин таксономии. По умолчанию - false. $ excluded_terms (array | string): необязательно. Массив или список исключенных терминов, разделенных запятыми. По умолчанию ». $ previous (bool): Необязательно. Отображать ли ссылку на предыдущий или следующий пост. По умолчанию верно. $ taxonomy (строка): Необязательно. Таксономия, если $ in_same_term истинно. Категория по умолчанию. $ смежный (строка): является ли сообщение предыдущим или следующим. Пример: c2c_previous_or_loop_post_link_get, c2c_next_or_loop_post_link_get (фильтры) Фильтры 'c2c_previous_or_loop_post_link_get' и 'c2c_next_or_loop_post_link_get' позволяют настраивать циклические разметки ссылок, созданные для предыдущих и следующих ссылок, соответственно, но для следующих функций. Аргументы: $ output (строка): ссылка на соседний пост. $ format (строка): формат привязки ссылки. $ link (строка): Формат постоянной ссылки ссылки. $ post (WP_Post): соседний пост. $ in_same_term (bool): Необязательно. Должна ли ссылка входить в один и тот же термин таксономии. По умолчанию - false. $ excluded_terms (array | string): необязательно. Массив или список исключенных терминов, разделенных запятыми. По умолчанию ». $ previous (bool): Необязательно. Отображать ли ссылку на предыдущий или следующий пост. По умолчанию верно. $ taxonomy (строка): Необязательно. Таксономия, если $ in_same_term истинно. Категория по умолчанию. $ смежный (строка): является ли сообщение предыдущим или следующим. c2c_previous_or_loop_post_link, c2c_next_or_loop_post_link, c2c_get_previous_or_loop_post_link, c2c_get_next_or_loop_post_link, c2c_get_adjacent_or_loop_post, c2c_get_previous_or_loop_post, c2c_get_previous_or_loop_post (действия) 'c2c_previous_or_loop_post_link' и 'c2c_next_or_loop_post_link' действия позволяют использовать альтернативный подход для безопасного Invoke c2c_previous_or_loop_post_link () и c2c_next_or_loop_post_link (), соответственно, таким образом, что если плагин был деактивирован или удален, то ваши вызовы функций не вызовут ошибок на вашем сайте. Фильтры 'c2c_get_previous_or_loop_post_link' и 'c2c_get_next_or_loop_post_link' делают то же самое для неотражаемых c2c_previous_or_loop_post_link () и c2c_next_or_loop_post_link (). Аргументы: такие же, как для c2c_previous_or_loop_post_link () и c2c_next_or_loop_post_link () Пример: вместо: & laquo;% link '); ?> Сделайте: & laquo;% link '); ?>

Автор: Scott Reilly

Версия: 3.0.2

Последнее обновление: 2020-08-27 7:28am GMT