← All changes | includes/modules/ResourceHints/ResourceHintsModule.php +24 -15 1.3.1 → 1.3.7 View file →

		@@ -59,9 +59,10 @@
59	59	return array(
60	60	'label' => __( 'Resource Hints', 'xspeed' ),
61	61	'tab_label' => __( 'Hints', 'xspeed' ), // its own tab on the Resource Hints page
62	62	'icon' => 'Zap',
63		- 'description' => __( 'Preload the LCP hero image and preconnect to font hosts so the largest element paints sooner.', 'xspeed' ),
	63	+ 'description' => __( 'Tells the browser to fetch the main image and fonts early.', 'xspeed' ),
	64	+ 'group' => 'performance',
64	65	// Host page: Hints (this module) + a Speculation Rules section
65	66	// (SmartPredict, Pro). SmartPredict prefetches the next page in
66	67	// the visitor's browser — same family as preload/preconnect, so
67	68	// it belongs here, not under AI (FBS-83633).
		@@ -73,16 +74,17 @@
73	74	return array(
74	75	'enabled' => array(
75	76	'type' => 'bool',
76	77	'default' => true,
77		- 'label' => __( 'Enable Resource Hints', 'xspeed' ),
78		- 'description' => __( 'Master switch for the LCP-image preload + preconnect resource hints. On by default — these are safe, no-config optimizations that help every theme.', 'xspeed' ),
	78	+ 'label' => __( 'Enable resource hints', 'xspeed' ),
	79	+ 'description' => __( 'Turns on all the hints below. They are safe on every theme, so this is on by default.', 'xspeed' ),
79	80	),
80	81	'lcp_preload' => array(
81	82	'type' => 'bool',
82	83	'default' => true,
83		- 'label' => __( 'Preload LCP Image', 'xspeed' ),
84		- 'description' => __( 'Detect the largest above-the-fold image and emit a <link rel="preload" as="image" fetchpriority="high"> in the head, plus fetchpriority="high" on the image. This is the highest-impact fix for Largest Contentful Paint — it beats any lazy-load the theme applied.', 'xspeed' ),
	84	+ 'label' => __( 'Preload the main image', 'xspeed' ),
	85	+ 'description' => __( 'Finds the largest image at the top of the page and tells the browser to fetch it first. This usually gives the biggest LCP gain.', 'xspeed' ),
	86	+ 'dependsOn' => array( 'field' => 'enabled' ),
85	87	),
86	88	'lcp_image_count' => array(
87	89	'type' => 'int',
88	90	'default' => 1,
		@@ -87,37 +89,44 @@
87	89	'type' => 'int',
88	90	'default' => 1,
89	91	'min' => 0,
90	92	'max' => 3,
91		- 'label' => __( 'Images to Preload', 'xspeed' ),
92		- 'description' => __( 'How many of the first images on the page to preload. 1 is right for most sites (the single hero). Raise it only if the fold shows a small gallery.', 'xspeed' ),
	93	+ 'label' => __( 'Images to preload', 'xspeed' ),
	94	+ 'description' => __( 'How many images at the top of the page to preload. 1 suits most sites; raise it only if the top shows a small gallery.', 'xspeed' ),
	95	+ 'advanced' => true,
	96	+ 'dependsOn' => array( 'field' => 'lcp_preload' ),
93	97	),
94	98	'lcp_exclusions' => array(
95	99	'type' => 'list',
96	100	'default' => array(),
97	101	'item_type' => 'string',
98		- 'label' => __( 'Exclude From Preload', 'xspeed' ),
99		- 'description' => __( 'Substring patterns (filename or class) that, if found in an <img>, exempt it from being treated as the LCP image. Useful for tracking pixels, spacers, or a decorative first image that is not the hero.', 'xspeed' ),
	102	+ 'label' => __( 'Excluded from preload', 'xspeed' ),
	103	+ 'description' => __( 'Images whose tag contains a line here, such as a file name or class, are never picked as the main image. Useful for tracking pixels and spacers.', 'xspeed' ),
	104	+ 'dependsOn' => array( 'field' => 'lcp_preload' ),
100	105	),
101	106	'preload_images' => array(
102	107	'type' => 'list',
103	108	'default' => array(),
104	109	'item_type' => 'string',
105		- 'label' => __( 'Always Preload These Images', 'xspeed' ),
106		- 'description' => __( 'Image URLs (full or site-relative) to preload with high priority on every page. This is the escape hatch for an LCP image the detector cannot see — most often a hero section\'s CSS background-image, which carries none of the signals the automatic pick reads. Keep it to one or two images: preloading many hands them all top network priority and the page itself loses. The first three entries are used.', 'xspeed' ),
	110	+ 'label' => __( 'Always preload these images', 'xspeed' ),
	111	+ 'description' => __( 'Image URLs to fetch first on every page, such as a hero background set in CSS. Keep it to one or two; only the first three are used.', 'xspeed' ),
	112	+ 'dependsOn' => array( 'field' => 'enabled' ),
107	113	),
108	114	'preconnect' => array(
109	115	'type' => 'bool',
110	116	'default' => true,
111		- 'label' => __( 'Preconnect to Font Hosts', 'xspeed' ),
112		- 'description' => __( 'When Google Fonts are detected, emit <link rel="preconnect"> to fonts.googleapis.com and fonts.gstatic.com so the DNS + TLS handshake happens ahead of the font request instead of on the critical path.', 'xspeed' ),
	117	+ 'label' => __( 'Connect early to Google Fonts', 'xspeed' ),
	118	+ 'description' => __( 'When the page uses Google Fonts, the browser connects to Google\'s servers early, so fonts arrive sooner.', 'xspeed' ),
	119	+ 'dependsOn' => array( 'field' => 'enabled' ),
113	120	),
114	121	'preconnect_hosts' => array(
115	122	'type' => 'list',
116	123	'default' => array(),
117	124	'item_type' => 'url',
118		- 'label' => __( 'Extra Preconnect Hosts', 'xspeed' ),
119		- 'description' => __( 'One origin per line (e.g. https://cdn.example.com) to preconnect in addition to the auto-detected font hosts. Use for a CDN or third-party origin that serves above-the-fold assets.', 'xspeed' ),
	125	+ 'label' => __( 'Other domains to connect early', 'xspeed' ),
	126	+ 'description' => __( 'One address per line, such as https://cdn.example.com. Use for a CDN or other domain that serves files at the top of the page.', 'xspeed' ),
	127	+ 'advanced' => true,
	128	+ 'dependsOn' => array( 'field' => 'enabled' ),
120	129	),
121	130	);
122	131	}
123	132