wp_check_for_changed_dates( int $post_id, WP_Post $post, WP_Post $post_before )

Checks for changed dates for published post objects and save the old date.


The function is used when a post object of any type is updated, by comparing the current and previous post objects.

If the date was changed and not already part of the old dates then it will be added to the post meta field (‘_wp_old_date’) for storing old dates for that post.

The most logically usage of this function is redirecting changed post objects, so that those that linked to an changed post will be redirected to the new post.

Top ↑


$post_id int Required
Post ID.
$post WP_Post Required
The post object.
$post_before WP_Post Required
The previous post object.

Top ↑


File: wp-includes/post.php. View all references

function wp_check_for_changed_dates( $post_id, $post, $post_before ) {
	$previous_date = gmdate( 'Y-m-d', strtotime( $post_before->post_date ) );
	$new_date      = gmdate( 'Y-m-d', strtotime( $post->post_date ) );

	// Don't bother if it hasn't changed.
	if ( $new_date == $previous_date ) {

	// We're only concerned with published, non-hierarchical objects.
	if ( ! ( 'publish' === $post->post_status || ( 'attachment' === get_post_type( $post ) && 'inherit' === $post->post_status ) ) || is_post_type_hierarchical( $post->post_type ) ) {

	$old_dates = (array) get_post_meta( $post_id, '_wp_old_date' );

	// If we haven't added this old date before, add it now.
	if ( ! empty( $previous_date ) && ! in_array( $previous_date, $old_dates, true ) ) {
		add_post_meta( $post_id, '_wp_old_date', $previous_date );

	// If the new slug was used previously, delete it from the list.
	if ( in_array( $new_date, $old_dates, true ) ) {
		delete_post_meta( $post_id, '_wp_old_date', $new_date );

Top ↑


Version Description
4.9.3 Introduced.

Top ↑

User Contributed Notes

You must log in before being able to contribute a note or feedback.