Bricks 中文文档：bricks/form/submission-table/file_url

标签TAGS:

2026年8月30日

📄 原始资料 | 展开查看原始 JSON（bricks-form-submission-table-file_url.json）{ “name”: “bricks/form/submission-table/file_url”, “kind”: “filter”, “url”: “https://academy.bricksbuilder.io/developer/hooks/filters/bricks-form-submission-table-file_url/”, “scraped_at”: “2026-08-29”, “hook_name”: “bricks/…

📄 原始资料 | 展开查看原始 JSON（bricks-form-submission-table-file_url.json）

{
  "name": "bricks/form/submission-table/file_url",
  "kind": "filter",
  "url": "https://academy.bricksbuilder.io/developer/hooks/filters/bricks-form-submission-table-file_url/",
  "scraped_at": "2026-08-29",
  "hook_name": "bricks/form/submission-table/file_url",
  "description": {
    "en": "Filters the URL of an uploaded file displayed in the Form Submissions table in the admin area. This is useful if you have customized the upload directory and the auto-generated URL is incorrect.",
    "zh": "此筛选器允许你控制在哪些页面 Bricks 应运行查询筛选索引器。"
  },
  "parameters": [
    {
      "name": "file_url",
      "type": "string",
      "type_zh": null,
      "description": {
        "en": "The generated URL for the file.",
        "zh": "已生成的文件 URL。"
      }
    },
    {
      "name": "file",
      "type": "array",
      "type_zh": null,
      "description": {
        "en": "Array containing file information (e.g., file path, name , type ).",
        "zh": "包含文件信息的数组（例如文件路径、name、type）。"
      }
    },
    {
      "name": "field_key",
      "type": "string",
      "type_zh": null,
      "description": {
        "en": "The ID of the form field.",
        "zh": "表单字段的 ID。"
      }
    }
  ],
  "example_usage": "add_filter( 'bricks/form/submission-table/file_url', function( $file_url, $file, $field_key ) {\n    // Example: Fix URL for files in a custom 'secure-uploads' directory\n    if ( strpos( $file['file'], 'secure-uploads' ) !== false ) {\n        return site_url( '/secure-uploads/' . basename( $file['file'] ) );\n    }\n\n\n    return $file_url;\n}, 10, 3 );"
}

前言

此筛选器允许你控制在哪些页面 Bricks 应运行查询筛选索引器。

用法

将代码加入子主题的 functions.php：

add_filter( 'bricks/form/submission-table/file_url', function( $file_url, $file, $field_key ) {
    // Example: Fix URL for files in a custom 'secure-uploads' directory
    if ( strpos( $file['file'], 'secure-uploads' ) !== false ) {
        return site_url( '/secure-uploads/' . basename( $file['file'] ) );
    }


    return $file_url;
}, 10, 3 );

参数

$file_url (string)：已生成的文件 URL。
$file (array)：包含文件信息的数组（例如文件路径、name、type）。
$field_key (string)：表单字段的 ID。

示例代码

筛选返回值

add_filter( 'bricks/form/submission-table/file_url', function( $file_url, $file, $field_key ) {
    // Example: Fix URL for files in a custom 'secure-uploads' directory
    if ( strpos( $file['file'], 'secure-uploads' ) !== false ) {
        return site_url( '/secure-uploads/' . basename( $file['file'] ) );
    }


    return $file_url;
}, 10, 3 );

根据条件短路返回原值

根据条件跳过或修改返回值：

add_filter( 'bricks/form/submission-table/file_url', function( $value, $file_url ) {
    if ( is_admin() ) { return $value; }
    // TODO: custom logic here
    return $value;
} );

补充说明

更多细节可参考官方文档。