Taxonomy Images

Отображение ваших изображений в вашей теме Есть несколько фильтров, которые вы можете использовать в своей теме для отображения ассоциаций изображений, созданных этим плагином. Пожалуйста, прочтите ниже для получения подробной информации. Отображение одного изображения, представляющего архив терминов. Следующий фильтр отобразит изображение, связанное с термином, запрошенным в строке запроса URL. Этот фильтр работает только в представлениях, которые естественно используют шаблоны, такие как category.php, tag.php, taxonomy.php и все их производные. Пожалуйста, прочтите об иерархии шаблонов для получения дополнительной информации об этих шаблонах. Самый простой вариант использования этого фильтра выглядит так: print apply_filters ('таксономия-изображения-запрос-термин-изображение', ''); Этот код сгенерирует и распечатает тег изображения. Его вывод можно изменить, передав необязательный третий параметр в apply_filters (). Этот параметр является массивом, и могут быть установлены следующие ключи: after (строка) - текст, добавляемый в HTML-код изображения. attr (массив) - пары ключ / значение, представляющие атрибуты тега img. Доступные варианты: alt, class, src и title. Этот массив будет передан в качестве четвертого параметра основной функции WordPress wp_get_attachment_image () без изменений. before (строка) - текст, добавляемый в HTML-код изображения. image_size (строка) - может быть любой размер изображения, зарегистрированный в WordPress. Если размер изображения не указан, по умолчанию будет использоваться «эскиз». Если указан незарегистрированный размер, этот фильтр вернет пустую строку. Вот пример того, как может выглядеть полностью настроенная версия этого фильтра: print apply_filters ('taxonomy-images-queried-term-image', '', array ('attr' => array ('alt' => 'Custom альтернативный текст ',' class '=>' my-class-list bunnies turtles ',' src '=>' this-is-where-the-image-live.png ',' title '=>' Custom Title ', ), 'before' => '', 'image_size' => 'medium')); Аналогичная функциональность Если вам просто нужно получить идентификатор базы данных для изображения, вы можете использовать: $ image_id = apply_filters ('taxonomy-images-queried-term-image-id', 0); Если вам нужно получить полный объект изображения, вы можете использовать: $ image = apply_filters ('taxonomy-images-queried-term-image-object', ''); Если вам нужно получить URL-адрес изображения, вы можете использовать следующее: $ image_url = apply_filters ('taxonomy-images-queried-term-image-url', ''); Вы можете указать размер изображения в третьем параметре опции: $ image_url = apply_filters ('taxonomy-images-queried-term-image-url', '', array ('image_size' => 'medium')); Если вам нужны данные об изображении, вы можете использовать: $ image_data = apply_filters ('taxonomy-images-queried-term-image-data', ''); Вы можете указать размер изображения в третьем параметре опции: $ image_data = apply_filters ('taxonomy-images-queried-term-image-data', '', array ('image_size' => 'medium')); Список изображений терминов, связанных с объектом публикации. При отображении публикации вы можете захотеть отобразить изображения, связанные со всеми терминами, связанными с публикацией. Это делает фильтр taxonomy-images-list-the-terms. Вот как это выглядит в простейшей форме: print apply_filters ('taxonomy-images-list-the-terms', ''); Этот фильтр принимает необязательный третий параметр, который можно использовать для настройки его вывода. Это массив, который распознает следующие ключи: after (строка) - текст для добавления к выводу. Значение по умолчанию - закрывающий тег неупорядоченного списка. after_image (строка) - Текст для добавления к каждому изображению. Значение по умолчанию - закрывающий тег элемента списка. before (строка) - текст, добавляемый в начало вывода. Значение по умолчанию - это тег открытого неупорядоченного списка с атрибутом класса «таксономия-изображения-термины». before_image (строка) - текст, добавляемый к каждому изображению. Значение по умолчанию - открытый тег элемента списка. image_size (строка) - Любой зарегистрированный размер изображения. Значения будут отличаться от установки к установке. Размеры изображения, определенные в ядре, включают: «эскиз», «средний» и «большой». «Полный» также может использоваться для получения загруженного немодифицированного изображения. По умолчанию - «эскиз». post_id (int) - сообщение, из которого нужно получить термины. По умолчанию используется свойство ID глобального объекта $ post. taxonomy (строка) - Имя зарегистрированной таксономии, из которой нужно вернуть термины. По умолчанию категория. Вот пример того, как может выглядеть полностью настроенная версия этого фильтра: print apply_filters ('taxonomy-images-list-the-terms', '', array ('before' => ' ',' before_image '=>' ',' after_image '=>' ',' image_size '=>' подробно ',' post_id '=> 1234,' taxonomy '=>' post_tag ',)); Работа со всеми терминами данной таксономии Вы можете использовать фильтр taxonomy-images-get-terms. Этот фильтр по сути является оболочкой для основной функции WordPress get_terms (). Он вернет массив расширенных объектов терминов: каждый объект термина будет иметь настраиваемое свойство с именем image_id, которое является целым числом, представляющим идентификатор базы данных изображения, связанного с термином. Этот фильтр можно использовать для создания настраиваемых списков терминов. Вот как выглядит его использование по умолчанию: $ terms = apply_filters ('taxonomy-images-get-terms', ''); Вот что может вернуть функция php print_r (): Array ([0] => stdClass Object ([term_id] => 8 [name] => Pirate [slug] => pirate [term_group] => 0 [term_taxonomy_id] => 8 [taxonomy] => category [description] => Пираты живут в океане и катаются на лодках. [Parent] => 0 [count] => 1 [image_id] => 44)) Как видите, все преимущества get_terms () заключаются в дополнительном бонусе: параметре image_id! Этот фильтр распознает необязательный третий параметр, который представляет собой массив аргументов, которые можно использовать для изменения его вывода: cache_images (bool) Если это значение истинно, все связанные изображения будут запрошены и кэшированы для последующего использования в различных тегах шаблона. Если установлено значение false, этот запрос будет подавлен. Не устанавливайте для этого значения значение false, если у вас нет действительно веской причины для этого 🙂 Значение по умолчанию - true. have_images (bool) Если это значение истинно, будут возвращены только термины, связанные с изображениями. Установка значения false вернет все термины. Значение по умолчанию - истина. taxonomy (строка) Имя зарегистрированной таксономии, из которой нужно вернуть термины. Можно указать несколько таксономий, разделив каждое имя запятой. По умолчанию категория. term_args (array) Аргументы, передаваемые в get_terms () в качестве второго параметра. Значение по умолчанию - пустой массив. Вот пример простого настраиваемого цикла, который можно использовать для отображения всех изображений терминов: $ terms = apply_filters ('taxonomy-images-get-terms', ''); если (! пусто ($ условия)) {печать '

'; foreach ((массив) $ terms as $ term) {print '
• '. wp_get_attachment_image ($ term-> image_id, 'деталь'). '
'; } печать '

'; } Поддержка Если у вас есть вопросы по интеграции этого плагина на ваш сайт, добавьте новую тему на форум поддержки WordPress. Я пытаюсь ответить на них, но не всегда могу. В том случае, если я не могу этого сделать, может быть кто-то другой, кто сможет помочь. Ошибки, предложения Разработка этого плагина размещена в публичном репозитории на Github. Если вы обнаружите ошибку в этом плагине или у вас есть предложение по его улучшению, создайте новый выпуск. Подключите его! Если вы влюбились в этот плагин и не можете уснуть, не помогая каким-либо образом, просмотрите следующий список способов его подключения !: Оцените! - Используйте звездочку на правой боковой панели главной страницы плагина. Сообщите мне, работает ли это - используйте виджет совместимости на домашней странице плагина, чтобы сообщить всем, что текущая версия работает с вашей версией WordPress. Ты Твиттер? Помогите продвижению с помощью этой короткой ссылки: http://bit.ly/taxonomy-images Вы писатель? Помогите продвижению, написав на своем сайте статью об этом плагине. Нужны дополнительные плагины таксономии? Первоначальный автор этого плагина Майкл Филдс выпустил несколько плагинов, связанных с таксономиями. Пожалуйста, посмотрите его профиль WordPress.org для получения дополнительной информации.

Автор: Michael Fields, Ben Huson

Версия: 1.0

Последнее обновление: 2019-06-20 8:21am GMT