プラグインWooCommerceのwoocommerce_after_subcategory_titleアクションの使用方法・解説

概要

woocommerce_after_subcategory_titleは、WooCommerceの商品カテゴリーのサブカテゴリーのタイトルが表示された後に、追加のコンテンツを出力するためのフックです。このアクションは、特定のカテゴリーに関連する情報やビジュアルを追加したい場合に便利です。具体的には、以下のような機能を実装する際によく使われます。

サブカテゴリーの説明文を追加する
特定の商品バナーを表示する
カスタム HTML コンテンツを埋め込む
サブカテゴリーに関連するプロモーションを表示する
ソーシャルメディアリンクを追加する
カスタムスタイルを適用するためのラッパーを追加する

構文

add_action( 'woocommerce_after_subcategory_title', 'function_name' );

パラメータ

このアクションに渡されるパラメータはありません。

戻り値

このアクションは特に戻り値を持たず、指定された関数を実行します。

使用可能なプラグインバージョン

WooCommerce: 3.0以上
WordPress: 4.0以上

サンプルコード

サンプル1: サブカテゴリーの説明を追加する

add_action( 'woocommerce_after_subcategory_title', 'add_subcategory_description' );

function add_subcategory_description( $subcategory ) {
    echo '<p>' . esc_html( $subcategory->description ) . '</p>';
}

このサンプルコードは、各サブカテゴリーのタイトルの下にその説明を表示します。

サンプル2: プロモーションバナーを表示する

add_action( 'woocommerce_after_subcategory_title', 'display_promotion_banner' );

function display_promotion_banner() {
    echo '<div class="promotion-banner">今月の特価！</div>';
}

このサンプルは、サブカテゴリータイトルの下にプロモーションバナーを表示します。

サンプル3: カスタムHTMLを埋め込む

add_action( 'woocommerce_after_subcategory_title', 'embed_custom_html' );

function embed_custom_html() {
    echo '<div class="custom-html">特別オファーを見逃さないで！</div>';
}

このコードは、サブカテゴリータイトルの後にカスタムHTMLを挿入します。

サンプル4: ソーシャルメディアリンクの追加

add_action( 'woocommerce_after_subcategory_title', 'add_social_links' );

function add_social_links() {
    echo '<div class="social-links"><a href="#">Facebook</a> | <a href="#">Twitter</a></div>';
}

このサンプルは、サブカテゴリーのタイトルの下にソーシャルメディアのリンクを追加します。

サンプル5: スタイル適用用のラッパー追加

add_action( 'woocommerce_after_subcategory_title', 'add_wrapper_for_styles' );

function add_wrapper_for_styles() {
    echo '<div class="custom-style-wrapper">';
    // コンテンツを追加する場所
    echo '</div>';
}

このコードは、スタイルの適用を容易にするために、ラッパー要素を追加します。

この関数のアクションでの使用可能性

アクション	使用例
mu_plugin_loaded
registered_post_type
plugins_loaded
wp_roles_init
setup_theme
after_setup_theme
set_current_user
init
register_sidebar
wp_loaded
send_headers
parse_query
pre_get_posts
wp
template_redirect
get_header
wp_head

概要

構文