钩子文档

should_load_remote_block_patterns

💡 云策文档标注

概述

should_load_remote_block_patterns 是一个 WordPress 过滤器,用于控制是否加载远程区块模式。开发者可以通过此过滤器禁用或基于条件启用远程模式加载。

关键要点

  • 过滤器名称:should_load_remote_block_patterns
  • 参数:$should_load_remote(布尔值),默认值为 true
  • 用途:禁用或限制远程区块模式的加载,例如基于用户权限
  • 相关函数:_register_remote_theme_patterns()、_load_remote_featured_patterns()、_load_remote_block_patterns()
  • 引入版本:5.8.0

代码示例

add_filter( 'should_load_remote_block_patterns', 'limit_access_load_remote_block_patterns' );

function limit_access_load_remote_block_patterns() 
{
    return current_user_can( 'activate_plugins' );
}

注意事项

此过滤器可用于增强安全性或控制资源使用,例如限制仅管理员可访问远程模式。


📄 原文内容

Filter to disable remote block patterns.

Parameters

$should_load_remotebool

Source

$should_load_remote = apply_filters( 'should_load_remote_block_patterns', true );

Changelog

Version Description
5.8.0 Introduced.

User Contributed Notes

  1. Skip to note 2 content

    If you want to limit access to the remote block patterns to only admins, you can do so by verifying the capabilities of the user:

    add_filter( 'should_load_remote_block_patterns', 'limit_access_load_remote_block_patterns' );
    
    function limit_access_load_remote_block_patterns() 
    {
    	return current_user_can( 'activate_plugins' );
    }