プラグインWooCommerceのwoocommerce_product_related_products_headingフィルタの使用方法・解説

概要

woocommerce_product_related_products_heading フィルタは、WooCommerceの関連商品セクションの見出しをカスタマイズするために使用されます。このフィルタを利用することで、関連商品の表示をより魅力的にしたり、ユーザーのニーズに応じた情報提供が可能になります。実装時には、次のような機能を実現する際に頻繁に使用されます。

関連商品の見出しをカスタマイズする
商品の特性に基づいたタイトルを動的に生成する
マーケティングキャンペーンに応じたメッセージを表示する
ユーザーの興味を引くための独自の文言を追加する
多言語対応に向けたテキストの翻訳を行う
SEOフレンドリーなタイトルへ変更する

構文

add_filter('woocommerce_product_related_products_heading', 'my_custom_related_products_heading');

パラメータ

string $heading (現在の見出し)

戻り値

string (新しい見出し)

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

WooCommerce 2.1以上で使用可能

ワードプレスのバージョン

WordPress 4.0以上で使用可能

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

アクション	使用可能性
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

サンプルコード

サンプルコード1: 固定テキストを使用する

add_filter('woocommerce_product_related_products_heading', function($heading) {
    return 'おすすめ商品';
});

このコードは、関連商品の見出しを「おすすめ商品」に固定します。

サンプルコード2: 商品カテゴリーに基づく見出しを追加する

add_filter('woocommerce_product_related_products_heading', function($heading) {
    global $product;
    $categories = wp_get_post_terms($product->get_id(), 'product_cat');
    return '関連商品 - ' . esc_html($categories[0]->name);
});

このコードは、表示される商品が属する最初のカテゴリー名を含めた見出しを生成します。

サンプルコード3: ランダムテキストを導入

add_filter('woocommerce_product_related_products_heading', function($heading) {
    $titles = ['あなたにおすすめのアイテム', '関連商品をご覧ください', '特に気に入る商品'];
    return $titles[array_rand($titles)];
});

このコードは、見出しを3つのランダムなテキストの中から選んだものに変更します。

サンプルコード4: 特定の条件に応じた見出し変更

add_filter('woocommerce_product_related_products_heading', function($heading) {
    if (is_product() && is_user_logged_in()) {
        return 'あなたのためのおすすめ商品';
    }
    return $heading;
});

このコードは、ユーザーがログインしている場合にのみ、特別な見出しを表示します。

サンプルコード5: 多言語のための翻訳機能を追加

add_filter('woocommerce_product_related_products_heading', function($heading) {
    if (function_exists('pll__')) {
        return pll__('関連商品');
    }
    return $heading;
});

このコードは、Polylangなどの多言語プラグインを利用して、見出しを翻訳します。

概要

構文