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

概要

woocommerce_widget_product_review_item_endは、WooCommerceプラグインのアクションフックであり、商品レビューウィジェットの各レビューアイテムの終了時に実行されます。このアクションは、レビューアイテムの表示が完了した後に追加のコンテンツを挿入したい場合に非常に便利です。特に、以下のような機能を実装する際によく使われます。

レビュー後のプロモーション情報の表示
アフィリエイトリンクやおすすめ商品の追加
ユーザーに関連する他のプラグインのコンテンツを埋め込む
レビューアイテムにカスタムCSSを適用する
SNSシェアボタンの追加
レビューのフィードバックや広告を表示する

構文

do_action( 'woocommerce_widget_product_review_item_end', $review, $product );

パラメータ

$review: 現在のレビューオブジェクト
$product: 関連する商品オブジェクト

戻り値

このアクションフックは何も返しません。

WooCommerceとWordPressのバージョン

WooCommerce バージョン: 5.0以上
WordPress バージョン: 5.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_action( 'woocommerce_widget_product_review_item_end', 'add_custom_message_to_reviews', 10, 2 );

function add_custom_message_to_reviews( $review, $product ) {
    echo '<p>このレビューを読んでいただきありがとうございます！</p>';
}

このサンプルコードは、レビューの最後にカスタムメッセージを追加します。

サンプルコード2: SNSシェアボタンの追加

add_action( 'woocommerce_widget_product_review_item_end', 'add_social_share_buttons', 10, 2 );

function add_social_share_buttons( $review, $product ) {
    echo '<div class="social-share">SNSでシェアする: <a href="#">Twitter</a> | <a href="#">Facebook</a></div>';
}

このコードでは、レビューの最後にSNSシェアボタンを追加します。

サンプルコード3: プロモーションバナーの表示

add_action( 'woocommerce_widget_product_review_item_end', 'show_promotion_banner', 10, 2 );

function show_promotion_banner( $review, $product ) {
    echo '<div class="promotion-banner">特別オファー: 商品の購入で10%オフ！</div>';
}

このコードは、レビューの後に特別オファーのバナーを表示します。

サンプルコード4: 他の商品へのリンクを追加

add_action( 'woocommerce_widget_product_review_item_end', 'link_to_related_products', 10, 2 );

function link_to_related_products( $review, $product ) {
    echo '<p><a href="' . esc_url( get_permalink( $product->get_related_ids() ) ) . '">関連商品を見る</a></p>';
}

このサンプルは、レビューの最後に関連商品へのリンクを追加します。

サンプルコード5: カスタムCSSクラスを追加

add_action( 'woocommerce_widget_product_review_item_end', 'add_custom_css_class', 10, 2 );

function add_custom_css_class( $review, $product ) {
    echo '<div class="custom-class">カスタムスタイルを適用したレビューです。</div>';
}

このコードは、レビューの終了時にカスタムCSSクラスを持つdivを追加します。

概要

構文