wp_check_for_changed_dates() WordPress Function

The wp_check_for_changed_dates() function is used to check if a date has changed since the last time it was checked. This is useful for checking if a post or page has been updated.

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

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


Description

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 ↑

Parameters

$post_id

(int)(Required)Post ID.

$post

(WP_Post)(Required)The Post Object

$post_before

(WP_Post)(Required)The Previous Post Object


Top ↑

Source

File: wp-includes/post.php

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 ) {
		return;
	}

	// 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 ) ) {
		return;
	}

	$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 ↑

Changelog

Changelog
VersionDescription
4.9.3Introduced.

The content displayed on this page has been created in part by processing WordPress source code files which are made available under the GPLv2 (or a later version) license by theĀ Free Software Foundation. In addition to this, the content includes user-written examples and information. All material is subject to review and curation by the WPPaste.com community.

Show More
Show More