Merge pull request #1862 from WordPress/publish/3.9.0

westonruter · web-flow · commit 91bc26df4336 · 2025-02-13T11:10:43.000-08:00
Prepare 3.9.0 release
diff --git a/README.md b/README.md
@@ -15,6 +15,7 @@ Plugin                          | Slug                      | Experimental | Lin
 [Image Placeholders][1]         | `dominant-color-images`   | No           | [Source][9],  [Issues][17], [PRs][25]
 [Image Prioritizer][7]          | `image-prioritizer`       | No           | [Source][15], [Issues][23], [PRs][31]
 [Modern Image Formats][2]       | `webp-uploads`            | No           | [Source][10], [Issues][18], [PRs][26]
+[Optimization Detective][33]    | `optimization-detective`  | No           | [Source][34], [Issues][35], [PRs][36]
 [Performant Translations][3]    | `performant-translations` | No           | [Source][11], [Issues][19], [PRs][27]
 [Speculative Loading][4]        | `speculation-rules`       | No           | [Source][12], [Issues][20], [PRs][28]
 [Enhanced Responsive Images][6] | `auto-sizes`              | Yes          | [Source][14], [Issues][22], [PRs][30]
@@ -28,6 +29,7 @@ Plugin                          | Slug                      | Experimental | Lin
 [6]: https://wordpress.org/plugins/auto-sizes/
 [7]: https://wordpress.org/plugins/image-prioritizer/
 [8]: https://wordpress.org/plugins/web-worker-offloading/
+[33]: https://wordpress.org/plugins/optimization-detective/
 
 [9]: https://github.com/WordPress/performance/tree/trunk/plugins/dominant-color-images
 [10]: https://github.com/WordPress/performance/tree/trunk/plugins/webp-uploads
@@ -37,6 +39,7 @@ Plugin                          | Slug                      | Experimental | Lin
 [14]: https://github.com/WordPress/performance/tree/trunk/plugins/auto-sizes
 [15]: https://github.com/WordPress/performance/tree/trunk/plugins/image-prioritizer
 [16]: https://github.com/WordPress/performance/tree/trunk/plugins/web-worker-offloading
+[34]: https://github.com/WordPress/performance/tree/trunk/plugins/optimization-detective
 
 [17]: https://github.com/WordPress/performance/issues?q=is%3Aopen+label%3A%22%5BPlugin%5D+Image+Placeholders%22
 [18]: https://github.com/WordPress/performance/issues?q=is%3Aopen+label%3A%22%5BPlugin%5D+Modern+Image+Formats%22
@@ -46,6 +49,7 @@ Plugin                          | Slug                      | Experimental | Lin
 [22]: https://github.com/WordPress/performance/issues?q=is%3Aopen+label%3A%22%5BPlugin%5D+Enhanced+Responsive+Images%22
 [23]: https://github.com/WordPress/performance/issues?q=is%3Aopen+label%3A%22%5BPlugin%5D+Image+Prioritizer%22
 [24]: https://github.com/WordPress/performance/issues?q=is%3Aopen%20label%3A%22%5BPlugin%5D%20Web%20Worker%20Offloading%22
+[35]: https://github.com/WordPress/performance/issues?q=is%3Aopen%20label%3A%22%5BPlugin%5D%20Optimization%20Detective%22
 
 [25]: https://github.com/WordPress/performance/pulls?q=is%3Apr+is%3Aopen+label%3A%22%5BPlugin%5D+Image+Placeholders%22
 [26]: https://github.com/WordPress/performance/pulls?q=is%3Apr+is%3Aopen+label%3A%22%5BPlugin%5D+Modern+Image+Formats%22
@@ -55,5 +59,6 @@ Plugin                          | Slug                      | Experimental | Lin
 [30]: https://github.com/WordPress/performance/pulls?q=is%3Apr+is%3Aopen+label%3A%22%5BPlugin%5D+Enhanced+Responsive+Images%22
 [31]: https://github.com/WordPress/performance/pulls?q=is%3Apr+is%3Aopen+label%3A%22%5BPlugin%5D+Image+Prioritizer%22
 [32]: https://github.com/WordPress/performance/pulls?q=is%3Apr+is%3Aopen+label%3A%22%5BPlugin%5D+Web%20Worker%20Offloading%22
+[36]: https://github.com/WordPress/performance/pulls?q=is%3Apr+is%3Aopen+label%3A%22%5BPlugin%5D+Optimization%20Detective%22
 
 Note that the plugin names sometimes diverge from the plugin slugs due to scope changes. For example, a plugin's purpose may change as some of its features are merged into WordPress core.
diff --git a/plugins/embed-optimizer/load.php b/plugins/embed-optimizer/load.php
@@ -5,7 +5,7 @@
  * Description: Optimizes the performance of embeds through lazy-loading, preconnecting, and reserving space to reduce layout shifts.
  * Requires at least: 6.6
  * Requires PHP: 7.2
- * Version: 0.4.1
+ * Version: 1.0.0-beta1
  * Author: WordPress Performance Team
  * Author URI: https://make.wordpress.org/performance/
  * License: GPLv2 or later
@@ -71,7 +71,7 @@ static function ( string $global_var_name, string $version, Closure $load ): voi
 	}
 )(
 	'embed_optimizer_pending_plugin',
-	'0.4.1',
+	'1.0.0-beta1',
 	static function ( string $version ): void {
 		if ( defined( 'EMBED_OPTIMIZER_VERSION' ) ) {
 			return;
diff --git a/plugins/embed-optimizer/readme.txt b/plugins/embed-optimizer/readme.txt
@@ -2,7 +2,7 @@
 
 Contributors: wordpressdotorg
 Tested up to: 6.7
-Stable tag:   0.4.1
+Stable tag:   1.0.0-beta1
 License:      GPLv2 or later
 License URI:  https://www.gnu.org/licenses/gpl-2.0.html
 Tags:         performance, embeds
@@ -67,6 +67,13 @@ The [plugin source code](https://github.com/WordPress/performance/tree/trunk/plu
 
 == Changelog ==
 
+= 1.0.0-beta1 =
+
+**Enhancements**
+
+* Bump version to 1.0.0-beta1 to indicate graduation from being experimental. See [1846](https://github.com/WordPress/performance/pull/1846).
+* Use CSS range syntax in media queries. ([1833](https://github.com/WordPress/performance/pull/1833))
+
 = 0.4.1 =
 
 **Bug Fixes**
diff --git a/plugins/image-prioritizer/class-image-prioritizer-img-tag-visitor.php b/plugins/image-prioritizer/class-image-prioritizer-img-tag-visitor.php
@@ -412,7 +412,7 @@ private function sizes_attribute_includes_valid_auto( string $sizes_attr ): bool
 	/**
 	 * Computes responsive sizes for the current element based on its boundingClientRect width captured in URL Metrics.
 	 *
-	 * @since n.e.x.t
+	 * @since 1.0.0
 	 *
 	 * @param OD_Tag_Visitor_Context $context Context.
 	 * @return non-empty-string[] Computed sizes.
diff --git a/plugins/image-prioritizer/load.php b/plugins/image-prioritizer/load.php
@@ -6,7 +6,7 @@
  * Requires at least: 6.6
  * Requires PHP: 7.2
  * Requires Plugins: optimization-detective
- * Version: 0.3.1
+ * Version: 1.0.0-beta1
  * Author: WordPress Performance Team
  * Author URI: https://make.wordpress.org/performance/
  * License: GPLv2 or later
@@ -72,7 +72,7 @@ static function ( string $global_var_name, string $version, Closure $load ): voi
 	}
 )(
 	'image_prioritizer_pending_plugin',
-	'0.3.1',
+	'1.0.0-beta1',
 	static function ( string $version ): void {
 		if ( defined( 'IMAGE_PRIORITIZER_VERSION' ) ) {
 			return;
diff --git a/plugins/image-prioritizer/readme.txt b/plugins/image-prioritizer/readme.txt
@@ -2,7 +2,7 @@
 
 Contributors: wordpressdotorg
 Tested up to: 6.7
-Stable tag:   0.3.1
+Stable tag:   1.0.0-beta1
 License:      GPLv2 or later
 License URI:  https://www.gnu.org/licenses/gpl-2.0.html
 Tags:         performance, optimization, image, lcp, lazy-load
@@ -72,6 +72,13 @@ The [plugin source code](https://github.com/WordPress/performance/tree/trunk/plu
 
 == Changelog ==
 
+= 1.0.0-beta1 =
+
+**Enhancements**
+
+* Bump version to 1.0.0-beta1 to indicate graduation from being experimental. See [1846](https://github.com/WordPress/performance/pull/1846).
+* Compute responsive `sizes` attribute based on the `width` from the `boundingClientRect` in captured URL Metrics. ([1840](https://github.com/WordPress/performance/pull/1840))
+
 = 0.3.1 =
 
 **Bug Fixes**
diff --git a/plugins/optimization-detective/class-od-tag-visitor-context.php b/plugins/optimization-detective/class-od-tag-visitor-context.php
@@ -54,7 +54,7 @@ final class OD_Tag_Visitor_Context {
 	 *
 	 * May be null if no post has been created yet.
 	 *
-	 * @since n.e.x.t
+	 * @since 1.0.0
 	 * @var positive-int|null
 	 */
 	private $url_metrics_id;
diff --git a/plugins/optimization-detective/class-od-url-metric-group-collection.php b/plugins/optimization-detective/class-od-url-metric-group-collection.php
@@ -202,7 +202,7 @@ public function get_current_etag(): string {
 	/**
 	 * Gets the breakpoints in max widths.
 	 *
-	 * @since n.e.x.t
+	 * @since 1.0.0
 	 *
 	 * @return positive-int[] Breakpoints in max widths.
 	 */
@@ -213,7 +213,7 @@ public function get_breakpoints(): array {
 	/**
 	 * Gets the sample size for URL Metrics for a given breakpoint.
 	 *
-	 * @since n.e.x.t
+	 * @since 1.0.0
 	 *
 	 * @return int<1, max> Sample size for URL Metrics for a given breakpoint.
 	 */
@@ -224,7 +224,7 @@ public function get_sample_size(): int {
 	/**
 	 * Gets the freshness age (TTL) for a given URL Metric..
 	 *
-	 * @since n.e.x.t
+	 * @since 1.0.0
 	 *
 	 * @return int<0, max> Freshness age (TTL) for a given URL Metric.
 	 */
diff --git a/plugins/optimization-detective/class-od-url-metric-group.php b/plugins/optimization-detective/class-od-url-metric-group.php
@@ -212,7 +212,7 @@ public function get_freshness_ttl(): int {
 	/**
 	 * Gets the collection that this group is a part of.
 	 *
-	 * @since n.e.x.t
+	 * @since 1.0.0
 	 *
 	 * @todo Eliminate in favor of readonly public property.
 	 * @return OD_URL_Metric_Group_Collection Collection.
diff --git a/plugins/optimization-detective/class-od-url-metric.php b/plugins/optimization-detective/class-od-url-metric.php
@@ -176,7 +176,7 @@ public function set_group( OD_URL_Metric_Group $group ): void {
 	 *
 	 * @since 0.1.0
 	 * @since 0.9.0 Added the 'etag' property to the schema.
-	 * @since n.e.x.t The 'etag' property is now required.
+	 * @since 1.0.0 The 'etag' property is now required.
 	 *
 	 * @todo Cache the return value?
 	 *
@@ -451,7 +451,7 @@ public function get_uuid(): string {
 	 * Gets ETag.
 	 *
 	 * @since 0.9.0
-	 * @since n.e.x.t No longer returns null as 'etag' is now required.
+	 * @since 1.0.0 No longer returns null as 'etag' is now required.
 	 *
 	 * @return non-empty-string ETag.
 	 */
diff --git a/plugins/optimization-detective/readme.txt b/plugins/optimization-detective/readme.txt
@@ -57,6 +57,26 @@ The [plugin source code](https://github.com/WordPress/performance/tree/trunk/plu
 
 = 1.0.0-beta2 =
 
+**Enhancements**
+
+* Account for 64 KiB limit for sending beacon data. ([1851](https://github.com/WordPress/performance/pull/1851))
+* Add post ID for the `od_url_metrics` post to the tag visitor context. ([1847](https://github.com/WordPress/performance/pull/1847))
+* Change minimum viewport width to be exclusive whereas the maximum width remains inclusive. ([1839](https://github.com/WordPress/performance/pull/1839))
+* Disable URL Metric storage locking by default for administrators. ([1835](https://github.com/WordPress/performance/pull/1835))
+* Include active plugins in ETag data and increase default freshness TTL from 1 day to 1 week. ([1854](https://github.com/WordPress/performance/pull/1854))
+* Make ETag a required property of the URL Metric. ([1824](https://github.com/WordPress/performance/pull/1824))
+* Use CSS range syntax in media queries. ([1833](https://github.com/WordPress/performance/pull/1833))
+* Use `IFRAME` to display HTML responses for REST API storage request failures in Site Health test. ([1849](https://github.com/WordPress/performance/pull/1849))
+
+**Bug Fixes**
+
+* Prevent URL in `Link` header from including invalid characters. ([1802](https://github.com/WordPress/performance/pull/1802))
+* Prevent optimizing post previews by default. ([1848](https://github.com/WordPress/performance/pull/1848))
+
+**Documentation**
+
+* Improve Optimization Detective documentation. ([1782](https://github.com/WordPress/performance/pull/1782))
+
 = 1.0.0-beta1 =
 
 **Enhancements**
diff --git a/plugins/optimization-detective/storage/class-od-storage-lock.php b/plugins/optimization-detective/storage/class-od-storage-lock.php
@@ -23,15 +23,15 @@ final class OD_Storage_Lock {
 	/**
 	 * Capability for being able to store a URL Metric now.
 	 *
-	 * @since n.e.x.t
+	 * @since 1.0.0
 	 * @var string
 	 */
 	const STORE_URL_METRIC_NOW_CAPABILITY = 'od_store_url_metric_now';
 
 	/**
 	 * Adds hooks.
 	 *
-	 * @since n.e.x.t
+	 * @since 1.0.0
 	 */
 	public static function add_hooks(): void {
 		add_filter( 'user_has_cap', array( __CLASS__, 'filter_user_has_cap' ) );
@@ -40,7 +40,7 @@ public static function add_hooks(): void {
 	/**
 	 * Filters `user_has_cap` to grant the `od_store_url_metric_now` capability to users who can `manage_options` by default.
 	 *
-	 * @since n.e.x.t
+	 * @since 1.0.0
 	 *
 	 * @param array<string, bool>|mixed $allcaps Capability names mapped to boolean values for whether the user has that capability.
 	 * @return array<string, bool> Capability names mapped to boolean values for whether the user has that capability.
diff --git a/plugins/optimization-detective/storage/class-od-url-metric-store-request-context.php b/plugins/optimization-detective/storage/class-od-url-metric-store-request-context.php
@@ -39,7 +39,7 @@ final class OD_URL_Metric_Store_Request_Context {
 	 *
 	 * This was originally $post_id which was introduced in 0.7.0.
 	 *
-	 * @since n.e.x.t
+	 * @since 1.0.0
 	 * @var positive-int
 	 */
 	private $url_metrics_id;
@@ -92,7 +92,7 @@ public function __construct( WP_REST_Request $request, int $url_metrics_id, OD_U
 	/**
 	 * Gets a property.
 	 *
-	 * @since n.e.x.t
+	 * @since 1.0.0
 	 *
 	 * @param string $name Property name.
 	 * @return mixed Property value.
@@ -121,7 +121,7 @@ public function __get( string $name ) {
 							__CLASS__ . '::$url_metrics_id'
 						)
 					),
-					'optimization-detective n.e.x.t'
+					'optimization-detective 1.0.0'
 				);
 				return $this->url_metrics_id;
 			default:
diff --git a/plugins/performance-lab/load.php b/plugins/performance-lab/load.php
@@ -5,7 +5,7 @@
  * Description: Performance plugin from the WordPress Performance Team, which is a collection of standalone performance features.
  * Requires at least: 6.6
  * Requires PHP: 7.2
- * Version: 3.8.0
+ * Version: 3.9.0
  * Author: WordPress Performance Team
  * Author URI: https://make.wordpress.org/performance/
  * License: GPLv2 or later
@@ -21,7 +21,7 @@
 }
 // @codeCoverageIgnoreEnd
 
-define( 'PERFLAB_VERSION', '3.8.0' );
+define( 'PERFLAB_VERSION', '3.9.0' );
 define( 'PERFLAB_MAIN_FILE', __FILE__ );
 define( 'PERFLAB_PLUGIN_DIR_PATH', plugin_dir_path( PERFLAB_MAIN_FILE ) );
 define( 'PERFLAB_SCREEN', 'performance-lab' );
diff --git a/plugins/performance-lab/readme.txt b/plugins/performance-lab/readme.txt
@@ -2,7 +2,7 @@
 
 Contributors: wordpressdotorg
 Tested up to: 6.7
-Stable tag:   3.8.0
+Stable tag:   3.9.0
 License:      GPLv2 or later
 License URI:  https://www.gnu.org/licenses/gpl-2.0.html
 Tags:         performance, site health, measurement, optimization, diagnostics
@@ -15,13 +15,14 @@ The Performance Lab plugin is a collection of features focused on enhancing perf
 
 The feature plugins which are currently featured by this plugin are:
 
+* [Embed Optimizer](https://wordpress.org/plugins/embed-optimizer/)
 * [Image Placeholders](https://wordpress.org/plugins/dominant-color-images/)
+* [Image Prioritizer](https://wordpress.org/plugins/image-prioritizer/)
 * [Modern Image Formats](https://wordpress.org/plugins/webp-uploads/)
+* [Optimization Detective](https://wordpress.org/plugins/optimization-detective/) (dependency for Embed Optimizer and Image Prioritizer)
 * [Performant Translations](https://wordpress.org/plugins/performant-translations/)
 * [Speculative Loading](https://wordpress.org/plugins/speculation-rules/)
-* [Embed Optimizer](https://wordpress.org/plugins/embed-optimizer/) _(experimental)_
 * [Enhanced Responsive Images](https://wordpress.org/plugins/auto-sizes/) _(experimental)_
-* [Image Prioritizer](https://wordpress.org/plugins/image-prioritizer/) _(experimental)_
 * [Web Worker Offloading](https://wordpress.org/plugins/web-worker-offloading/) _(experimental)_
 
 These plugins can also be installed separately from installing Performance Lab, but having the Performance Lab plugin also active will ensure you find out about new performance features as they are developed.
@@ -71,6 +72,12 @@ Contributions are always welcome! Learn more about how to get involved in the [C
 
 == Changelog ==
 
+= 3.9.0 =
+
+**Enhancements**
+
+* Remove experimental flags from Embed Optimizer and Image Prioritizer. ([1846](https://github.com/WordPress/performance/pull/1846))
+
 = 3.8.0 =
 
 **Enhancements**

Original file line number	Diff line number	Diff line change
`@@ -412,7 +412,7 @@ private function sizes_attribute_includes_valid_auto( string $sizes_attr ): bool`
`412`	`412`	`/**`
`413`	`413`	`* Computes responsive sizes for the current element based on its boundingClientRect width captured in URL Metrics.`
`414`	`414`	`*`
`415`		`- * @since n.e.x.t`
	`415`	`+ * @since 1.0.0`
`416`	`416`	`*`
`417`	`417`	`* @param OD_Tag_Visitor_Context $context Context.`
`418`	`418`	`* @return non-empty-string[] Computed sizes.`
Original file line number	Diff line number	Diff line change
`@@ -54,7 +54,7 @@ final class OD_Tag_Visitor_Context {`
`54`	`54`	`*`
`55`	`55`	`* May be null if no post has been created yet.`
`56`	`56`	`*`
`57`		`- * @since n.e.x.t`
	`57`	`+ * @since 1.0.0`
`58`	`58`	`* @var positive-int\|null`
`59`	`59`	`*/`
`60`	`60`	`private $url_metrics_id;`
Original file line number	Diff line number	Diff line change
`@@ -202,7 +202,7 @@ public function get_current_etag(): string {`
`202`	`202`	`/**`
`203`	`203`	`* Gets the breakpoints in max widths.`
`204`	`204`	`*`
`205`		`- * @since n.e.x.t`
	`205`	`+ * @since 1.0.0`
`206`	`206`	`*`
`207`	`207`	`* @return positive-int[] Breakpoints in max widths.`
`208`	`208`	`*/`
`@@ -213,7 +213,7 @@ public function get_breakpoints(): array {`
`213`	`213`	`/**`
`214`	`214`	`* Gets the sample size for URL Metrics for a given breakpoint.`
`215`	`215`	`*`
`216`		`- * @since n.e.x.t`
	`216`	`+ * @since 1.0.0`
`217`	`217`	`*`
`218`	`218`	`* @return int<1, max> Sample size for URL Metrics for a given breakpoint.`
`219`	`219`	`*/`
`@@ -224,7 +224,7 @@ public function get_sample_size(): int {`
`224`	`224`	`/**`
`225`	`225`	`* Gets the freshness age (TTL) for a given URL Metric..`
`226`	`226`	`*`
`227`		`- * @since n.e.x.t`
	`227`	`+ * @since 1.0.0`
`228`	`228`	`*`
`229`	`229`	`* @return int<0, max> Freshness age (TTL) for a given URL Metric.`
`230`	`230`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -212,7 +212,7 @@ public function get_freshness_ttl(): int {`
`212`	`212`	`/**`
`213`	`213`	`* Gets the collection that this group is a part of.`
`214`	`214`	`*`
`215`		`- * @since n.e.x.t`
	`215`	`+ * @since 1.0.0`
`216`	`216`	`*`
`217`	`217`	`* @todo Eliminate in favor of readonly public property.`
`218`	`218`	`* @return OD_URL_Metric_Group_Collection Collection.`
Original file line number	Diff line number	Diff line change
`@@ -176,7 +176,7 @@ public function set_group( OD_URL_Metric_Group $group ): void {`
`176`	`176`	`*`
`177`	`177`	`* @since 0.1.0`
`178`	`178`	`* @since 0.9.0 Added the 'etag' property to the schema.`
`179`		`- * @since n.e.x.t The 'etag' property is now required.`
	`179`	`+ * @since 1.0.0 The 'etag' property is now required.`
`180`	`180`	`*`
`181`	`181`	`* @todo Cache the return value?`
`182`	`182`	`*`
`@@ -451,7 +451,7 @@ public function get_uuid(): string {`
`451`	`451`	`* Gets ETag.`
`452`	`452`	`*`
`453`	`453`	`* @since 0.9.0`
`454`		`- * @since n.e.x.t No longer returns null as 'etag' is now required.`
	`454`	`+ * @since 1.0.0 No longer returns null as 'etag' is now required.`
`455`	`455`	`*`
`456`	`456`	`* @return non-empty-string ETag.`
`457`	`457`	`*/`