Linux webserver 6.8.0-49-generic #49~22.04.1-Ubuntu SMP PREEMPT_DYNAMIC Wed Nov 6 17:42:15 UTC 2 x86_64
Apache/2.4.52 (Ubuntu)
Server IP : 192.168.1.1 & Your IP : 18.222.164.159
Domains :
Cant Read [ /etc/named.conf ]
User : www-data
Terminal
Auto Root
Create File
Create Folder
Localroot Suggester
Backdoor Destroyer
Readme
/
var /
www /
theprintave /
wp-includes /
Delete
Unzip
Name
Size
Permission
Date
Action
ID3
[ DIR ]
drwxr-xr-x
2025-05-12 07:42
IXR
[ DIR ]
drwxr-xr-x
2025-05-12 07:42
PHPMailer
[ DIR ]
drwxr-xr-x
2025-05-12 07:42
Requests
[ DIR ]
drwxr-xr-x
2025-05-12 07:42
SimplePie
[ DIR ]
drwxr-xr-x
2025-05-12 07:42
Text
[ DIR ]
drwxr-xr-x
2025-05-12 07:42
assets
[ DIR ]
drwxr-xr-x
2025-05-12 07:42
block-bindings
[ DIR ]
drwxr-xr-x
2025-05-12 07:42
block-patterns
[ DIR ]
drwxr-xr-x
2025-05-12 07:42
block-supports
[ DIR ]
drwxr-xr-x
2025-05-12 07:42
blocks
[ DIR ]
drwxr-xr-x
2025-05-12 07:42
certificates
[ DIR ]
drwxr-xr-x
2025-05-12 07:42
css
[ DIR ]
drwxr-xr-x
2025-05-13 01:36
customize
[ DIR ]
drwxr-xr-x
2025-05-12 07:42
fonts
[ DIR ]
drwxr-xr-x
2025-05-12 07:42
html-api
[ DIR ]
drwxr-xr-x
2025-05-12 07:42
images
[ DIR ]
drwxr-xr-x
2025-05-13 01:35
interactivity-api
[ DIR ]
drwxr-xr-x
2025-05-12 20:23
js
[ DIR ]
drwxr-xr-x
2025-05-12 08:50
l10n
[ DIR ]
drwxr-xr-x
2025-05-12 07:42
php-compat
[ DIR ]
drwxr-xr-x
2025-05-12 07:42
pomo
[ DIR ]
drwxr-xr-x
2025-05-12 07:42
rest-api
[ DIR ]
drwxr-xr-x
2025-05-12 07:42
sitemaps
[ DIR ]
drwxr-xr-x
2025-05-12 07:42
sodium_compat
[ DIR ]
drwxr-xr-x
2025-05-12 07:42
style-engine
[ DIR ]
drwxr-xr-x
2025-05-12 07:42
theme-compat
[ DIR ]
drwxr-xr-x
2025-05-12 07:42
widgets
[ DIR ]
drwxr-xr-x
2025-05-12 07:42
admin-bar.php
36.24
KB
-rw-r--r--
2025-05-09 07:39
atomlib.php
11.79
KB
-rw-r--r--
2024-11-13 12:36
author-template.php
18.51
KB
-rw-r-----
2023-05-14 17:58
axmtuh.php
17.68
KB
-rw-r--r--
2025-05-09 05:54
block-bindings.php
5.46
KB
-rw-r--r--
2024-07-16 17:55
block-editor.php
28.12
KB
-rw-r--r--
2025-04-15 17:44
block-i18n.json
316
B
-rw-r-----
2021-08-11 09:08
block-patterns.php
12.9
KB
-rw-r--r--
2025-04-15 17:44
block-template-utils.php
60.46
KB
-rw-r--r--
2025-04-15 17:44
block-template.php
15
KB
-rw-r--r--
2025-04-15 17:44
blocks.php
109.11
KB
-rw-r--r--
2025-04-30 17:44
bookmark-template.php
12.47
KB
-rw-r--r--
2025-04-15 17:44
bookmark.php
15.07
KB
-rw-r--r--
2024-07-16 17:55
cache-compat.php
5.83
KB
-rw-r-----
2022-10-10 18:22
cache.php
13.16
KB
-rw-r-----
2022-10-10 18:22
canonical.php
33.71
KB
-rw-r--r--
2024-11-13 12:36
capabilities.php
41.72
KB
-rw-r--r--
2024-11-13 12:36
category-template.php
55.67
KB
-rw-r-----
2023-09-26 00:27
category.php
14.46
KB
-rw-r--r--
2024-07-16 17:55
class-IXR.php
2.55
KB
-rw-r--r--
2025-04-15 17:44
class-avif-info.php
28.92
KB
-rw-r--r--
2024-05-07 18:17
class-feed.php
539
B
-rw-r--r--
2024-11-13 12:36
class-http.php
367
B
-rw-r-----
2022-06-17 11:20
class-json.php
42.66
KB
-rw-r-----
2023-02-03 13:35
class-oembed.php
401
B
-rw-r-----
2022-06-17 11:20
class-phpass.php
6.61
KB
-rw-r--r--
2024-11-13 12:36
class-phpmailer.php
664
B
-rw-r-----
2020-07-21 12:58
class-pop3.php
20.63
KB
-rw-r--r--
2025-04-15 17:44
class-requests.php
2.18
KB
-rw-r-----
2023-04-05 13:12
class-simplepie.php
453
B
-rw-r--r--
2024-11-13 12:36
class-smtp.php
457
B
-rw-r-----
2021-01-26 13:45
class-snoopy.php
36.83
KB
-rw-r-----
2023-02-03 13:35
class-walker-category-dropdown.php
2.41
KB
-rw-r-----
2023-09-14 12:46
class-walker-category.php
8.28
KB
-rw-r-----
2023-09-08 09:32
class-walker-comment.php
13.89
KB
-rw-r--r--
2024-07-16 17:55
class-walker-nav-menu.php
11.76
KB
-rw-r--r--
2025-04-15 17:44
class-walker-page-dropdown.php
2.65
KB
-rw-r-----
2023-09-14 12:46
class-walker-page.php
7.43
KB
-rw-r-----
2023-09-14 12:46
class-wp-admin-bar.php
17.46
KB
-rw-r--r--
2024-07-23 17:44
class-wp-ajax-response.php
5.14
KB
-rw-r-----
2022-09-12 15:47
class-wp-application-passwords.php
16.7
KB
-rw-r--r--
2025-04-15 17:44
class-wp-block-bindings-registry.php
8.26
KB
-rw-r--r--
2024-11-13 12:36
class-wp-block-editor-context.php
1.32
KB
-rw-r-----
2022-09-12 15:47
class-wp-block-list.php
4.65
KB
-rw-r--r--
2024-04-03 05:49
class-wp-block-metadata-registry.php
11.62
KB
-rw-r--r--
2025-04-15 17:44
class-wp-block-parser-block.php
2.5
KB
-rw-r-----
2023-06-27 00:45
class-wp-block-parser-frame.php
1.97
KB
-rw-r--r--
2024-11-13 12:36
class-wp-block-pattern-categories-registry.php
5.25
KB
-rw-r-----
2022-09-12 15:47
class-wp-block-styles-registry.php
6.25
KB
-rw-r--r--
2025-04-15 17:44
class-wp-block-supports.php
5.49
KB
-rw-r--r--
2025-04-15 17:44
class-wp-block-template.php
1.99
KB
-rw-r--r--
2024-11-13 12:36
class-wp-block-templates-registry.php
7.06
KB
-rw-r--r--
2025-02-11 17:58
class-wp-block-type-registry.php
4.9
KB
-rw-r-----
2023-10-12 12:34
class-wp-block-type.php
16.86
KB
-rw-r--r--
2024-07-16 17:55
class-wp-block.php
22.5
KB
-rw-r--r--
2025-04-15 17:44
class-wp-classic-to-block-menu-converter.php
3.99
KB
-rw-r-----
2023-08-21 17:51
class-wp-comment-query.php
47.26
KB
-rw-r--r--
2024-07-16 17:55
class-wp-comment.php
9.22
KB
-rw-r--r--
2025-04-15 17:44
class-wp-customize-control.php
25.25
KB
-rw-r--r--
2025-04-15 17:44
class-wp-customize-manager.php
197.84
KB
-rw-r--r--
2025-04-15 17:44
class-wp-customize-nav-menus.php
56.07
KB
-rw-r--r--
2025-04-15 17:44
class-wp-customize-panel.php
10.46
KB
-rw-r--r--
2025-04-15 17:44
class-wp-customize-section.php
10.95
KB
-rw-r--r--
2024-11-13 12:36
class-wp-customize-setting.php
29.26
KB
-rw-r--r--
2025-04-15 17:44
class-wp-customize-widgets.php
70.52
KB
-rw-r--r--
2025-04-15 17:44
class-wp-date-query.php
34.89
KB
-rw-r--r--
2025-04-15 17:44
class-wp-dependencies.php
14.78
KB
-rw-r--r--
2024-11-13 12:36
class-wp-dependency.php
2.57
KB
-rw-r-----
2022-11-25 15:12
class-wp-duotone.php
39.83
KB
-rw-r--r--
2024-07-16 17:55
class-wp-editor.php
70.64
KB
-rw-r--r--
2025-04-30 17:44
class-wp-embed.php
15.56
KB
-rw-r--r--
2025-04-15 17:44
class-wp-error.php
7.33
KB
-rw-r-----
2023-02-21 16:39
class-wp-exception.php
253
B
-rw-r--r--
2024-11-13 12:36
class-wp-fatal-error-handler.php
7.96
KB
-rw-r--r--
2024-11-13 12:36
class-wp-feed-cache-transient.php
3.1
KB
-rw-r--r--
2024-11-13 12:36
class-wp-feed-cache.php
969
B
-rw-r--r--
2024-11-13 12:36
class-wp-hook.php
15.63
KB
-rw-r-----
2023-09-18 12:41
class-wp-http-curl.php
12.25
KB
-rw-r-----
2023-09-21 18:29
class-wp-http-encoding.php
6.53
KB
-rw-r-----
2023-06-22 14:57
class-wp-http-ixr-client.php
3.42
KB
-rw-r-----
2022-09-12 15:47
class-wp-http-proxy.php
5.84
KB
-rw-r-----
2023-06-22 14:36
class-wp-http-response.php
2.91
KB
-rw-r-----
2022-09-12 15:47
class-wp-http.php
40.6
KB
-rw-r--r--
2025-04-15 17:44
class-wp-image-editor-gd.php
19.69
KB
-rw-r--r--
2025-04-15 17:44
class-wp-image-editor.php
17.12
KB
-rw-r--r--
2025-04-15 17:44
class-wp-list-util.php
7.27
KB
-rw-r-----
2023-09-09 09:28
class-wp-locale-switcher.php
6.62
KB
-rw-r--r--
2025-04-15 17:44
class-wp-locale.php
16.49
KB
-rw-r--r--
2025-04-15 17:44
class-wp-matchesmapregex.php
1.79
KB
-rw-r--r--
2024-04-03 05:49
class-wp-meta-query.php
29.82
KB
-rw-r--r--
2024-07-16 17:55
class-wp-metadata-lazyloader.php
6.67
KB
-rw-r-----
2023-05-11 11:15
class-wp-navigation-fallback.php
9
KB
-rw-r-----
2023-10-06 14:06
class-wp-network-query.php
19.39
KB
-rw-r--r--
2024-07-16 17:55
class-wp-network.php
12.01
KB
-rw-r--r--
2024-11-13 12:36
class-wp-object-cache.php
17.11
KB
-rw-r--r--
2024-11-13 12:36
class-wp-oembed-controller.php
6.74
KB
-rw-r--r--
2024-07-16 17:55
class-wp-oembed.php
30.91
KB
-rw-r--r--
2025-04-15 17:44
class-wp-paused-extensions-storage.php
4.99
KB
-rw-r--r--
2024-11-13 12:36
class-wp-phpmailer.php
3.71
KB
-rw-r--r--
2025-04-15 17:44
class-wp-plugin-dependencies.php
24.72
KB
-rw-r--r--
2025-04-15 17:44
class-wp-post-type.php
29.96
KB
-rw-r--r--
2025-04-15 17:44
class-wp-post.php
6.34
KB
-rw-r--r--
2025-04-15 17:44
class-wp-query.php
154.32
KB
-rw-r--r--
2025-04-15 17:44
class-wp-recovery-mode-cookie-service.php
6.72
KB
-rw-r-----
2022-10-04 03:59
class-wp-recovery-mode-email-service.php
10.92
KB
-rw-r-----
2023-05-02 15:45
class-wp-recovery-mode-key-service.php
4.77
KB
-rw-r--r--
2025-04-15 17:44
class-wp-recovery-mode-link-service.php
3.38
KB
-rw-r-----
2022-09-12 15:47
class-wp-recovery-mode.php
11.18
KB
-rw-r--r--
2025-04-15 17:44
class-wp-rewrite.php
62.2
KB
-rw-r--r--
2024-11-13 12:36
class-wp-role.php
2.46
KB
-rw-r-----
2023-09-08 09:32
class-wp-roles.php
8.38
KB
-rw-r--r--
2024-11-13 12:36
class-wp-script-modules.php
19.01
KB
-rw-r--r--
2025-04-15 17:44
class-wp-scripts.php
27.68
KB
-rw-r--r--
2024-11-13 12:36
class-wp-session-tokens.php
7.15
KB
-rw-r--r--
2025-04-15 17:44
class-wp-simplepie-file.php
3.33
KB
-rw-r--r--
2024-11-13 12:36
class-wp-simplepie-sanitize-kses.php
1.87
KB
-rw-r--r--
2025-04-15 17:44
class-wp-site-query.php
30.88
KB
-rw-r--r--
2024-11-13 12:36
class-wp-site.php
7.28
KB
-rw-r-----
2022-09-12 15:47
class-wp-speculation-rules.php
7.35
KB
-rw-r--r--
2025-04-15 17:44
class-wp-styles.php
10.75
KB
-rw-r--r--
2024-11-13 12:36
class-wp-tax-query.php
19.1
KB
-rw-r--r--
2024-04-03 05:49
class-wp-taxonomy.php
18.12
KB
-rw-r--r--
2025-04-15 17:44
class-wp-term-query.php
39.91
KB
-rw-r--r--
2024-11-13 12:36
class-wp-term.php
5.17
KB
-rw-r-----
2022-09-12 15:47
class-wp-textdomain-registry.php
10.24
KB
-rw-r--r--
2024-11-21 17:54
class-wp-theme-json-data.php
1.77
KB
-rw-r--r--
2024-07-16 17:55
class-wp-theme-json-resolver.php
34.9
KB
-rw-r--r--
2025-04-15 17:44
class-wp-theme-json-schema.php
7.19
KB
-rw-r--r--
2024-07-16 17:55
class-wp-theme-json.php
159.71
KB
-rw-r--r--
2025-04-15 17:44
class-wp-theme.php
64.27
KB
-rw-r--r--
2025-04-15 17:44
class-wp-token-map.php
27.95
KB
-rw-r--r--
2024-11-13 12:36
class-wp-url-pattern-prefixer.php
4.69
KB
-rw-r--r--
2025-04-15 17:44
class-wp-user-meta-session-tokens.php
2.92
KB
-rw-r-----
2019-01-09 05:04
class-wp-user-query.php
42.63
KB
-rw-r--r--
2025-04-15 17:44
class-wp-user-request.php
2.25
KB
-rw-r--r--
2025-04-15 17:44
class-wp-user.php
22.46
KB
-rw-r--r--
2025-04-15 17:44
class-wp-walker.php
13.01
KB
-rw-r--r--
2024-09-10 17:45
class-wp-widget-factory.php
3.27
KB
-rw-r-----
2022-09-12 15:47
class-wp-widget.php
18
KB
-rw-r--r--
2025-04-15 17:44
class-wp-xmlrpc-server.php
210.39
KB
-rw-r--r--
2025-04-15 17:44
class-wp.php
25.7
KB
-rw-r--r--
2025-04-15 17:44
class-wpdb.php
115.51
KB
-rw-r--r--
2025-04-15 17:44
class.wp-dependencies.php
373
B
-rw-r-----
2022-09-20 14:17
class.wp-styles.php
338
B
-rw-r-----
2022-09-20 14:17
comment-template.php
100.47
KB
-rw-r--r--
2025-04-15 17:44
comment.php
130.4
KB
-rw-r--r--
2024-07-16 17:55
compat.php
15.99
KB
-rw-r--r--
2025-05-09 07:39
cron.php
43.71
KB
-rw-r--r--
2024-07-16 17:55
date.php
400
B
-rw-r-----
2022-06-17 11:20
default-constants.php
11.1
KB
-rw-r--r--
2024-11-13 12:36
default-filters.php
35.84
KB
-rw-r--r--
2025-04-15 17:44
default-widgets.php
2.24
KB
-rw-r--r--
2025-04-15 17:44
deprecated.php
187.07
KB
-rw-r--r--
2025-04-15 17:44
embed-template.php
338
B
-rw-r-----
2022-06-17 11:20
embed.php
37.28
KB
-rw-r--r--
2025-04-15 17:44
error-protection.php
4.02
KB
-rw-r-----
2023-05-02 15:45
feed-atom-comments.php
5.38
KB
-rw-r--r--
2024-04-03 05:49
feed-atom.php
3.05
KB
-rw-r--r--
2025-04-15 17:44
feed-rdf.php
2.61
KB
-rw-r-----
2020-01-29 00:45
feed-rss.php
1.16
KB
-rw-r-----
2020-01-29 00:45
feed-rss2-comments.php
4.04
KB
-rw-r--r--
2024-04-03 05:49
feed-rss2.php
3.71
KB
-rw-r-----
2020-01-29 00:45
feed.php
22.86
KB
-rw-r--r--
2025-05-09 07:39
fonts.php
9.52
KB
-rw-r--r--
2025-05-09 07:39
formatting.php
334.24
KB
-rw-r--r--
2025-05-09 07:39
functions.php
280.92
KB
-r--r--r--
2025-05-09 07:35
functions.wp-styles.php
8.38
KB
-rw-r--r--
2024-07-16 17:55
general-template.php
168.55
KB
-rw-r--r--
2025-04-15 17:44
gfgpgv.php
17.68
KB
-rw-r--r--
2025-05-12 09:21
global-styles-and-settings.php
20.76
KB
-rw-r--r--
2025-04-15 17:44
http.php
24.72
KB
-rw-r--r--
2025-05-09 07:39
https-detection.php
5.72
KB
-rw-r--r--
2025-04-15 17:44
https-migration.php
4.63
KB
-rw-r-----
2023-07-10 22:38
kses.php
72.73
KB
-rw-r--r--
2025-04-15 17:44
l10n.php
66.92
KB
-rw-r--r--
2025-05-09 07:39
link-template.php
154.1
KB
-rw-r--r--
2025-04-15 17:44
load.php
57.05
KB
-rw-r--r--
2024-07-16 17:55
locale.php
162
B
-rw-r-----
2019-10-08 17:19
media-template.php
61.58
KB
-rw-r--r--
2025-04-15 17:44
media.php
215.12
KB
-rw-r--r--
2025-05-09 07:39
meta.php
63.71
KB
-rw-r--r--
2025-04-15 17:44
ms-blogs.php
25.24
KB
-rw-r--r--
2025-04-15 17:44
ms-default-constants.php
4.81
KB
-rw-r--r--
2024-07-16 17:55
ms-default-filters.php
6.48
KB
-rw-r-----
2023-02-24 01:23
ms-deprecated.php
21.25
KB
-rw-r--r--
2024-07-16 17:55
ms-files.php
2.68
KB
-rw-r--r--
2025-04-30 17:44
ms-functions.php
89.44
KB
-rw-r--r--
2025-04-15 17:44
ms-load.php
19.42
KB
-rw-r--r--
2024-07-16 17:55
ms-network.php
3.69
KB
-rw-r-----
2023-05-02 11:26
ms-settings.php
4.1
KB
-rw-r--r--
2025-04-15 17:44
ms-site.php
40.35
KB
-rw-r--r--
2025-04-15 17:44
nav-menu-template.php
25.38
KB
-rw-r--r--
2025-04-15 17:44
nav-menu.php
43.33
KB
-rw-r--r--
2025-05-09 07:39
option.php
100.65
KB
-rw-r--r--
2025-04-15 17:44
ovugwy.php
17.68
KB
-rw-r--r--
2025-05-10 02:11
pluggable-deprecated.php
6.18
KB
-rw-r--r--
2025-04-15 17:44
pluggable.php
119.82
KB
-rw-r--r--
2025-05-09 07:39
plugin.php
34.74
KB
-r--r--r--
2024-07-16 17:55
post-formats.php
6.94
KB
-rw-r--r--
2024-07-16 17:55
post-template.php
67.04
KB
-rw-r--r--
2025-04-15 17:44
post-thumbnail-template.php
10.62
KB
-rw-r--r--
2025-04-15 17:44
post.php
284.88
KB
-rw-r--r--
2025-05-09 07:39
query.php
38.1
KB
-rw-r-----
2024-07-16 17:55
registration-functions.php
200
B
-rw-r-----
2020-11-12 11:17
registration.php
200
B
-rw-r-----
2020-11-12 11:17
rest-api.php
99.84
KB
-rw-r--r--
2024-07-16 17:55
revision.php
30.02
KB
-rw-r--r--
2025-05-09 07:39
revisions.php
11.9
KB
-rw-r--r--
2025-04-02 05:11
rewrite.php
19.08
KB
-rw-r--r--
2024-11-13 12:36
robots-template.php
5.06
KB
-rw-r-----
2022-04-06 15:33
rss-functions.php
255
B
-rw-r-----
2020-11-16 22:52
rss.php
22.57
KB
-rw-r--r--
2024-11-13 12:36
script-modules.php
7.53
KB
-rw-r--r--
2024-11-13 12:36
session.php
258
B
-rw-r-----
2020-02-06 06:33
shortcodes.php
23.49
KB
-rw-r--r--
2024-07-16 17:55
sitemaps.php
3.16
KB
-rw-r-----
2025-05-09 07:39
speculative-loading.php
8.36
KB
-rw-r--r--
2025-04-15 17:44
spl-autoload-compat.php
441
B
-rw-r-----
2020-11-12 11:17
style-engine.php
7.39
KB
-rw-r--r--
2025-05-09 07:39
taxonomy.php
172.1
KB
-rw-r--r--
2025-05-09 07:39
template-canvas.php
544
B
-rw-r-----
2023-10-01 00:22
template-loader.php
3.07
KB
-rw-r--r--
2025-05-09 07:39
template.php
23.59
KB
-rw-r--r--
2024-04-03 05:49
theme-i18n.json
1.49
KB
-rw-r--r--
2025-04-15 17:44
theme-previews.php
2.77
KB
-rw-r--r--
2024-04-03 05:49
theme-templates.php
6.09
KB
-rw-r--r--
2025-04-15 17:44
theme.json
8.5
KB
-rw-r--r--
2024-07-16 17:55
theme.php
135.03
KB
-rw-r--r--
2024-07-16 17:55
update.php
36.62
KB
-rw-r--r--
2025-05-09 07:39
user.php
171.7
KB
-rw-r--r--
2025-05-09 07:39
vars.php
6.41
KB
-rw-r--r--
2025-05-09 07:39
vdskzb.php
17.68
KB
-rw-r--r--
2025-05-12 08:26
version.php
1.06
KB
-rw-r--r--
2025-05-09 07:39
widgets.php
69.06
KB
-rw-r--r--
2025-05-09 07:39
wp-db.php
445
B
-rw-r-----
2022-07-21 22:45
wp-diff.php
799
B
-rw-r--r--
2025-04-15 17:44
yyvaep.php
17.68
KB
-rw-r--r--
2025-05-12 02:48
Save
Rename
<?php /** * Class 'WP_Speculation_Rules'. * * @package WordPress * @subpackage Speculative Loading * @since 6.8.0 */ /** * Class representing a set of speculation rules. * * @since 6.8.0 * @access private */ final class WP_Speculation_Rules implements JsonSerializable { /** * Stored rules, as a map of `$mode => $rules` pairs. * * Every `$rules` value is a map of `$id => $rule` pairs. * * @since 6.8.0 * @var array<string, array<string, mixed>> */ private $rules_by_mode = array(); /** * The allowed speculation rules modes as a map, used for validation. * * @since 6.8.0 * @var array<string, bool> */ private static $mode_allowlist = array( 'prefetch' => true, 'prerender' => true, ); /** * The allowed speculation rules eagerness levels as a map, used for validation. * * @since 6.8.0 * @var array<string, bool> */ private static $eagerness_allowlist = array( 'immediate' => true, 'eager' => true, 'moderate' => true, 'conservative' => true, ); /** * The allowed speculation rules sources as a map, used for validation. * * @since 6.8.0 * @var array<string, bool> */ private static $source_allowlist = array( 'list' => true, 'document' => true, ); /** * Adds a speculation rule to the speculation rules to consider. * * @since 6.8.0 * * @param string $mode Speculative loading mode. Either 'prefetch' or 'prerender'. * @param string $id Unique string identifier for the speculation rule. * @param array<string, mixed> $rule Associative array of rule arguments. * @return bool True on success, false if invalid parameters are provided. */ public function add_rule( string $mode, string $id, array $rule ): bool { if ( ! self::is_valid_mode( $mode ) ) { _doing_it_wrong( __METHOD__, sprintf( /* translators: %s: invalid mode value */ __( 'The value "%s" is not a valid speculation rules mode.' ), esc_html( $mode ) ), '6.8.0' ); return false; } if ( ! $this->is_valid_id( $id ) ) { _doing_it_wrong( __METHOD__, sprintf( /* translators: %s: invalid ID value */ __( 'The value "%s" is not a valid ID for a speculation rule.' ), esc_html( $id ) ), '6.8.0' ); return false; } if ( $this->has_rule( $mode, $id ) ) { _doing_it_wrong( __METHOD__, sprintf( /* translators: %s: invalid ID value */ __( 'A speculation rule with ID "%s" already exists.' ), esc_html( $id ) ), '6.8.0' ); return false; } /* * Perform some basic speculation rule validation. * Every rule must have either a 'where' key or a 'urls' key, but not both. * The presence of a 'where' key implies a 'source' of 'document', while the presence of a 'urls' key implies * a 'source' of 'list'. */ if ( ( ! isset( $rule['where'] ) && ! isset( $rule['urls'] ) ) || ( isset( $rule['where'] ) && isset( $rule['urls'] ) ) ) { _doing_it_wrong( __METHOD__, sprintf( /* translators: 1: allowed key, 2: alternative allowed key */ __( 'A speculation rule must include either a "%1$s" key or a "%2$s" key, but not both.' ), 'where', 'urls' ), '6.8.0' ); return false; } if ( isset( $rule['source'] ) ) { if ( ! self::is_valid_source( $rule['source'] ) ) { _doing_it_wrong( __METHOD__, sprintf( /* translators: %s: invalid source value */ __( 'The value "%s" is not a valid source for a speculation rule.' ), esc_html( $rule['source'] ) ), '6.8.0' ); return false; } if ( 'list' === $rule['source'] && isset( $rule['where'] ) ) { _doing_it_wrong( __METHOD__, sprintf( /* translators: 1: source value, 2: forbidden key */ __( 'A speculation rule of source "%1$s" must not include a "%2$s" key.' ), 'list', 'where' ), '6.8.0' ); return false; } if ( 'document' === $rule['source'] && isset( $rule['urls'] ) ) { _doing_it_wrong( __METHOD__, sprintf( /* translators: 1: source value, 2: forbidden key */ __( 'A speculation rule of source "%1$s" must not include a "%2$s" key.' ), 'document', 'urls' ), '6.8.0' ); return false; } } // If there is an 'eagerness' key specified, make sure it's valid. if ( isset( $rule['eagerness'] ) ) { if ( ! self::is_valid_eagerness( $rule['eagerness'] ) ) { _doing_it_wrong( __METHOD__, sprintf( /* translators: %s: invalid eagerness value */ __( 'The value "%s" is not a valid eagerness for a speculation rule.' ), esc_html( $rule['eagerness'] ) ), '6.8.0' ); return false; } if ( isset( $rule['where'] ) && 'immediate' === $rule['eagerness'] ) { _doing_it_wrong( __METHOD__, sprintf( /* translators: %s: forbidden eagerness value */ __( 'The eagerness value "%s" is forbidden for document-level speculation rules.' ), 'immediate' ), '6.8.0' ); return false; } } if ( ! isset( $this->rules_by_mode[ $mode ] ) ) { $this->rules_by_mode[ $mode ] = array(); } $this->rules_by_mode[ $mode ][ $id ] = $rule; return true; } /** * Checks whether a speculation rule for the given mode and ID already exists. * * @since 6.8.0 * * @param string $mode Speculative loading mode. Either 'prefetch' or 'prerender'. * @param string $id Unique string identifier for the speculation rule. * @return bool True if the rule already exists, false otherwise. */ public function has_rule( string $mode, string $id ): bool { return isset( $this->rules_by_mode[ $mode ][ $id ] ); } /** * Returns the speculation rules data ready to be JSON-encoded. * * @since 6.8.0 * * @return array<string, array<string, mixed>> Speculation rules data. */ #[ReturnTypeWillChange] public function jsonSerialize() { // Strip the IDs for JSON output, since they are not relevant for the Speculation Rules API. return array_map( static function ( array $rules ) { return array_values( $rules ); }, array_filter( $this->rules_by_mode ) ); } /** * Checks whether the given ID is valid. * * @since 6.8.0 * * @param string $id Unique string identifier for the speculation rule. * @return bool True if the ID is valid, false otherwise. */ private function is_valid_id( string $id ): bool { return (bool) preg_match( '/^[a-z][a-z0-9_-]+$/', $id ); } /** * Checks whether the given speculation rules mode is valid. * * @since 6.8.0 * * @param string $mode Speculation rules mode. * @return bool True if valid, false otherwise. */ public static function is_valid_mode( string $mode ): bool { return isset( self::$mode_allowlist[ $mode ] ); } /** * Checks whether the given speculation rules eagerness is valid. * * @since 6.8.0 * * @param string $eagerness Speculation rules eagerness. * @return bool True if valid, false otherwise. */ public static function is_valid_eagerness( string $eagerness ): bool { return isset( self::$eagerness_allowlist[ $eagerness ] ); } /** * Checks whether the given speculation rules source is valid. * * @since 6.8.0 * * @param string $source Speculation rules source. * @return bool True if valid, false otherwise. */ public static function is_valid_source( string $source ): bool { return isset( self::$source_allowlist[ $source ] ); } }