概要
woocommerce_product_export_skip_meta_keys
フィルタは、WooCommerceの製品エクスポート機能を拡張するために使用されます。このフィルタを利用することで、特定のメタキーをエクスポートから除外することができます。これにより、ユーザーは不要なメタ情報をエクスポートから削除し、データの可読性を向上させることができます。
このフィルタは、以下のような状況でよく使用されます:
- エクスポートするデータのサイズを減少させたいとき
- エクスポートファイルをクリーンに保ちたいとき
- 機密情報をエクスポートから隠したいとき
- 特定のカスタムメタデータが必要ない場合
- サードパーティアプリケーションとの連携時に、不要なデータを取り除くため
- エクスポートファイルのインポート時にエラーを避けるため
構文
add_filter('woocommerce_product_export_skip_meta_keys', 'your_custom_function');
パラメータ
array $skip_keys
— 除外するメタキーの配列
戻り値
array
— 除外するメタキーの配列(変更後)
使用可能なプラグインバージョン
- WooCommerce: 3.0以上
- WordPress: 4.0以上
サンプルコード
サンプルコード1: 特定のメタキーをエクスポートから除外する
add_filter('woocommerce_product_export_skip_meta_keys', function ($skip_keys) {
$skip_keys[] = '_custom_meta_key';
return $skip_keys;
});
このサンプルコードは、エクスポート時に_custom_meta_key
という特定のメタキーを除外します。
サンプルコード2: 複数のメタキーを除外
add_filter('woocommerce_product_export_skip_meta_keys', function ($skip_keys) {
return array_merge($skip_keys, ['_private_meta_key', '_another_meta_key']);
});
複数のメタキー(_private_meta_key
と_another_meta_key
)をエクスポートから除外します。
サンプルコード3: 条件に基づいてメタキーを除外
add_filter('woocommerce_product_export_skip_meta_keys', function ($skip_keys) {
if (is_user_logged_in()) {
$skip_keys[] = '_logged_in_user_meta';
}
return $skip_keys;
});
このコードは、ユーザーがログインしている場合にのみ、_logged_in_user_meta
を除外します。
サンプルコード4: すべてのメタキーを除外
add_filter('woocommerce_product_export_skip_meta_keys', function () {
return ['_all_meta_keys'];
});
このサンプルは、エクスポート時にすべてのメタキーを除外します。
サンプルコード5: 特定のカスタム条件に基づいてメタキーを除外
add_filter('woocommerce_product_export_skip_meta_keys', function ($skip_keys) {
if (defined('CUSTOM_CONDITION')) {
$skip_keys[] = '_conditionally_excluded_meta_key';
}
return $skip_keys;
});
条件定義がある場合にのみ、特定のメタキー(_conditionally_excluded_meta_key
)を除外します。
この関数のアクションでの使用可能性
アクション | 使用可能性 |
---|---|
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 |