Advertisement
  1. Code
  2. WordPress
  3. Plugin Development

Отображение категорий, подкатегорий и продуктов WooCommerce в отдельных списках

Scroll to top

() translation by (you can also view the original English article)

Final product imageFinal product imageFinal product image
What You'll Be Creating

WooCommerce дает вам несколько вариантов того, что вы можете отображать на своих страницах коллекций:

  • продукты
  • категории (на главной странице магазина) или подкатегории (на страницах категорий)
  • как продуктов, так и категорий.

Когда я настраиваю магазин, я обычно выбираю третий вариант: продукты и категории/подкатегории. Это означает, что посетители моего магазина могут выбирать продукты прямо с домашней страницы или уточнять их поиск, перейдя в коллекцию категории продуктов.

Тем не менее, есть одна причина отказаться от этого подхода: он отображает категории/подкатегории вместе, без разделения между ними. Это означает, что если ваши изображения продукта имеют разные размеры , макет может выглядеть немного грязным. Даже если ваши изображения имеют одинаковый размер, если одна из строк на странице коллекции включает в себя как категории, так и продукты, отсутствие кнопки «Добавить в корзину» для категорий делает эту строку неопрятной, поскольку не все ее элементы имеют одинаковые размеры.

В этом уроке я покажу вам, как показывать категории в отдельном списке перед отображением продуктов.

Чтобы сделать это, мы выполним четыре шага:

  1. Определите код, используемый WooCommerce для вывода категорий и подкатегорий на странице коллекции.
  2. Создайте плагин для нашего кода.
  3. Напишите функцию для размещения категорий или подкатегорий перед списками продуктов.
  4. Стиль вывода.

Но прежде чем вы начнете, вам понадобится установка WooCommerce с добавлением продуктов, а также настройки категорий продуктов и подкатегорий.

Что вам понадобится

Чтобы двигаться дальше, вам понадобятся:

  • Установка WordPress для разработки.
  • Редактор кода.
  • Установка и активация WooCommerce.
  • Добавленные продукты: я импортировал данные фиктивного продукта, которые поставляются с WooCommerce; для получения подробной информации о том, как это сделать, см. это руководство.
  • Активная совместимая с WooCommerce тема - я использую Storefront.

Перед началом работы: параметры по умолчанию

Давайте посмотрим, что WooCommerce дает нам по умолчанию.

Я начал с добавления некоторых изображений в категории товаров и подкатегории, поскольку фиктивные данные WooCommerce не включают их. Я просто использовал изображение одного из продуктов из каждой категории или подкатегории, как вы можете видеть на скриншоте:

Product categories screen in WordPress admin with category images addedProduct categories screen in WordPress admin with category images addedProduct categories screen in WordPress admin with category images added

Теперь давайте посмотрим, как WooCommerce отображает категории продуктов и продукты на страницах коллекций.

Если вы еще этого не сделали, перейдите в WooCommerce > Settings, выберите вкладку Products, а затем выберите опцию Display. Для каждого из параметров Shop Page Display и Default Category Display выберите Show both:

WooCommerce product display settings screenWooCommerce product display settings screenWooCommerce product display settings screen

Нажмите кнопку Save changes, чтобы сохранить настройки и перейти на страницу магазина вашего сайта. Мой результат выглядит так:

The main shop page without any changesThe main shop page without any changesThe main shop page without any changes

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

The Music category archive page without any changesThe Music category archive page without any changesThe Music category archive page without any changes

Поскольку эта категория имеет две подкатегории, первый продукт отображается вместе с ними, в сетке три элемента. Я хочу сделать мои категории и подкатегории более заметными и просто представить их отдельно от списков продуктов. Так что давайте сделаем это.

Идентификация кода WooCommerce использующего выходные категории и продукты в коллекции

Первый шаг - определить, как WooCommerce выводит категории и подкатегории. Итак, давайте углубиться в исходный код WooCommerce, чтобы найти соответствующую функцию.

Файл WooCommerce использует для отображения страниц коллекций archive-product.php, который находится в папке templates.

Внутри этого файла вы можете найти код, который выводит категории и продукты:

1
<?php
2
    /**

3
   * woocommerce_before_shop_loop hook

4
	 *

5
	 * @hooked woocommerce_result_count - 20

6
	 * @hooked woocommerce_catalog_ordering - 30

7
	*/
8
	do_action( 'woocommerce_before_shop_loop' );
9
?>
10
11
<?php woocommerce_product_loop_start(); ?>
12
13
    <?php woocommerce_product_subcategories(); ?>
14
15
	<?php while ( have_posts() ) : the_post(); ?>
16
17
		<?php wc_get_template_part( 'content', 'product' ); ?>
18
19
	<?php endwhile; // end of the loop. ?>

20
21
<?php woocommerce_product_loop_end(); ?>

Таким образом, определенна функция woocommerce_product_subcategories(), которая выводит категории или подкатегории перед запуском цикла, который выводит продукты.

Функция подключаемая, что означает, что мы можем переопределить ее в нашей теме. К сожалению, это не совсем так, поскольку WooCommerce имеет встроенный стиль для очистки элементов, который будет отображаться в начале строки с отображением по умолчанию.

Поэтому вместо этого мы отключим отображение категорий и подкатегорий на наших страницах коллекций, чтобы отображались только продукты. Затем мы создадим новую функцию, которая выводит категории товаров или подкатегории, и подключаем их к экшену woocommerce_before_shop_loop, убедившись, что мы используем высокий приоритет, чтобы он срабатывал после функций, которые уже подключены к этому экшену.

Примечание: поскольку WooCommerce добавляет очищения к каждому третьему списку продуктов, мы не можем использовать функцию woocommerce_product_subcategories() или отредактированную ее версию для отображения категорий. Это связано с тем, что он очистит третью, шестую (и т. д.) категорию или продукт, даже если мы используем эту функцию для отображения категорий отдельно. Мы могли бы попытаться переопределить это, но проще просто написать нашу собственную функцию.

Итак, давайте создадим плагин, который сделает это.

Создание плагина

Создайте в вашем каталоге wp-content/plugins новую папку и дайте ей уникальное имя. Я называю tutsplus-separate-products-categories-in-archives. Внутри создайте новый файл, также с уникальным именем. Я использую то же имя: tutsplus-separate-products-categories-in-archives.php.

Откройте файл и добавьте к нему этот код:

1
<?php
2
/**

3
 * Plugin Name: Tutsplus display WooCommerce products and categories/subcategories separately in archive pages

4
 * Plugin URI: https://code.tutsplus.com/tutorials/woocommerce-display-product-categories-subcategories-and-products-in-two-separate-lists--cms-25479

5
 * Description: Display products and catgeories / subcategories as two separate lists in product archive pages

6
 * Version: 1.0

7
 * Author: Rachel McCollin

8
 * Author URI: http://rachelmccollin.co.uk

9
 *

10
 *

11
 */

Возможно, вы захотите отредактировать данные автора, так как это ваш плагин, который вы пишете. Сохраните файл и активируйте плагин через администратор WordPress.

Написание нашей функции

Теперь давайте напишем функцию. Но прежде чем начать, отключите списки категорий на экранах администратора. Перейдите в WooCommerce > Settings, выберите вкладку Products, а затем выберите параметр Display. Для каждого из Shop Page Display и Default Category Display выберите Show products. Сохраните изменения.

Теперь ваша страница магазина будет выглядеть примерно так:

The main shop page with just products displayedThe main shop page with just products displayedThe main shop page with just products displayed

В своем файле плагина добавьте следующее:

1
function tutsplus_product_subcategories( $args = array() ) {
2
    
3
	}
4
}
5
add_action( 'woocommerce_before_shop_loop', 'tutsplus_product_subcategories', 50 );

Теперь добавьте этот код внутри функции:

1
$parentid = get_queried_object_id();
2
    	
3
$args = array(
4
	'parent' => $parentid
5
);
6
7
$terms = get_terms( 'product_cat', $args );
8
9
if ( $terms ) {
10
		
11
	echo '<ul class="product-cats">';
12
	
13
		foreach ( $terms as $term ) {
14
						
15
			echo '<li class="category">';					
16
					
17
				woocommerce_subcategory_thumbnail( $term );
18
				
19
				echo '<h2>';
20
					echo '<a href="' .  esc_url( get_term_link( $term ) ) . '" class="' . $term->slug . '">';
21
						echo $term->name;
22
					echo '</a>';
23
				echo '</h2>';
24
																	
25
			echo '</li>';
26
																	
27
28
	}
29
	
30
	echo '</ul>';
31
32
}

Давайте посмотрим, что делает эта функция:

  • Она идентифицирует текущий запрошенный объект и определяет его id как $parentid.
  • Она использует get_terms() для определения условий с текущим запрошенным элементом в качестве родителя. Если это главная страница магазина, она вернет категории верхнего уровня; если это коллекция категории, она вернет подкатегории.
  • Затем она проверяет наличие каких-либо условий, прежде чем открывать цикл foreach и элемент ul.
  • Для каждого условия она создает элемент li, а затем выводит изображение категории с помощью woocommerce_subcatgeory_thumbnail(), за которым следует название категории в ссылке на ее коллекцию.

Теперь сохраните файл и обновите главную страницу  магазина. У меня выглядит так:

Main shop page - categories are separate but too big and with list styling bullets etcMain shop page - categories are separate but too big and with list styling bullets etcMain shop page - categories are separate but too big and with list styling bullets etc

Отображаются категории, но им нужен стиль. Давайте следующим сделаем это.

Стилизация списков категорий

Чтобы мы могли добавить стиль, нам нужна таблица стилей внутри нашего плагина, которую нам нужно будет поставить в очередь.

В своей папке плагина создайте папку css и внутри нее создайте файл с именем style.css.

Теперь, в вашем файле плагина, добавьте это выше функции, которую вы уже создали:

1
function tutsplus_product_cats_css() {
2
3
    /* register the stylesheet */
4
    wp_register_style( 'tutsplus_product_cats_css', plugins_url( 'css/style.css', __FILE__ ) );
5
    
6
    /* enqueue the stylsheet */
7
    wp_enqueue_style( 'tutsplus_product_cats_css' );
8
    
9
}
10
11
add_action( 'wp_enqueue_scripts', 'tutsplus_product_cats_css' );

Это правильно помещает таблицу стилей, которую вы только что создали.

Теперь откройте таблицу стилей и добавьте код ниже. WooCommerce использует сперва мобильный стиль, поэтому мы тоже будем его использовать.

1
ul.product-cats li {
2
    list-style: none;
3
	margin-left: 0;
4
	margin-bottom: 4.236em;
5
	text-align: center;
6
	position: relative;
7
}
8
ul.product-cats li img {
9
	margin: 0 auto;	
10
}
11
12
@media screen and (min-width:768px) {
13
14
	ul.product-cats {
15
		margin-left: 0;
16
		clear: both;
17
	}
18
	ul.product-cats li {
19
		width: 29.4117647059%;
20
		float: left;
21
		margin-right: 5.8823529412%;
22
	}
23
	ul.product-cats li:nth-of-type(3) {
24
		margin-right: 0;
25
	}
26
	
27
}

Я скопировал точные ширины и отступы из стиля, используемого WooCommerce.

Теперь проверьте свою главную страницу магазина. Вот моя:

The main shop page Categories are above products and styled consistently in a gridThe main shop page Categories are above products and styled consistently in a gridThe main shop page Categories are above products and styled consistently in a grid

Вот коллекция категории Music:

The Music archive Two subcategories are above the 3 wide grid of productsThe Music archive Two subcategories are above the 3 wide grid of productsThe Music archive Two subcategories are above the 3 wide grid of products

И вот как это выглядит на маленьких экранах:

The categories on narrower screens full width not in a gridThe categories on narrower screens full width not in a gridThe categories on narrower screens full width not in a grid

Резюме

Категории продуктов - отличная функция WooCommerce, но способ отображения не всегда идеален. В этом уроке вы узнали, как создать плагин, который выводит категории продуктов или подкатегории отдельно из списков продуктов, а затем вы ввели списки категорий.

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

Если вы в настоящее время запускаете магазин, который хотите расширить, или вы ищете дополнительные плагины для изучения, связанные с WooCommerce, не стесняйтесь посмотреть, какие плагины доступны на Envato Market.

Advertisement
Did you find this post useful?
Want a weekly email summary?
Subscribe below and we’ll send you a weekly email summary of all new Code tutorials. Never miss out on learning about the next big thing.
Advertisement
Looking for something to help kick start your next project?
Envato Market has a range of items for sale to help get you started.