woocommerce shortcode短代碼調用

WooCommerce配備了很多shortcode短代碼(簡碼)，可以直接在post帖子和page頁面內插入內容，方便展示產品、分類等。比如直接在文章編輯時直接插入[products]，或者在php文件中插入<?php echo do_shortcode('[product]'); ?>以下是一些常用的woocommerce短代碼

注意短代碼不要放在<pre></pre>之間，""雙引號和''單引號是在英文狀態下

---

 

page短代碼

WooCommerce 如果沒有您網站上的某個地方的前三個短代碼，就無法正常運行。

woocommerce_cart – 顯示購物車頁面 

woocommerce_checkout – 顯示結帳頁面 

woocommerce_my_account – 顯示用戶帳戶頁面

woocommerce_order_tracking – 顯示訂單跟蹤表單

在大多數情況下，這些短代碼將通過我們的入門嚮導自動添加到頁面中，無需手動使用。

即如果你是正常安裝woocommerce，它會自動創建cart、checkout、my account三個頁面

---

 

product短代碼

[products]短代碼允許您按帖子 ID、SKU、類別、屬性顯示產品，並支持分頁、隨機排序和產品標籤，取代了對多個短代碼的需求。查看以下示例。[products][featured_products][sale_products][best_selling_products][recent_products][product_attribute][top_rated_products]

可用的產品屬性

顯示產品屬性

• limit– 要顯示的產品數量。發佈商品時默認爲 和（全部顯示），類別默認爲 （顯示全部）。-1-1
• columns– 要顯示的列數。默認值爲 。4
• paginate– 打開分頁。與 結合使用。默認設置爲 分頁 。limitfalsetrue
• orderby– 對輸入選項顯示的產品進行排序。可以通過添加兩個 slug 並在它們之間留空格來傳遞一個或多個選項。可用選項包括：
  • date– 產品發佈日期。
  • id– 產品的帖子 ID。
  • menu_order– 菜單順序，如果已設置（首先顯示較小的數字）。
  • popularity– 購買次數。
  • rand– 在頁面加載時隨機訂購產品（可能不適用於使用緩存的網站，因爲它可以保存特定訂單）。
  • rating– 平均產品評級。
  • title– 產品標題。這是默認模式。orderby
• skus– 以逗號分隔的產品 SKU 列表。
• category– 逗號分隔的類別蛞蝓列表。
• tag– 以逗號分隔的標籤 slug 列表。
• order– 使用中設置的方法說明產品訂單是升序 （） 還是降序 （）。默認值爲 。ASCDESCorderbyASC
• class– 添加 HTML 包裝類，以便您可以使用自定義 CSS 修改特定輸出。
• on_sale– 檢索打折產品。不得與 或 一起使用。best_sellingtop_rated
• best_selling– 檢索最暢銷的產品。不得與 或 一起使用。on_saletop_rated
• top_rated– 檢索最受好評的產品。不得與 或 一起使用。on_salebest_selling

內容產品屬性

• attribute– 使用指定的屬性 slug 檢索產品。
• terms– 要與 一起使用的屬性術語的逗號分隔列表。attribute
• terms_operator– 用於比較屬性項的運算符。可用選項包括：
  • AND– 將顯示來自所有選定屬性的產品。
  • IN– 將顯示具有所選屬性的產品。這是默認值。terms_operator
  • NOT IN– 將顯示不在所選屬性中的產品。
• tag_operator– 用於比較標籤的運算符。可用選項包括：
  • AND– 將顯示所有選定標籤中的產品。
  • IN– 將顯示帶有所選標籤的產品。這是默認值。tag_operator
  • NOT IN– 將顯示不在所選標籤中的產品。
• visibility– 將根據所選可見性顯示產品。可用選項包括：
  • visible– 產品在商店和搜索結果中可見。這是默認選項。visibility
  • catalog– 產品僅在商店中可見，但對搜索結果不可見。
  • search– 產品僅在搜索結果中可見，但在商店中不可見。
  • hidden– 在商店和搜索中隱藏的產品，只能通過直接 URL 訪問。
  • featured– 標記爲特色產品的產品。

• category– 使用指定的類別 slug 檢索產品。
• tag– 使用指定的標籤 slug 檢索產品。
• cat_operator– 用於比較類別術語的運算符。可用選項包括：
  • AND– 將顯示屬於所有選定類別的產品。
  • IN– 將顯示所選類別中的產品。這是默認值。cat_operator
  • NOT IN– 將顯示不在所選類別中的產品。

• ids– 將根據逗號分隔的帖子 ID 列表顯示產品。
• skus– 將根據逗號分隔的 SKU 列表顯示產品。

如果商品未顯示，請確保未在“目錄可見性”中將其設置爲“隱藏”。

特殊產品屬性

這些屬性不能與上面列出的“內容屬性”一起使用，因爲它們可能會導致衝突並且無法顯示。應僅使用以下特殊屬性之一。

• best_selling– 將顯示您最暢銷的產品。必須設置爲 。true
• on_sale– 將顯示您的銷售產品。必須設置爲 。true

 

[product]短代碼示例 

場景 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 – 最暢銷的產品

我想連續展示我的三個最暢銷的產品。

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

場景 4 – 最新產品

我想先展示最新產品 – 一行顯示四個產品。爲此，我們將使用 Post ID（在創建產品頁面時生成）以及 order 和 orderby 命令。由於您無法從前端看到 Post ID，因此 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_operatorNOT IN

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

請注意，即使限制設置爲 ，也只有四個產品符合該條件，因此會顯示四個產品。

場景 6 – 屬性顯示

每個服裝都有一個屬性，根據適當的季節，“春/夏”或“秋/冬”，有些配飾具有兩者，因爲它們可以全年穿着。在此示例中，我希望每行三個產品，顯示所有“春/夏”項。該屬性 slug 是 ，屬性是 和 。我還希望它們從最新產品到最舊產品進行排序。seasonwarmcold

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

或者，如果我想只展示寒冷天氣的產品，我可以添加我的：NOT INterms_operator

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

請注意，通過使用 ，我排除了同時處於“春/夏”和“秋/冬”中的產品。如果我想展示所有適合寒冷天氣的裝備，包括這些共享配件，我會將術語從 更改爲 .NOT INwarmcold

場景 7 – 僅顯示帶有標籤“連帽衫”的產品

[products tag="hoodie"]

 

按自定義meta字段對產品進行排序

使用產品簡碼時，您可以選擇按上述預定義值訂購產品。您還可以使用以下代碼按自定義元字段對產品進行排序（在本例中，我們按價格對產品進行排序）：

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對其進行自定義。

 

---

 

產品分類

這兩個短代碼將在任何頁面上顯示您的產品類別。

• [product_category]– 將顯示指定產品類別中的產品。
• [product_categories]– 將顯示您的所有產品類別。

可用的產品類別屬性

• ids– 指定要列出的特定類別 ID。用於 [product_categories]
• category– 可以是類別 ID、名稱或 slug。用於 [product_category]
• limit– 要顯示的類別數量
• columns– 要顯示的列數。默認值爲 4
• hide_empty– 默認值爲“1”，這將隱藏空類別。設置爲“0”以顯示空類別
• parent– 如果要顯示所有子類別，請設置爲特定類別 ID。或者，設置爲“0”（如下例所示）以僅顯示頂級類別。
• orderby– 默認按“名稱”排序，可以設置爲“id”、“slug”或“menu_order”。如果您想按指定的 ID 排序，則可以使用orderby="include"
• order– 使用 中設置的方法說明類別排序是升序 （） 還是降序 （）。默認值爲 。ASCDESCorderbyASC

產品類別方案示例

僅顯示頂級類別

想象一下，您只想在頁面上顯示頂級類別並排除子類別，那麼可以使用以下短代碼。

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

---

產品詳情頁

按 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'
      'show_price' => 'TRUE'
      'class' => 'CSS-CLASS'
      'quantity' => '1';
 )

加入購物車短代碼：

[add_to_cart id="99"]

---

添加到購物車網址

按 ID 在單個產品的添加到購物車按鈕上顯示 URL。

參數：

array(
      'id' => '99',
      'sku' => 'FOO'
 )

添加購物車網址短代碼

[add_to_cart_url id="99"]

 

---

 

在非WooCommerce的頁面上顯示WooCommerce通知

[shop_messages]允許您在非WooCommerce頁面上顯示WooCommerce通知（例如，“產品已添加到購物車”）。當您使用其他短代碼（如 ）並希望用戶獲得有關其操作的一些反饋時非常有用。

---

 

woocommerce短代碼常見問題

 變體產品 SKU 未顯示

關於 SKU 短代碼的使用，例如，變體產品 SKU 不打算單獨顯示，而不是父變量產品 SKU。因此，如果我們使用來自：產品數據>可變產品>變體>變體名稱> SKU，則預計不會顯示該 SKU。[products skus="sku-name"]

但是，如果我們使用父變量產品中的 SKU：商品數據>可變商品>庫存> SKU，則會顯示該商品數據。

 

 

參考資料

https://woocommerce.com/document/woocommerce-shortcodes/