diff --git a/wp-includes/media.php b/wp-includes/media.php index 82ea8f27ed..e16e5c7ff3 100644 --- a/wp-includes/media.php +++ b/wp-includes/media.php @@ -5383,6 +5383,31 @@ function wp_maybe_generate_attachment_metadata( $attachment ) { function attachment_url_to_postid( $url ) { global $wpdb; + /** + * Filters the attachment ID to allow short-circuit the function. + * + * Allows plugins to short-circuit attachment ID lookups. Plugins making + * use of this function should return: + * + * - 0 (integer) to indicate the attachment is not found, + * - attachment ID (integer) to indicate the attachment ID found, + * - null to indicate WordPress should proceed with the lookup. + * + * Warning: The post ID may be null or zero, both of which cast to a + * boolean false. For information about casting to booleans see the + * {@link https://www.php.net/manual/en/language.types.boolean.php PHP documentation}. + * Use the === operator for testing the post ID when developing filters using + * this hook. + * + * @param int|null $post_id The result of the post ID lookup. Null to indicate + * no lookup has been attempted. Default null. + * @param string $url The URL being looked up. + */ + $post_id = apply_filters( 'pre_attachment_url_to_postid', null, $url ); + if ( null !== $post_id ) { + return (int) $post_id; + } + $dir = wp_get_upload_dir(); $path = $url; diff --git a/wp-includes/version.php b/wp-includes/version.php index dab55e8b23..bbc313f247 100644 --- a/wp-includes/version.php +++ b/wp-includes/version.php @@ -16,7 +16,7 @@ * * @global string $wp_version */ -$wp_version = '6.7-alpha-59117'; +$wp_version = '6.7-alpha-59118'; /** * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.