date_query_valid_columns
云策文档标注
概述
date_query_valid_columns 是一个 WordPress 过滤器，用于修改 WP_Date_Query 中有效的日期查询列列表。开发者可以通过此过滤器添加或移除允许的列名，以扩展或限制日期查询功能。
关键要点
- 过滤器名称：date_query_valid_columns
- 参数：$valid_columns（字符串数组），包含默认有效的日期查询列，如 'post_date'、'post_date_gmt'、'post_modified'、'post_modified_gmt'、'comment_date'、'comment_date_gmt'、'user_registered'、'registered'、'last_updated'
- 用途：在 WP_Date_Query::validate_column() 中验证列名参数时使用，确保查询列有效
- 版本历史：从 WordPress 3.7.0 引入，4.1.0 添加 'user_registered'，4.6.0 添加 'registered' 和 'last_updated' 到默认列
原文内容
Filters the list of valid date query columns.
Parameters
$valid_columnsstring[]-
An array of valid date query columns. Defaults are
'post_date','post_date_gmt','post_modified','post_modified_gmt','comment_date','comment_date_gmt','user_registered','registered','last_updated'.
Source
if ( ! in_array( $column, apply_filters( 'date_query_valid_columns', $valid_columns ), true ) ) {