WordPress как на ладони
Недорогой хостинг для сайтов на WordPress: wordpress.jino.ru Шаблоны сайтов на русском

Миниатюры для элементов таксономий

В этой заметке я поделюсь готовым кодом, который добавляет возможность задавать миниатюры для элементов таксономий, как встроенных (метки, рубрики), так и произвольных. Код протестирован и 7 раз улучшен - все для вас, мои дорогие smile

Чтобы добавить, или загрузить и добавить, или изменить картинку элемента таксономии, нужно кликнуть на саму картинку - она по совместительству является кнопкой. При загрузке открывается стандартное окно медиафайлов и картинка загружается в медиатеку WordPress. Но в отличии от картинок записей, она не привязывается к термину - она не привязывается ни к чему и это минус. Ну, пока так.

По умолчанию код работает для всех публичных таксономий (рубрики, метки и существующие произвольные таксономии). В коде можно указать конкретные таксы для которых он должен работать.

Вот что мы получим в итоге:

В сети много старых и некачественных пособий по этой теме. В некоторых из них данные сохраняются в таблицу опций, а не в метаполя. Напомню, что метаполя для элементов таксономий появились с версии WP 4.4 и все данные терминов, нужно сохранять именно туда, потому что это правильно и удобно.

Код

Можно сделать плагин или можно добавить его в functions.php темы.

<?php

/**
 * Возможность загружать изображения для терминов (элементов таксономий: категории, метки).
 *
 * Пример получения ID и URL картинки термина:
 *     $image_id = get_term_meta( $term_id, '_thumbnail_id', 1 );
 *     $image_url = wp_get_attachment_image_url( $image_id, 'thumbnail' );
 *
 * @author: Kama http://wp-kama.ru
 *
 * @version 2.9
 */
if( is_admin() && ! class_exists('Term_Meta_Image') ){

	// init
	//add_action('current_screen', 'Term_Meta_Image_init');
	add_action( 'admin_init', 'Term_Meta_Image_init' );
	function Term_Meta_Image_init(){
		$GLOBALS['Term_Meta_Image'] = new Term_Meta_Image();
	}

	class Term_Meta_Image {

		// для каких таксономий включить код. По умолчанию для всех публичных
		static $taxes = []; // пример: array('category', 'post_tag');

		// название мета ключа
		static $meta_key = '_thumbnail_id';
		static $attach_term_meta_key = 'img_term';

		// URL пустой картинки
		static $add_img_url = 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAGQAAABkAQMAAABKLAcXAAAABlBMVEUAAAC7u7s37rVJAAAAAXRSTlMAQObYZgAAACJJREFUOMtjGAV0BvL/G0YMr/4/CDwY0rzBFJ704o0CWgMAvyaRh+c6m54AAAAASUVORK5CYII=';

		public function __construct(){
			// once
			if( isset($GLOBALS['Term_Meta_Image']) )
				return $GLOBALS['Term_Meta_Image'];

			$taxes = self::$taxes ? self::$taxes : get_taxonomies( [ 'public' =>true ], 'names' );

			foreach( $taxes as $taxname ){
				add_action( "{$taxname}_add_form_fields",   [ $this, 'add_term_image' ],     10, 2 );
				add_action( "{$taxname}_edit_form_fields",  [ $this, 'update_term_image' ],  10, 2 );
				add_action( "created_{$taxname}",           [ $this, 'save_term_image' ],    10, 2 );
				add_action( "edited_{$taxname}",            [ $this, 'updated_term_image' ], 10, 2 );

				add_filter( "manage_edit-{$taxname}_columns",  [ $this, 'add_image_column' ] );
				add_filter( "manage_{$taxname}_custom_column", [ $this, 'fill_image_column' ], 10, 3 );
			}
		}

		## поля при создании термина
		public function add_term_image( $taxonomy ){
			wp_enqueue_media(); // подключим стили медиа, если их нет

			add_action('admin_print_footer_scripts', [ $this, 'add_script' ], 99 );
			$this->css();
			?>
			<div class="form-field term-group">
				<label><?php _e('Image', 'default'); ?></label>
				<div class="term__image__wrapper">
					<a class="termeta_img_button" href="#">
						<img src="<?php echo self::$add_img_url ?>" alt="">
					</a>
					<input type="button" class="button button-secondary termeta_img_remove" value="<?php _e( 'Remove', 'default' ); ?>" />
				</div>

				<input type="hidden" id="term_imgid" name="term_imgid" value="">
			</div>
			<?php
		}

		## поля при редактировании термина
		public function update_term_image( $term, $taxonomy ){
			wp_enqueue_media(); // подключим стили медиа, если их нет

			add_action('admin_print_footer_scripts', [ $this, 'add_script' ], 99 );

			$image_id = get_term_meta( $term->term_id, self::$meta_key, true );
			$image_url = $image_id ? wp_get_attachment_image_url( $image_id, 'thumbnail' ) : self::$add_img_url;
			$this->css();
			?>
			<tr class="form-field term-group-wrap">
				<th scope="row"><?php _e( 'Image', 'default' ); ?></th>
				<td>
					<div class="term__image__wrapper">
						<a class="termeta_img_button" href="#">
							<?php echo '<img src="'. $image_url .'" alt="">'; ?>
						</a>
						<input type="button" class="button button-secondary termeta_img_remove" value="<?php _e( 'Remove', 'default' ); ?>" />
					</div>

					<input type="hidden" id="term_imgid" name="term_imgid" value="<?php echo $image_id; ?>">
				</td>
			</tr>
			<?php
		}

		public function css(){
			?>
			<style>
				.termeta_img_button{ display:inline-block; margin-right:1em; }
				.termeta_img_button img{ display:block; float:left; margin:0; padding:0; min-width:100px; max-width:150px; height:auto; background:rgba(0,0,0,.07); }
				.termeta_img_button:hover img{ opacity:.8; }
				.termeta_img_button:after{ content:''; display:table; clear:both; }
			</style>
			<?php
		}

		## Add script
		public function add_script(){
			// выходим если не на нужной странице таксономии
			//$cs = get_current_screen();
			//if( ! in_array($cs->base, array('edit-tags','term')) || ! in_array($cs->taxonomy, (array) $this->for_taxes) )
			//  return;

			$title = __('Featured Image', 'default');
			$button_txt = __('Set featured image', 'default');
			?>
			<script>
			jQuery(document).ready(function($){
				var frame,
					$imgwrap = $('.term__image__wrapper'),
					$imgid   = $('#term_imgid');

				// добавление
				$('.termeta_img_button').click( function(ev){
					ev.preventDefault();

					if( frame ){ frame.open(); return; }

					// задаем media frame
					frame = wp.media.frames.questImgAdd = wp.media({
						states: [
							new wp.media.controller.Library({
								title:    '<?php echo $title ?>',
								library:   wp.media.query({ type: 'image' }),
								multiple: false,
								//date:   false
							})
						],
						button: {
							text: '<?php echo $button_txt ?>', // Set the text of the button.
						}
					});

					// выбор
					frame.on('select', function(){
						var selected = frame.state().get('selection').first().toJSON();
						if( selected ){
							$imgid.val( selected.id );
							$imgwrap.find('img').attr('src', selected.sizes.thumbnail.url );
						}
					} );

					// открываем
					frame.on('open', function(){
						if( $imgid.val() ) frame.state().get('selection').add( wp.media.attachment( $imgid.val() ) );
					});

					frame.open();
				});

				// удаление
				$('.termeta_img_remove').click(function(){
					$imgid.val('');
					$imgwrap.find('img').attr('src','<?php echo self::$add_img_url ?>');
				});
			});
			</script>

			<?php
		}

		## Добавляет колонку картинки в таблицу терминов
		public function add_image_column( $columns ){
			// fix column width
			add_action( 'admin_notices', function(){
				echo '<style>.column-image{ width:50px; text-align:center; }</style>';
			});

			// column without name
			return array_slice( $columns, 0, 1 ) + [ 'image' =>'' ] + $columns;
		}

		public function fill_image_column( $string, $column_name, $term_id ){
			if( $image_id = get_term_meta( $term_id, self::$meta_key, 1 ) ){
				$string = '<img src="'. wp_get_attachment_image_url( $image_id, 'thumbnail' ) .'" width="50" height="50" alt="" style="border-radius:4px;" />';
			}

			return $string;
		}

		## Save the form field
		public function save_term_image( $term_id, $tt_id ){
			if( isset($_POST['term_imgid']) && $attach_id = (int) $_POST['term_imgid'] ){
				update_term_meta( $term_id,   self::$meta_key,             $attach_id );
				update_post_meta( $attach_id, self::$attach_term_meta_key, $term_id );
			}
		}

		## Update the form field value
		public function updated_term_image( $term_id, $tt_id ){
			if( ! isset($_POST['term_imgid']) )
				return;

			$cur_term_attach_id = (int) get_term_meta( $term_id, self::$meta_key, 1 );

			if( $attach_id = (int) $_POST['term_imgid'] ){
				update_term_meta( $term_id,   self::$meta_key,             $attach_id );
				update_post_meta( $attach_id, self::$attach_term_meta_key, $term_id );

				if( $cur_term_attach_id != $attach_id )
					wp_delete_attachment( $cur_term_attach_id );
			}
			else {
				if( $cur_term_attach_id )
					wp_delete_attachment( $cur_term_attach_id );

				delete_term_meta( $term_id, self::$meta_key );
			}
		}

	}

}
/**
 * 2.9 Добавил метаполе для вложений (img_term), где хранится ID термина к которому прикреплено вложение.
 *     Добавил физическое удаление картинки (файла вложения) при удалении его у термина.
 * 2.8 Исправил ошибку удаления картинки.
 */

Вывод картинки элемента таксономии во фронтенде

Бэкграунд для добавления картинки у нас есть, теперь осталось понять как получать такие картинки терминов в лицевой части сайта.

Делается это через родную функцию WordPress get_term_meta(), которая напомню еще раз существует с версии 4.4.

ID картинок (вложений) сохраняется в метаполе термина _thumbnail_id, его и будем получать.

// получаем ID термина на странице термина
$term_id = get_queried_object_id();

// получим ID картинки из метаполя термина
$image_id = get_term_meta( $term_id, '_thumbnail_id', 1 );

// ссылка на полный размер картинки по ID вложения
$image_url = wp_get_attachment_image_url( $image_id, 'full' );

// выводим картинку на экран
echo '<img src="'. $image_url .'" alt="" />';

Если нужен не полный размер меняем full на нужный размер в wp_get_attachment_image_url(). Если нужны другие данные картинки, используем другую функцию получения вложения по ID.

Плагины для вставки миниатюр таксономий

Не кодом единым жив программист - есть еще плагины:

  • Taxonomy Thumbnail - по коду все круто, только его там много. Поддержка версий WP до 4,4 (когда была добавлена таблица метаданных таксономий)...

  • WP Multiple Taxonomy Images - код плагина очень похож на код из этой статьи - его не много, только то что нужно. Фишка плагина в том, что он позволяет задать сразу несколько миниатюр для термина.

  • Taxonomy Images - самый рейтинговый плагин по этому вопросу. Плагин в целом неплохой, но кода много, «лишнего» много, кажется. Если лишнее не нужно, используйте лучше предыдущие плагины или код из этой статьи.
14 комментов
Полезные 2 Вопросы 4 Все
  • еще для категорий связка плагинов ACF + ACFCategories тоже сделает + дополнительные поля какие угодно.

    2
    Ответить2 года назад #
  • Владимир cайт: www.korvet2.ru

    Здравствуйте!
    Статья очень полезная и познавательная. Прочитал с большим интересом. У меня на блоге миниатюры выводятся у каждой статьи в разделе похожие записи, а также для страниц меток (TAG). Все работает хорошо, но есть вопрос. Миниатюры я создавал и прикреплял через админку. Каждую миниатюру делал строго нужного размера и минимального веса. При этом в админке создается миниатюра с адресом, например, хххх.png, а на странице блога выводится с адресом хххх 140х120.png 140х120 – это размеры миниатюры. Если посмотреть по FTP содержание папки миниатюр, то и там каждой миниатюре соответствует два файла с указанными адресами, но разного веса. Нужно ли это? Очень сильное подозрение, что я сделал что-то не так. Подскажите, пожалуйста, как должно быть и где искать?

    1
    Ответить2 года назад #
    • Kama7363

      Как могут в папке находится 2 файла с одинаковыми названиями? Может вторая картинка для ретина дисплеев? И при заливке создается еще и такая копия. Если это так, то нужно это или нет решать вам - наверное нет.

      Ответить2 года назад #
  • Вот еще хороший плагин отыскал, минимум кона и ничего лишнего. Работает со старыми и новыми версиями ВП. Добавляет произвольное поле, в которое встраивает ссылку на картинку.
    Плагин называется categories-images
    Ссылку в разделе рубрики выводит вот так
    echo z_taxonomy_image_url($cat->term_id, 'full');

    2
    Ответить1.5 года назад #
  • @ Иван cайт: zvooq-knigi.ru

    Здравствуйте, а как вывести произвольные теги с миниатюрами на любой странице? У меня книжный сайт и в тегах забиты авторы книг и я бы хотел вывести на главную страницу список тегов с миниатюрами

    Ответить11 мес назад #
    • @ Иван cайт: zvooq-knigi.ru

      Уже не надо, разобрался

      1
      Ответить11 мес назад #
  • @ Alex

    Добрый день!
    Пытаюсь внедрить ваш код....код добавил, все работает , миниатюры в таксономиях появились. Их можно подгрузить в ручную.
    Дальше возник вопрос, как можно подставить урл картинки сразу в базу данных, если в моем скрипте, таксономия в бд создается через tax_input и выглядит строка вот так

    $post["tax_input"]["city_category"] = $product_ex[0]->city;

    Больше интересует написание левой часть строки...
    должно быть что то получиться в виде этого ?

    $post["tax_input"]["city_category"]["image_url"] = "url";

    не уверен в правильности синтаксиса...
    Кто то может подсказать правильную конструкцию добавления term в "city_category" в виде урла с использованием "tax_input" ?

    Ответить3 мес назад #
  • @ Alex

    Добрый день!
    Подскажите, можно ли сделать инсерт урла картинки и связать его с вашим кодом с помощью функции wp_insert_term ?

    wp_insert_term('Example Category','category',array('description' => $url));

    $url - это внешняя ссылка на картинку.
    Будет работать ? Как можно реализовать это с ссылкой на картинку а не на медиа библиотеку ?

    Ответить3 мес назад #
  • @ Nik

    Как сделать чтоб разметка Open Graph подхватывала миниатюру, как в записях?

    Ответить3 мес назад #
  • Олег

    Здравствуйте! Спасибо за код.

    Есть проблема: При выборе другой миниатюры (в медиатеке) предыдущая удаляется.

    Ответитьмесяц назад #
    • Kama7363

      Тут можешь это удаление убрать, см. wp_delete_attachment():

                  if( $attach_id = (int) $_POST['term_imgid'] ){
      				update_term_meta( $term_id,   self::$meta_key,             $attach_id );
      				update_post_meta( $attach_id, self::$attach_term_meta_key, $term_id );
      
      				if( $cur_term_attach_id != $attach_id )
      					wp_delete_attachment( $cur_term_attach_id );
      			}
      			else {
      				if( $cur_term_attach_id )
      					wp_delete_attachment( $cur_term_attach_id );
      
      				delete_term_meta( $term_id, self::$meta_key );
      			}
      1
      Ответитьмесяц назад #
  • Никита

    Здравствуйте. Большое спасибо за код!
    Помогите пожалуйста - у меня не получается вывести картинку на лицевую часть экрана.
    В админке появилась возможность добавлять.
    Я вставляю этот код:

    <?php 
    // получаем ID термина на странице термина
    $term_id = get_queried_object_id();
    
    // получим ID картинки из метаполя термина
    $image_id = get_term_meta( $term_id, '_thumbnail_id', 1 );
    
    // ссылка на полный размер картинки по ID вложения
    $image_url = wp_get_attachment_image_url( $image_id, 'full' );
    
    // выводим картинку на экран
    echo '<img src="'. $image_url .'" alt="" />';  
    ?> 

    Что я делаю неправильно?

    Ответить28 дней назад #
Здравствуйте, !     Войти . Зарегистрироваться