Enable wp_update_nav_menu_item to use passed values for setting post_date

[jmdodd]

When a nav menu item is imported, it is given the post_date "now" rather than the value in the export file. There is currently no simple mechanism for setting the post_date for a nav menu item in wp_update_nav_menu_item, even though this value is useful for post_exists checks.

This change will allow the WordPress importer to pass the export file post_date value through wp_update_nav_menu_item, improving performance of post_exists for nav menu items.

This requires the new function resolve_post_date proposed in #52187.

[mukesh27]

Hi @jmdodd, Where I check the resolve_post_date function? I can't found this function in WordPress.

[mukesh27]

Got the new function on the #52187 ticket.

[jmdodd]

Updated patch (now using wp_resolve_post_date) with unit tests for menu date values.

[jmdodd]

52189.1.diff avoids insert failures and defaults to using "now", as previously wp_update_nav_menu_item would not fail because of a bad date. I've added unit tests to assert this behavior.

[audrasjb]

I tested the patch and it looks good and relevant to me.
Indeed, it can be useful in some cases to get the post date, especially in custom nav menu walkers.

I'm marking this for commit.

Also adding needs-dev-note workflow keyword to make sure we don't forget to mention it in the Miscellaneous changes dev note :)

[pento]

In 50013:

Menus: Make use of wp_resolve_post_date() when updating menu items.

This allows a menu item post_date to be set to particular value, rather than only allowing it to be set to "now". In particular, the WordPress Importer can use this to perform faster, more accurate duplicate checks.

Props jmdodd.
Fixes #52189.

[TimothyBlynJacobs]

It looks like the tests are introducing a phpcs error due to the usage of date instead of gmdate.

​https://github.com/WordPress/wordpress-develop/runs/1759066474

[pento]

In 50014:

Menus: Fix linting errors introduced in [50013].

Props TimothyBlynJacobs.
Fixes #52189.

[audrasjb]

Dev note published: ​https://make.wordpress.org/core/2021/02/23/enhancements-to-the-import-export-feature-in-wordpress-5-7/