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

概要

woocommerce_order_tracking_formフィルタは、WooCommerceの注文追跡フォームの表示をカスタマイズするために使用されます。これにより、開発者は追跡フォームのコンテンツを変更したり、新しい情報を追加したりすることができます。このフィルタを利用することで、次のような機能を実装する際に役立ちます：

追跡フォームのデザインのカスタマイズ
追加情報の設置（例えば、顧客向けの特別なメッセージ）
スキンやテーマの切り替え機能
追跡情報の具体的なビジュアル表示（グラフなど）
特定の条件に基づくメッセージの追加
他のプラグインとの連携によるデータの表示

構文

apply_filters( 'woocommerce_order_tracking_form', $content, $order );

パラメータ

$content: 追跡フォームのHTMLコンテンツ。
$order: 追跡対象の注文オブジェクト。

戻り値

カスタマイズされた追跡フォームのHTMLコンテンツ。

バージョン

WooCommerce 3.0.0以上
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_order_tracking_form', 'custom_order_tracking_message', 10, 2 );

function custom_order_tracking_message( $content, $order ) {
    if ( $order->has_status( 'completed' ) ) {
        $content .= '<p>ご注文は完了しています。ありがとうございました！</p>';
    }
    return $content;
}

このコードは、注文が完了している場合に特別なメッセージを追跡フォームに追加します。

サンプルコード 2

add_filter( 'woocommerce_order_tracking_form', 'custom_tracking_styles', 10, 2 );

function custom_tracking_styles( $content, $order ) {
    $content .= '<style>
                    .tracking-message { color: green; }
                 </style>';
    return $content;
}

このコードは、追跡フォームにカスタムスタイルを追加します。特定のクラスを使用して色を指定しています。

サンプルコード 3

add_filter( 'woocommerce_order_tracking_form', 'add_support_info_to_tracking', 10, 2 );

function add_support_info_to_tracking( $content, $order ) {
    $content .= '<p>ご質問がある場合は、サポートにご連絡ください。</p>';
    return $content;
}

このコードは、追跡フォームの最後にサポート情報を追加することで、顧客へのフォローアップを強化します。

サンプルコード 4

add_filter( 'woocommerce_order_tracking_form', 'modify_tracking_table_structure', 10, 2 );

function modify_tracking_table_structure( $content, $order ) {
    $content = '<div class="custom-tracking">' . $content . '</div>';
    return $content;
}

このコードは、追跡フォーム全体をカスタムのdivでラップして、スタイルを容易に適用できるようにしています。

サンプルコード 5

add_filter( 'woocommerce_order_tracking_form', 'insert_tracking_date', 10, 2 );

function insert_tracking_date( $content, $order ) {
    $date = date_i18n( wc_date_format(), strtotime( $order->get_date_created() ) );
    $content .= '<p>注文日: ' . esc_html( $date ) . '</p>';
    return $content;
}

このコードは、注文の作成日を追跡フォームの下部に表示します。これにより、顧客は注文がいつ作成されたかを確認できます。

なお、これらのサンプルコードは著作権フリーで提供されており、他のソースからの引用はありません。

概要

構文