プラグインElementorのelementor/files/file_nameフィルタの使用方法・解説

概要

elementor/files/file_name フィルタは、Elementorプラグインにおいてファイル名を変更または操作するためのフックです。このフィルタを使用することにより、特定のファイル名を動的に変更することが可能になります。主に次のような機能を実装する際に利用されます。

アップロードされた画像のファイル名を変更する
ダウンロードリンクのファイル名をカスタマイズする
テンプレートのファイル名に日付やユーザーIDを追加する
特定の条件に基づいてファイル名をフィルタリングする
透明性を持たせるためにファイル名にプレフィックスを追加する
SEO最適化のためにファイル名を整える

構文

function custom_file_name( $file_name ) {
    // カスタムロジック
    return $file_name;
}
add_filter( 'elementor/files/file_name', 'custom_file_name' );

パラメータ

$file_name (string): 元のファイル名

戻り値

(string): 変更後のファイル名

対応バージョン

Elementor バージョン: 3.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

function customize_uploaded_file_name( $file_name ) {
    return 'custom-prefix-' . $file_name;
}
add_filter( 'elementor/files/file_name', 'customize_uploaded_file_name' );

このコードは、アップロードされるファイルの名前に「custom-prefix-」というプレフィックスを追加しています。

サンプルコード 2

function append_date_to_file_name( $file_name ) {
    $date = date('Ymd');
    return $date . '-' . $file_name;
}
add_filter( 'elementor/files/file_name', 'append_date_to_file_name' );

このコードは、ファイルの名前の前に今日の日付を追加する機能を実装しています。

サンプルコード 3

function remove_special_characters_from_file_name( $file_name ) {
    return preg_replace('/[^A-Za-z0-9_-.]/', '', $file_name);
}
add_filter( 'elementor/files/file_name', 'remove_special_characters_from_file_name' );

このコードは、ファイル名から特殊文字を削除するフィルタを提供しています。

サンプルコード 4

function custom_download_file_name( $file_name ) {
    return str_replace(' ', '-', $file_name);
}
add_filter( 'elementor/files/file_name', 'custom_download_file_name' );

このコードは、ファイル名のスペースをハイフンに置き換えることで、URLの整形を目的としています。

サンプルコード 5

function format_image_file_name( $file_name ) {
    return strtolower($file_name);
}
add_filter( 'elementor/files/file_name', 'format_image_file_name' );

このコードは、ファイル名をすべて小文字に変換するフィルタを設定しています。これにより、一貫性のあるファイル名が保たれます。

概要

構文