Шорткоды WooCommerce

WooCommerce поставляется с несколькими шорткодами, которые могут быть использованы для вставки Контента внутри сообщений и страниц.

  • [woocommerce_cart] – показывает страницу корзины
  • [woocommerce_checkout] — показывает страницу оформления заказа
  • [woocommerce_my_account] – показывает страницу учетной записи пользователя
  • [woocommerce_order_tracking] — показывает форму отслеживания заказов

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

Страница Корзины

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

Аргументы: нет

Страница оформления заказа

Используемый на странице оформления заказа шорткод оформления заказа отображает процесс оформления заказа.

Аргументы: нет

Страница Мой аккаунт

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

Аргументы:

array(
     'current_user' => ''
 )

Форма Отслеживания Заказов

Позволяет пользователю просматривать статус заказа путем ввода сведений о заказе.

Аргументы: нет

Товары (Продукты)

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

Раздел [products] шорткод позволяет отображать товары по почте код, артикул, категории, атрибуты, с поддержкой разбиения на страницы, случайная сортировка и продукт теги, заменяя необходимость кратные короткие номера, такие как: , [featured_products], [sale_products], [best_selling_products], [recent_products], [product_attribute], и [top_rated_products], которые необходимы в версии плагина woocommerce ниже 3.2. Ознакомьтесь с приведенными ниже примерами.

Доступные Атрибуты Продукта

Следующие атрибуты доступны для использования в сочетании с шорткодом [products]. Они были разделены на разделы для основной функции для удобства навигации, с примерами ниже.

  • limit — количество отображаемых продуктов. По умолчанию 12 при перечислении продуктов, и -1 (Показать все) для категорий.
  • columns — количество отображаемых столбцов. По умолчанию 4.
  • paginate — включает / выключает пагинацию. Польза совместно с пределом. По умолчанию false значение True, чтобы вставить .
  • orderby — сортирует товары, отображаемые введенной опцией. Один или несколько вариантов могут быть переданы путем добавления обоих слизней с пробелом между ними. Доступные опции:
    • date — Дата публикации продукта.
    • id — идентификатор записи продукта.
    • menu_order — порядок меню, если установлен (сначала отображаются нижние номера).
      популярность – количество покупок.
    • rand — Рандомный заказ товаров при загрузке страницы (может не работать с сайтами, использующими кэширование, так как может сохранить определенный заказ).
    • rating — средний рейтинг товара.
    • title – название продукта. Это порядок по умолчанию по режиму.
  • skus – разделенный запятыми список наименований товара.
  • category -разделенный запятыми список  категории.
  • order – был ли заказ товара по возрастанию (ASC) или по убыванию (Desc), используя метод набора в порядке. По умолчанию ASC.
  • class — добавляет класс-оболочку HTML, так что вы можете изменить конкретные Выходные данные с помощью пользовательского CSS.
  • on_sale — получить в продажу продукты. Не должен быть использован в сочетании с best_selling top_rated.
  • best_selling — получить самые продаваемые продукты. Не использовать совместно с on_sale или top_rated.
  • top_rated — получить лучшие продукты. Не должен быть использован в сочетании с on_sale или best_selling.

Атрибуты Содержимого продукта

  • attribute — извлекает продукты с помощью указанного атрибута slug.
  • terms — разделенный запятыми список терминов атрибута, которые будут использоваться с атрибутом.
  • terms_operator — оператор для сравнения терминов атрибутов. Доступные опции:
    • AND — отобразит товары из всех выбранных атрибутов.
    • IN — отображает товары с выбранным атрибутом. Это значение terms_operator по умолчанию.
    • NOT IN — будут отображаться продукты, которых нет в выбранных атрибутах.
  • visibility — отображение продуктов на основе выбранной видимости. Доступные опции:
    • visible — продукты visibile на магазин и результаты поиска. Это параметр по умолчанию.
    • catalog — товары видны только в магазине, но не в результатах поиска.
    • search — товары видны только в результатах поиска, но не в магазине.
    • hidden — товары, которые скрыты как от магазина, так и от поиска, доступны только по прямым URL.
    • featured — продукты, которые отмечены как Рекомендуемые продукты.
  • category — Продукты повторных котегорий с использованием указанной категории slug.
  • cat_operator — оператор для сравнения терминов категорий. Доступные опции:
    • AND — отобразит товары, которые принадлежат ко всем выбранным категориям.
    • IN — отображает товары в выбранной категории. Это значение cat_operator по умолчанию.
    • NOT IN — будут отображаться товары, которые не входят в выбранную категорию.
  • ids — отображает продукты, основанные на списке идентификаторов записей, разделенных запятыми.
  • skus — отображает продукты, основанные на списке SKU, разделенном запятыми.

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

Специальные Атрибуты Продукта

Эти атрибуты нельзя использовать с «атрибутами содержимого», перечисленными выше, так как они могут вызвать конфликт и не отображаться. Следует использовать только один из следующих специальных атрибутов.

  • best_selling — покажет ваши самые продаваемые продукты. Должно быть установлено значение true.
  • on_sale — отобразит Ваши товары в продаже. Должно быть установлено значение true.

Категория продукта shortcodes

  • [product_category] — отображает продукты в указанной категории продуктов.
  • [product_categories] — отобразит все категории продуктов.

Примеры Сценариев Продукта

В следующих сценариях мы будем использовать пример магазина одежды.

Сценарий 1 — Случайные Продажи
Я хочу отобразить четыре случайных продукта.

[products limit="4" columns="4" orderby="popularity" class="quick-sale" on_sale="true" ]

 

Этот шорткод явно указывает четыре продукта с четырьмя столбцами (которые будут одной строкой), показывая самые популярные товары в продаже. Он также добавляет класс CSS quick-sale, который я могу изменить в своей теме.

Сценарий 2 — Рекомендуемые Продукты
Я хочу, чтобы показать мои рекомендуемые продукты, два в строке, с максимум четырех пунктов.

[products limit="4" columns="2" visibility="featured" ]

Этот шорткод говорит, что до четырех продуктов будут загружаться в двух столбцах. Хотя явно не указано, он использует значения по умолчанию, такие как сортировка по заголовку (от A до Z).

Сценарий 3 — Самые продаваемые продукты
Я хочу показать мои 3 верхних самых лучших продавая продукта в одной строке.

[products limit="3" columns="3" best_selling="true" ]

Сценарий 4 — Новейшие Продукты
Я хочу сначала отобразить новейшие продукты — четыре продукта в одном ряду. Для этого мы будем использовать Идентификатор Post (который генерируется при создании страницы продукта), а также команду order and orderby. Так как Вы не можете увидеть Идентификатор записи из интерфейса, ID#s были наложены на изображения.

[products limit="4" columns="4" orderby="id" order="DESC" visibility="visible"]

Сценарий 5 — Конкретные Категории
Я только хочу показать толстовки и рубашки, но не аксессуары. Я использую два ряда по четыре.

[products limit="8" columns="4" category="hoodies, tshirts" cat_operator="AND"]

Кроме того, я хочу отображать только продукты, не относящиеся к этим категориям. Все, что мне нужно изменить-это cat_operator  NOT IN.

[products limit="8" columns="4" category="hoodies, tshirts" cat_operator="NOT IN"]

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

Сценарий 6 – Отображение Атрибутов

Каждый из предметов одежды имеет атрибут, «Весна / Лето” или» Осень/Зима » в зависимости от соответствующего сезона, с некоторыми аксессуарами, имеющими оба, так как их можно носить круглый год. В этом примере, я хочу в три ряда, показывать все товары  “весны/лета”. Этот атрибут слизняк сезон, и атрибуты теплые и холодные. Я также хочу, чтобы они были отсортированы от новейших продуктов до самых старых.

[products columns="3" attribute="season" terms="warm" orderby="date"]

Кроме того, если я хочу отображать исключительно товары для холодной погоды, Я могу добавить NOT IN  в качестве моего terms_operator:

[products columns="3" attribute="season" terms="warm" terms_operator="NOT IN"]

Обратите внимание, что при использовании NOT IN, Я исключаю продукты, которые находятся в “весна/лето” и “осень/зима”. Если бы я хотел показать все соответствующее снаряжение холодной погоды, включая эти общие аксессуары, я бы изменил термин с warm на cold

Сценарий 7-Показать Категории Верхнего Уровня

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

[product_categories number="0" parent="0"]

Сортировка продуктов по настраиваемым Мета-полям

При использовании шорткода продуктов можно выбрать заказ продуктов по указанным выше предопределенным значениям. Вы также можете сортировать продукты по настраиваемым Мета-полям, используя приведенный ниже код (в этом примере мы заказываем продукт по цене):

add_filter( 'woocommerce_shortcode_products_query', 'woocommerce_shortcode_products_orderby' );

function woocommerce_shortcode_products_orderby( $args ) {

    $standard_array = array('menu_order','title','date','rand','id');

    if( isset( $args['orderby'] ) && !in_array( $args['orderby'], $standard_array ) ) {
        $args['meta_key'] = $args['orderby'];
        $args['orderby']  = 'meta_value_num'; 
    }

    return $args;
}

Этот фрагмент кода необходимо поместить в функции.php в папке темы, а затем настроить путем редактирования meta_key.

Страница продукта

Показать полный одной странице продукта по ID или SKU.

[product_page id="99"]
[product_page sku="FOO"]

Сопутствующие товары

Список сопутствующих товаров.

Аргументы: 

array(
     'limit' => '12',
     'columns' => '4',
     'orderby' => 'title'
 )

[related_products limit="12"]

Добавить в корзину

Показать цену и добавить в корзину кнопку одного продукта по ID.

Аргумент:

array(
      'id' => '99',
      'style' => 'border:4px solid #ccc; padding: 12px;',
      'sku' => 'FOO'
      'style' => 'TRUE'
      'class' => 'CSS-CLASS'
 )
[add_to_cart id="99"]

Добавить в корзину URL

Это URL на кнопку Добавить в корзину для одного товара по ID.

Аргументы:

array(
      'id' => '99',
      'sku' => 'FOO'
 )
[add_to_cart_url id="99"]

Настраиваемые уведомления для woocommerce страниц

[shop_messages] позволяет отображать уведомления WooCommerce (например, «продукт был добавлен в корзину») на страницах, отличных от WooCommerce. Полезно, когда вы используете другие шорткоды ,такие как [add_to_cart], и хотели бы, чтобы пользователи получили обратную связь о своих действиях.

Материал взят: от сюда.