A-Z Listing

Показывайте свои сообщения, страницы и термины в алфавитном порядке в виде списка Rolodex, каталога или каталога с помощью плагина AZ Listing! Плагин имеет сокращенный код для списка и виджет, чтобы вы могли ссылаться на список из любого места на вашем сайте. Если в письме нет страниц, виджет будет отображать письмо без ссылки. На странице списка эта буква будет полностью опущена. Показывать сообщения из любого или нескольких типов сообщений, включая встроенные сообщения и страницы. Также поддерживаются пост-типы из плагинов, таких как продукты WooCommerce. Также можно показать такие термины, как категории или теги. short-code Плагин предоставляет сокращенный код для полного списка AZ, что позволяет использовать его без изменения шаблонов вашей темы. Основное использование выглядит следующим образом: [az-листинг] Чтобы указать тип сообщения для отображения вместо страницы, используйте, например, post: [az -isting display = "posts" post-type = "post"] Для фильтрации сообщений по термин из таксономии: [az -isting display = "posts" taxonomy = "category" terms = "my-term-slug"] Для отображения страниц, которые являются прямыми дочерними элементами страницы с идентификатором 24: [az -isting display = "posts" post-type = "page" parent-post = "24"] Для отображения дочерних страниц любой глубины ниже страницы с идентификатором 24: [az -isting display = "posts" post-type = "page" parent-post = "24" get-all-children = "yes"] Чтобы отображать термины из таксономии вместо сообщений и страниц, например, термины из таксономии категорий: [az -isting display = "terms" taxonomy = "category" ] Чтобы отобразить термины из таксономии категорий, которые являются прямыми дочерними элементами термина с идентификатором 42: [az -isting display = "terms" taxonomy = "category" parent-term = "42"] Чтобы отобразить термины из таксономии категорий, которые являются дочерними элементами любой глубины в дереве под термином с идентификатором 42: [az -isting dis play = "terms" taxonomy = "category" parent-term = "42" get-all-children = "yes"] Чтобы переопределить алфавит, используемый плагином: [az -isting display = "posts" алфавит = "Aa, Bb, Cc, Dd, Ee, Ff, Gg, Hh, Ii, Jj, Kk, Ll, Mm, Nn, Oo, Pp, Qq, Rr, Ss, Tt, Uu, Vv, Ww, Xx, Yy, Zz " ] Чтобы добавить числа к списку: [az -isting display = "posts" numbers = "after"] Цифры также могут отображаться перед алфавитом: [az -isting display = "posts" numbers = "before"] Вы можете сгруппируйте номера в единую коллекцию для всех сообщений, начинающихся с цифры: [az -isting numbers = "after" group-numbers = "yes"] Чтобы сгруппировать буквы алфавита в диапазон: [az -isting grouping = "3" ] ** Все аргументы являются необязательными. ** Отображение общих параметров: указывает, следует ли отображать сообщения или термины из таксономии. Значение по умолчанию: сообщения. Может содержать только одно значение. Должно быть установлено либо сообщения, либо условия. Любое значение, кроме сообщений или условий, по умолчанию будет отображать сообщения. числа: добавляет или добавляет цифры к алфавиту. Значение по умолчанию: не задано. Может содержать только одно значение. Должен быть установлен до или после. Любое значение, кроме "до" или "после", по умолчанию будет добавлять цифры к алфавиту. группировка: сообщает плагину, если и как группировать алфавит. Значение по умолчанию: не задано. Может содержать только одно значение. Должно быть установлено любое положительное число больше 1 или числа значений. Любое значение, кроме положительного числа или чисел значений, по умолчанию отключает все функции группировки. Если установлено число больше 1, в списке буквы будут сгруппированы в диапазоны. Например, если вы выбрали 3, тогда латинский алфавит сгруппирует вместе A, B и C в AC. То же самое для DF, GI и так далее. При использовании этого параметра, если числа также отображаются через атрибут numbers = "before" или numbers = "after", то они будут отображаться как отдельная группа 0-9. Когда установлено значение чисел, оно сгруппирует числа в единую группу 0-9. Это требует, чтобы числа отображались через атрибуты numbers = "before" или numbers = "after". group-numbers: указывает плагину сгруппировать все элементы, начинающиеся с цифры, в единую коллекцию. Значение по умолчанию: false. Может содержать только одно значение. Должно быть установлено значение true, yes, on или 1, чтобы сгруппировать элементы, начинающиеся с цифры, в единую коллекцию. Все остальные значения сохранят поведение по умолчанию. алфавит: позволяет вам переопределить алфавит, который использует плагин. Значение по умолчанию: не задано. Если этот атрибут не определен, плагин либо будет использовать непереведенный вариант по умолчанию, либо, если glotpress включает перевод для языка вашего сайта, как установлено в Admin -> Settings -> Site Language, он будет использовать этот перевод. Текущее непереведенное значение по умолчанию: AÁÀÄÂaáàäâ, Bb, Cc, Dd, EÉÈËÊeéèëê, Ff, Gg, Hh, IÍÌÏÎiíìïî, Jj, Kk, Ll, Mm, Nn, OÓÒÖoóòöô, Pp, Qq, Rr, Ssüß, Tutu Ww, Xx, Yy, Zz. Принимает одну строку букв / символов, которые необходимо разделить запятой,. При включении более одной буквы / символа в каждую группу будут отображаться сообщения, начинающиеся с любой из тех, что находятся в том же разделе. Первая буква / символ в каждой группе используется в качестве заголовка группы при отображении на вашем сайте. Параметры сообщений тип сообщения: устанавливает в листинге отображение определенного типа сообщения. Значение по умолчанию: страница. Можно указать несколько типов записей, разделив их запятыми (,), например post-type = "page, post". Должен быть ярлыком типа (ов) поста. parent-post: устанавливает родительский пост, от которого должны происходить все отображаемые сообщения. Значение по умолчанию: не задано. Может содержать только одно значение. Должен быть идентификатор родительского сообщения. Добавьте get-all-children = "yes", чтобы также включить всех потомков любой глубины ниже родительского сообщения. exclude-posts: удалить эти сообщения из списка. Значение по умолчанию: не задано. Несколько сообщений можно указать через запятую:,. Должен быть идентификатор сообщения (-ов). taxonomy: устанавливает таксономию, содержащую термины, указанные в параметре terms = "". Значение по умолчанию: не задано. Может содержать только одно значение. Должен быть фрагментом таксономии. термины: устанавливает термины таксономии для фильтрации сообщений. Значение по умолчанию: не задано. Таксономия также должна быть указана в таксономии. Несколько терминов можно указать через запятую:,. Должен быть кратким обозначением термина (ов). Таксономия параметров терминов: устанавливает таксономию для отображения терминов в списке. Значение по умолчанию: не задано. Несколько таксономий можно указать через запятую:,. Должен быть фрагментом таксономии. термины: устанавливает термины таксономии для включения в список. Значение по умолчанию: не задано. Таксономия также должна быть указана в таксономии. Несколько терминов можно указать через запятую:,. Должен быть идентификатор термина (ов). Не может использоваться с exclude-terms = "". exclude-terms: устанавливает условия, которые нужно исключить из отображения. Значение по умолчанию: не задано. Таксономия также должна быть указана в таксономии. Несколько терминов можно указать через запятую:,. Должен быть идентификатор термина (ов). Не может использоваться с terms = "". parent-term: установить родителя, от которого должны происходить все отображаемые термины. Значение по умолчанию: не задано. Может содержать только одно значение. Должен быть коротким словом родительского термина. Добавьте get-all-children = "yes", чтобы также включить всех потомков любой глубины ниже родительского термина. get-all-children: когда выбран родительский термин, этот параметр используется для отображения всех дочерних элементов любой глубины или только прямых дочерних элементов. Значение по умолчанию: false. Может содержать только одно значение. Должен иметь значение true, yes, on или 1, чтобы включать всех дочерних элементов любой глубины. Любое другое значение будет использовать поведение по умолчанию, показывающее только прямые дочерние элементы. hide-empty-terms: скрыть термины, с которыми не связаны сообщения. Значение по умолчанию: false. Может содержать только одно значение. Должно быть установлено значение true, yes, on или 1, чтобы скрыть пустые термины. Любое другое значение будет использовать поведение по умолчанию, показывающее все термины. Параметры внутреннего использования для полноты ** Их не нужно трогать, поскольку они предназначены только для внутреннего использования плагином ** цель: цель по умолчанию для списка, в котором не отображаются никакие элементы. Значение по умолчанию: не задано. Может содержать только одно значение. Должен быть установлен на URL-адрес, который будет использоваться в качестве цели для гиперссылок писем. return: какой тип листинга отображать, листинг или буквы. Значение по умолчанию: листинг. Может содержать только одно значение. Должен быть установлен либо список, чтобы отображать представление по умолчанию, либо буквы, чтобы отображать только буквы без каких-либо элементов (сообщений или терминов). Краткое содержание PHP Где $ query является одним из следующих: любой допустимый массив параметров WP_Query - объект WP_Query, сформированный из new WP_Query (); любой допустимый массив параметров get_pages (). Этот массив должен включать ключ child_of или родительский ключ, чтобы сообщить плагину, что это запрос get_pages () - единственная строка, содержащая таксономию, которая переключит листинг для отображения терминов из этой таксономии вместо сообщений. Справочная информация Полная документация по API доступна по адресу Справочник по списку AZ. Вывод в несколько столбцов. Размещение в несколько столбцов используется по умолчанию на широких экранах. Группа элементов письма должна содержать не менее 15 элементов для создания двух или более столбцов. Это сделано для обеспечения более эстетичного вида, когда список короткий и содержит всего несколько элементов. Шаблоны и темы Подключаемый модуль позволяет владельцу сайта, разработчику или разработчику предоставлять пользовательские шаблоны для вывода списка АЗ. ПРИМЕЧАНИЕ. Эти функции изменили имя и метод доступа в 1.0.0. Мы удалили моникер _a_z_ в имени функции, а в файле шаблона доступ к ним осуществляется через объект $ a_z_listing. Прежние имена функций по-прежнему доступны, но в значительной степени устарели. Чтобы добавить шаблон в свою тему, вам понадобится файл, аналогичный файлу templates / az -isting.php в папке плагина. Ваша копия должна быть размещена в вашей теме в корневом каталоге темы и называться az -isting.php или az -isting-section.php (где -section - необязательный ярлык страницы верхнего уровня для функции таргетинга на разделы). Цикл Система тем, которую реализует этот плагин, очень похожа на стандартный цикл WordPress с некоторыми добавленными битами. Важные функции, которые следует использовать в вашем шаблоне, следующие: $ a_z_query-> the_letters () печатает полный алфавит и связывает письма, которые имеют сообщения, с их разделами на странице индекса. $ a_z_query-> have_letters () возвращает истину или ложь в зависимости от того, остались ли какие-либо буквы для прохождения цикла. Это часть петли письма. $ a_z_query-> have_items () ведет себя очень похоже на функцию have_posts () ядра. Это часть цикла предметов. $ a_z_query-> the_letter () аналогично the_post () Core, это настроит следующую итерацию петли письма AZ Listing. Это должно обернуть цикл предметов. $ a_z_query-> the_item () аналогично the_post () Core, это настроит следующую итерацию цикла элементов списка AZ, так же, как работает обычный цикл WordPress. Это должно быть в пределах петли письма. Когда вы находитесь в цикле элементов, вы можете использовать все встроенные функции WordPress Core, связанные с публикациями, такие как the_content (). Обратите внимание, что заголовки и постоянные ссылки имеют вспомогательные функции, чтобы справиться с листингом AZ, показывающим термины таксономии (см. Следующий раздел). Я советую вам начать с копии шаблона шаблона по умолчанию при настройке вашей собственной версии. Поставляемые шаблоны показывают использование большинства функций, которые предоставляет этот плагин. Вспомогательные функции Плагин поддерживает отображение терминов таксономии, как если бы каждый термин был сообщением. Это означает, что функции WordPress, связанные с сообщениями, такими как the_title () и the_permalink (), ненадежны. Поэтому мы добавили вспомогательные функции, которые будут возвращать или печатать правильный вывод для элемента. ПРИМЕЧАНИЕ. Эти функции изменили имя и метод доступа в 1.0.0. Мы удалили моникер a_z в имени функции, а в файле шаблона доступ к ним осуществляется через объект $ a_z_listing. Предыдущие имена функций по-прежнему доступны, но в значительной степени устарели. Эти вспомогательные функции справляются с двойным использованием плагина, поддерживающего списки как на основе WP_Query (возвращение объектов WP_Post), так и терминов таксономии (возвращение объектов WP_Term). Это: $ a_z_query-> the_title () - печатает заголовок текущего элемента $ a_z_query-> get_the_title () возвращает заголовок текущего элемента, но не печатает его напрямую $ a_z_query-> the_permalink () печатает постоянную ссылку текущего элемента $ a_z_query-> get_the_permalink () возвращает постоянную ссылку текущего элемента, но не печатает ее напрямую

Автор: Daniel Llewellyn

Версия: 3.1.2

Последнее обновление: 2021-01-03 4:02pm GMT