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

概要

woocommerce_account_downloads_column_$COLUMN_ID フィルタは、WooCommerceにおいて顧客のアカウントのダウンロードページのカラム表示をカスタマイズする際に使用されます。このフィルタを使うことで、ダウンロード可能な商品の情報を柔軟に表示することができます。よく使用される機能には以下のようなものがあります。

ダウンロード完了日を表示
ダウンロードサイズを表示
ダウンロード回数を表示
ファイルのバージョンを表示
特定の条件に基づく情報の追加
カスタムフィールドの表示

構文

add_filter( 'woocommerce_account_downloads_column_$COLUMN_ID', 'your_custom_function' );

パラメータ

$COLUMN_ID: 表示するカラムのID（例: download_file、download_dateなど）
$downloads: ダウンロード可能な商品の情報が和えられた配列

戻り値

カスタマイズされたカラムの内容

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

WooCommerce: 4.0以上推奨
WordPress: 5.0以上推奨

サンプルコード

サンプルコード 1

add_filter( 'woocommerce_account_downloads_column_download_date', 'custom_download_date_column' );

function custom_download_date_column( $date, $download ) {
    return date( 'Y-m-d H:i', strtotime( $date ) );
}

このサンプルコードは、ダウンロード日をカスタマイズして、フォーマットを Y-m-d H:i に変換して表示します。

サンプルコード 2

add_filter( 'woocommerce_account_downloads_column_download_size', 'custom_download_size_column' );

function custom_download_size_column( $size, $download ) {
    return $size . ' MB'; // サイズをMB単位で表示
}

このサンプルコードは、ダウンロードサイズに「MB」を追加して表示します。

サンプルコード 3

add_filter( 'woocommerce_account_downloads_column_download_file', 'custom_download_file_column' );

function custom_download_file_column( $file, $download ) {
    return '<a href="' . esc_url( $file ) . '" target="_blank">Download Now</a>'; // ダウンロードリンクのテキストをカスタマイズ
}

このサンプルコードは、ダウンロードファイルのリンクテキストを「Download Now」に変更します。

サンプルコード 4

add_filter( 'woocommerce_account_downloads_column_download_count', 'custom_download_count_column' );

function custom_download_count_column( $count, $download ) {
    return $count . ' times downloaded'; // ダウンロード回数の表示をカスタマイズ
}

このサンプルコードでは、ダウンロード回数の後に「times downloaded」のテキストを追加します。

サンプルコード 5

add_filter( 'woocommerce_account_downloads_column_download_version', 'custom_download_version_column' );

function custom_download_version_column( $version, $download ) {
    return 'Version: ' . $version; // ファイルのバージョンを表示
}

このサンプルコードは、ダウンロードファイルのバージョンをカスタマイズし、テキスト「Version: 」を追加します。

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

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

概要

構文