date_query_valid_columns
Filter HookDescription
Filters the list of valid date query columns.Hook Information
File Location |
wp-includes/class-wp-date-query.php
View on GitHub
|
Hook Type | Filter |
Line Number | 510 |
Hook Parameters
Type | Name | Description |
---|---|---|
string[]
|
$valid_columns
|
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'. |
Usage Examples
Basic Usage
<?php
// Hook into date_query_valid_columns
add_filter('date_query_valid_columns', 'my_custom_filter', 10, 1);
function my_custom_filter($valid_columns) {
// Your custom filtering logic here
return $valid_columns;
}
Source Code Context
wp-includes/class-wp-date-query.php:510
- How this hook is used in WordPress core
<?php
505 * @param string[] $valid_columns An array of valid date query columns. Defaults
506 * are 'post_date', 'post_date_gmt', 'post_modified',
507 * 'post_modified_gmt', 'comment_date', 'comment_date_gmt',
508 * 'user_registered', 'registered', 'last_updated'.
509 */
510 if ( ! in_array( $column, apply_filters( 'date_query_valid_columns', $valid_columns ), true ) ) {
511 $column = 'post_date';
512 }
513
514 $known_columns = array(
515 $wpdb->posts => array(
PHP Documentation
<?php
/**
* Filters the list of valid date query columns.
*
* @since 3.7.0
* @since 4.1.0 Added 'user_registered' to the default recognized columns.
* @since 4.6.0 Added 'registered' and 'last_updated' to the default recognized columns.
*
* @param string[] $valid_columns 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'.
*/
Quick Info
- Hook Type: Filter
- Parameters: 1
- File: wp-includes/class-wp-date-query.php
Related Hooks
Related hooks will be displayed here in future updates.