钩子文档

block_editor_preload_paths

💡 云策文档标注

概述

block_editor_preload_paths 是一个已弃用的过滤器,用于预加载块编辑器所需的 REST API 路径数组。在 WordPress 5.8.0 中,它被 block_editor_rest_api_preload_paths 过滤器取代。

关键要点

  • 过滤器用于修改预加载的 REST API 路径数组,以优化块编辑器性能。
  • 接受两个参数:$preload_paths(路径数组)和 $selected_post(正在编辑的 WP_Post 对象)。
  • 自 WordPress 5.8.0 起已弃用,建议使用 block_editor_rest_api_preload_paths 过滤器。
  • 相关函数 block_editor_rest_api_preload() 用于在块编辑器上下文中预加载数据。

注意事项

此过滤器已弃用,新开发应避免使用,转而使用 block_editor_rest_api_preload_paths 过滤器。


📄 原文内容

Filters the array of paths that will be preloaded.

Description

Preload common data by specifying an array of REST API paths that will be preloaded.

Parameters

$preload_paths(string|string[])[]
Array of paths to preload.
$selected_postWP_Post
Post being edited.

Source

$preload_paths = apply_filters_deprecated( 'block_editor_preload_paths', array( $preload_paths, $selected_post ), '5.8.0', 'block_editor_rest_api_preload_paths' );

Changelog

Version Description
5.8.0 Deprecated. Use the ‘block_editor_rest_api_preload_paths’ filter instead.
5.0.0 Introduced.