acf_get_file_input()

WordPressのacf_get_file_input()関数は、Advanced Custom Fields（ACF）プラグインで使用される関数で、ファイルアップロードフィールドのHTML入力要素を生成します。

構文

acf_get_file_input( array $args = array() );

引数の説明:

• $args (array) — ファイル入力フィールドの設定を指定する配列。以下のキーを持つことができます：
  • 'id' (string) — 入力フィールドのID属性。
  • 'class' (string) — 入力フィールドのクラス属性。
  • 'name' (string) — 入力フィールドの名前属性。
  • 'value' (string) — 入力フィールドの値（ファイルのURLなど）。
  • 'mime_types' (string) — 許可されるMIMEタイプを指定します。

例1: 基本的なファイル入力フィールドの生成

この例では、シンプルなファイルアップロードフィールドを生成します。

<?php echo acf_get_file_input( array( 'name' => 'my_file_upload' ) ); ?>

例2: カスタムIDとクラスを持つファイル入力フィールド

この例では、カスタムIDとクラスを持つファイル入力フィールドを生成します。

<?php echo acf_get_file_input( array( 'id' => 'custom-file-input', 'class' => 'my-custom-class', 'name' => 'my_file_upload' ) ); ?>

例3: 特定のMIMEタイプを許可するファイル入力フィールド

この例では、画像ファイルのみを許可するファイル入力フィールドを生成します。

<?php echo acf_get_file_input( array( 'name' => 'image_upload', 'mime_types' => 'jpg, png, gif' ) ); ?>

例4: 既存のファイルをデフォルト値として設定

この例では、既存のファイルのURLをデフォルト値として設定します。

<?php echo acf_get_file_input( array( 'name' => 'existing_file', 'value' => 'https://example.com/path/to/file.jpg' ) ); ?>

例5: 複数の属性を指定したファイル入力フィールド

この例では、複数の属性を指定してファイル入力フィールドを生成します。

<?php echo acf_get_file_input( array( 'id' => 'multi-attr-input', 'class' => 'file-upload-class', 'name' => 'multi_attr_file', 'value' => 'https://example.com/file.pdf', 'mime_types' => 'pdf, doc' ) ); ?>

例6: フィールドの名前を動的に設定

この例では、フィールドの名前を動的に設定します。

<?php echo acf_get_file_input( array( 'name' => 'dynamic_field_' . get_the_ID() ) ); ?>

例7: カスタムデータ属性を追加

この例では、カスタムデータ属性を追加します。

<?php echo acf_get_file_input( array( 'name' => 'file_with_data', 'data-custom' => 'custom_value' ) ); ?>

例8: フィールドの値を動的に設定

この例では、フィールドの値を動的に設定します。

<?php echo acf_get_file_input( array( 'name' => 'dynamic_value_field', 'value' => get_field( 'existing_file_field' ) ) ); ?>

注意点

• この関数はACFプラグインが有効になっている場合にのみ使用できます。
• ファイルアップロードフィールドを使用する際は、適切なMIMEタイプを指定することが重要です。
• 動的な値や属性を使用する場合は、セキュリティに注意してください。