钩子文档

postmeta_form_keys

💡 云策文档标注

概述

postmeta_form_keys 过滤器用于自定义“自定义字段”元框中元键下拉列表的值,通过返回非空值可以避免对 postmeta 表的昂贵查询。

关键要点

  • 过滤器名称:postmeta_form_keys
  • 主要用途:过滤或预定义元键,以优化性能
  • 参数:$keys(数组或 null,默认 null)和 $post(WP_Post 对象)
  • 返回值:非空值将短路查询,否则执行默认查询

代码示例

$keys = apply_filters( 'postmeta_form_keys', null, $post );

注意事项

  • 引入版本:4.4.0
  • 相关函数:meta_form() 用于打印表单

📄 原文内容

Filters values for the meta key dropdown in the Custom Fields meta box.

Description

Returning a non-null value will effectively short-circuit and avoid a potentially expensive query against postmeta.

Parameters

$keysarray|null
Pre-defined meta keys to be used in place of a postmeta query. Default null.
$postWP_Post
The current post object.

Source

$keys = apply_filters( 'postmeta_form_keys', null, $post );

Changelog

Version Description
4.4.0 Introduced.