Bricks 中文文档：bricks/dynamic_data/allowed_keys

前言

Bricks 1.4 引入了新的 bricks/database/update_template_data 钩子，允许你在 Bricks 更新数据库中现有模板之前修改模板数据。

用法

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

add_filter( 'bricks/dynamic_data/allowed_keys', function( $allowed_keys ) {
    // Add 'limit' as an allowed argument key
    $allowed_keys[] = 'limit';


    return $allowed_keys;
} );

参数

• $allowed_keys (array)：允许的参数键数组。默认包含 fallback、fallback-image、sanitize、exclude、start-at、pad、key、is-array、date、from、to。

示例代码

筛选返回值

add_filter( 'bricks/dynamic_data/allowed_keys', function( $allowed_keys ) {
    // Add 'limit' as an allowed argument key
    $allowed_keys[] = 'limit';


    return $allowed_keys;
} );

根据条件短路返回原值

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

add_filter( 'bricks/dynamic_data/allowed_keys', function( $value, $allowed_keys ) {
    if ( is_admin() ) { return $value; }
    // TODO: custom logic here
    return $value;
} );

补充说明

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