Filter hook 'date_query_valid_columns'

in WP Core File wp-includes/class-wp-date-query.php at line 510

View Source

date_query_valid_columns

Filter Hook
Description
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.