【WooCommerce】アクションとフィルター一覧

WordressのプラグインであるWooCommerceは超高機能なECサイト構築プラグインとして有名です。無料で使えるうえに自由にカスタマイズすることで、自在にECサイトを実現できます。

ただ、世界的には有名なプラグインではあるものの日本での普及数が多くないため、日本人にとってカスタマイズのハードルがけっこう高めです。

そこで今回はWooCommerceのアクションとフィルターを機能ごとに紹介いたします。

woocommerce 2022年最新版バージョン5.9.0で確認

商品一覧 Product

content-product.php

アクション

名称機能詳細
woocommerce_before_shop_loop_item商品一覧上部にアクションを追加
woocommerce_before_shop_loop_item_title商品名上部にアクションを追加
woocommerce_shop_loop_item_title商品名下部にアクションを追加
woocommerce_after_shop_loop_item_title商品一覧下部にアクションを追加

商品一覧画面に追加できるアクションフックの位置は下記の通りです。

商品一覧へのアクションフック 画面イメージ

WooCommerce 商品一覧へのアクションフック追加

商品詳細 single-product

single-product.php

アクション

名称機能詳細
woocommerce_before_single_product商品詳細画面上部へのアクション追加
woocommerce_before_single_product_summary(該当箇所見つからず)
woocommerce_single_product_summary商品詳細説明上部へのアクション追加
woocommerce_after_single_product_summary商品詳細下部へのアクション追加

商品詳細画面に追加できるアクションフックの位置は下記の通りです。

商品詳細へのアクションフック 画面イメージ

WooCommerce 商品詳細のアクションフック追加

ナビゲーション navigation

navigation.php

アクション

名称機能詳細
woocommerce_before_account_navigationMyAccountメニュー画面上部へのアクション追加
woocommerce_after_account_navigationMyAccountメニュー画面下部へのアクション追加

MyAccountへのアクションフック 画面イメージ

WooCommerce MyAccoutナビゲーション画面へのアクションフック

カート cart

cart.php

アクション

名称機能詳細
woocommerce_before_cartカート画面最上部へのアクション追加
woocommerce_before_cart_tableカートのテーブル上部へのアクション追加
woocommerce_before_cart_contentsカートコンテンツ上部へのアクション追加
woocommerce_after_cart_item_nameカート内商品名へのアクション追加
woocommerce_cart_contentsカートコンテンツへのアクション追加
woocommerce_cart_couponクーポン表示部分へのアクション追加
woocommerce_cart_actionsカート内のアクションボタンへのアクション追加
woocommerce_after_cart_contentsカートコンテンツ下部へのアクション追加
woocommerce_after_cart_tableカートのテーブル下部へのアクション追加
woocommerce_before_cart_collateralscollaterals上部へのアクション追加
woocommerce_cart_collateralscollaterals下部へのアクション追加
woocommerce_after_cartカート画面最下部へのアクション追加

カート画面へのアクションフック 画面イメージ

WooCommerce カートへのアクションフック追加

フィルター

名称機能詳細
woocommerce_cart_item_product商品に関する情報一式を取得
名称などのプロパティを持ったオブジェクトを取得可能
woocommerce_cart_item_product_id商品IDを取得可能
woocommerce_cart_item_permalink商品リンクを取得可能
woocommerce_cart_item_thumbnail商品サムネイル画像を取得可能
woocommerce_cart_item_name商品名を取得可能
woocommerce_cart_item_backorder_notification商品のバックオーダー通知内容を取得可能
woocommerce_cart_item_price商品価格を取得可能
woocommerce_cart_item_quantity商品数を取得可能
woocommerce_cart_item_subtotal商品合計数を取得可能

カート合計 cart-total

cart-totals.php

アクション

名称機能詳細
woocommerce_before_cart_totalsカート合計上部へのアクション追加
woocommerce_cart_totals_before_shippingカートの送料合計上部へのアクション追加
woocommerce_cart_totals_after_shippingカートの送料合計下部へのアクション追加
woocommerce_cart_totals_before_order_total合計欄上部へのアクション追加
woocommerce_cart_totals_after_order_total合計欄下部へのアクション追加
woocommerce_proceed_to_checkout購入ボタン
woocommerce_after_cart_totalsカート合計下部へのアクション追加
WooCommerce カート合計へのアクション追加

支払い選択 payment

payment-methods.php

アクション

名称機能詳細
woocommerce_before_account_payment_methodsMyAccountの決済画面上部へのアクション追加
woocommerce_account_payment_methods_column_method,$methodMyAccountの決済方法欄へのアクション追加
woocommerce_account_payment_methods_column_expires,$methodMyAccountの有効期限欄へのアクション追加
woocommerce_account_payment_methods_column_actions,$methodMyAccountのアクション欄へのアクション追加
woocommerce_after_account_payment_methodsMyAccountの決済画面下部へのアクション追加

支払い選択アクションフック 画面イメージ

WooCommerce 決済方法へのアクション追加

支払い選択アクションフック 利用方法

パラーメータを受け渡す機能の使い方が難しいので、簡単にサンプルをご提示

woocommerce_account_payment_methods_column_method

function my_woocommerce_account_payment_methods_column_expires($method){
    echo '<b>!!!!expires!!!!</b><br>';
    echo $method['expires'];
}
add_filter('woocommerce_account_payment_methods_column_expires','my_woocommerce_account_payment_methods_column_expires');

woocommerce_account_payment_methods_column_expires

function my_woocommerce_account_payment_methods_column_actions($method){
    echo '<b>!!!!actions!!!!</b><br>';
    echo $method['actions'];
}
add_filter('woocommerce_account_payment_methods_column_actions','my_woocommerce_account_payment_methods_column_actions');

woocommerce_account_payment_methods_column_actions

function my_woocommerce_after_account_payment_methods(){
        echo '<b>!!!!woocommerce_after_account_payment_methods!!!!</b>';
    }
add_filter('woocommerce_after_account_payment_methods','my_woocommerce_after_account_payment_methods');

送料 shipping

shipping-calculator.php

アクション

名称機能詳細
woocommerce_before_shipping_calculator送料計算欄上部へのアクション追加
woocommerce_after_shipping_calculator送料計算欄下部へのアクション追加

送料欄アクションフック 画面イメージ

WooCommerce 送料計算へのアクション追加

フィルター

名称機能詳細
woocommerce_shipping_calculator_enable_countrycountry設定での送料計算を有効にするか
woocommerce_shipping_calculator_enable_statestate設定での送料計算を有効にするか
woocommerce_shipping_calculator_enable_citycity設定での送料計算を有効にするか
woocommerce_shipping_calculator_enable_postcodepostcode設定での送料計算を有効にするか

チェックアウトフォーム checkout

form-checkout.php

アクション

名称機能詳細
woocommerce_before_checkout_formチェックアウトフォーム最上部へのアクション追加
woocommerce_checkout_before_customer_details顧客情報上部へのアクション追加
woocommerce_checkout_billing請求先欄へのアクション追加
woocommerce_checkout_shipping配送先欄へのアクション追加
woocommerce_checkout_after_customer_details顧客情報下部へのアクション追加
woocommerce_checkout_before_order_review_heading注文内容確認ヘッダ部へのアクション追加
woocommerce_checkout_before_order_review注文内容確認上部へのアクション追加
woocommerce_checkout_order_review注文内容確認欄へのアクション追加
woocommerce_checkout_after_order_review注文内容確認下部へのアクション追加
woocommerce_after_checkout_formチェックアウトフォーム最下部へのアクション追加

チェックアウトフォームアクションフック 画面イメージ

WooCommerce チェックアウトフォームのアクション追加

フィルター

名称機能詳細
woocommerce_checkout_must_be_logged_in_messageログイン誘導メッセージの取得

ログインフォーム login

form-login.php

アクション

名称機能詳細
woocommerce_login_form_startログインフォーム上部へのアクション追加
woocommerce_login_formログイン欄へのアクション追加
woocommerce_login_form_endログインフォーム下部へのアクション追加

ログインフォームへのアクションフック 画面イメージ

WooCommerce ログインフォームへのアクションフック追加

注文明細 order-detail

order-details.php

アクション

名称機能詳細
woocommerce_order_details_before_order_tableMyAccount注文明細最上部へのアクション追加
woocommerce_order_details_before_order_table_items注文明細上部へのアクション追加
woocommerce_order_details_after_order_table_items注文明細欄へのアクション追加
woocommerce_order_details_after_order_table注文明細下部へのアクション追加
woocommerce_after_order_detailsMyAccount注文明細最下部へのアクション追加

注文明細へのアクションフック 画面イメージ

WooCommerce 注文明細へのアクションフック追加

フィルター

名称機能詳細
woocommerce_purchase_order_item_types注文明細のタイプを取得
woocommerce_purchase_note_order_statuses注文明細のステータスを取得

注文明細フィルターフック 利用方法

それぞれ下記の情報が出力されます。

function my_woocommerce_purchase_order_item_types($data){
    var_dump($data);
}
add_filter('woocommerce_purchase_order_item_types','my_woocommerce_purchase_order_item_types');
//string(9) "line_item" 

function my_woocommerce_purchase_note_order_statuses($data){
    var_dump($data);
}
add_filter('woocommerce_purchase_note_order_statuses','my_woocommerce_purchase_note_order_statuses');
//array(2) { [0]=> string(9) "completed" [1]=> string(10) "processing" }

メール mail

class-wc-emails.php

アクション

名称機能詳細
woocommerce_email_headerメールヘッダへのアクション追加
woocommerce_email_footerメールフッタへのアクション追加
woocommerce_email_order_detailsメール本文注文明細へのアクション追加
woocommerce_email_order_metaメール本文注文属性へのアクション追加
woocommerce_email_customer_detailsメール本文顧客詳細へのアクション追加
woocommerce_low_stock_notification在庫僅少メール通知時のアクション追加
woocommerce_no_stock_notification在庫切れメール通知時のアクション追加
woocommerce_product_on_backorder_notificationバックオーダー通知時のアクション追加
woocommerce_created_customer_notification顧客通知メールへのアクション追加
woocommerce_email_footer_textメールフッタのサイトタイトル欄へのアクション追加
woocommerce_emailメール送信時のアクション追加

フィルター

名称機能詳細
woocommerce_email_headersメールヘッダの取得
woocommerce_email_order_meta_fields注文属性欄の取得
woocommerce_email_order_meta_keys注文属性欄項目取得
woocommerce_email_customer_details_fields顧客詳細欄のデータ取得
woocommerce_email_subject_low_stock在庫僅少メールの件名取得
woocommerce_email_content_low_stock在庫僅少メールの本文取得
woocommerce_email_attachmentsメール添付情報の取得
woocommerce_email_subject_backorderバックオーダーメールの件名取得
woocommerce_email_content_backorderバックオーダーメールの本文取得
woocommerce_email_subject_no_stock在庫切れメールの件名取得
woocommerce_email_content_no_stock在庫切れメールの本文取得

まとめ

WooCommerceで利用できそうなアクションフック・フィルターフックの一覧をご紹介いたしました。

カスタマイズや機能追加する上で本情報が役に立つと思います。

他にもアクションフック・フィルターフックは用意されておりますので、今回ご紹介したもの以外を探してみたい場合は公式サイトをご覧ください。

WooCommerceのアクションフック・フィルターフック一覧

コメントを残す