Aprašymas
This plugin adds support for the Speculation Rules API, which allows defining rules by which certain URLs are dynamically prefetched or prerendered.
See the Speculation Rules WICG specification draft.
By default, the plugin is configured to prerender WordPress frontend URLs when the user interacts with a relevant link. This can be customized via the „Speculative Loading” section in the Settings > Reading admin screen.
A filter can be used to exclude certain URL paths from being eligible for prefetching and prerendering (see FAQ section). Alternatively, you can add the no-prerender
CSS class to any link (<a>
tag) that should not be prerendered. See FAQ for more information.
Browser support
The Speculation Rules API is a new web API, and the functionality used by the plugin is supported in Chromium-based browsers such as Chrome, Edge, or Opera using version 121 or above. Other browsers such as Safari and Firefox will ignore the functionality with no ill effects; they will simply not benefit from the speculative loading. Note that certain browser extensions may disable preloading by default.
- Browser support for the Speculation Rules API in general
- Information on document rules syntax support used by the plugin
This plugin was formerly known as Speculation Rules.
Diegimas
Installation from within WordPress
- Visit Plugins > Add New.
- Search for Speculative Loading.
- Install and activate the Speculative Loading plugin.
Manual installation
- Upload the entire
speculation-rules
folder to the/wp-content/plugins/
directory. - Visit Plugins.
- Activate the Speculative Loading plugin.
DUK
-
How can I prevent certain URLs from being prefetched and prerendered?
-
Not every URL can be reasonably prerendered. Prerendering static content is typically reliable, however prerendering interactive content, such as a logout URL, can lead to issues. For this reason, certain WordPress core URLs such as
/wp-login.php
and/wp-admin/*
are excluded from prefetching and prerendering. Additionally, any URLs generated withwp_nonce_url()
(or which contains the_wpnonce
query var) andnofollow
links are also ignored. You can exclude additional URL patterns by using theplsr_speculation_rules_href_exclude_paths
filter.The following example ensures that URLs like
https://example.com/cart/
orhttps://example.com/cart/foo
are excluded from prefetching and prerendering:<?php add_filter( 'plsr_speculation_rules_href_exclude_paths', function ( array $exclude_paths ): array { $exclude_paths[] = '/cart/*'; return $exclude_paths; } );
Keep in mind that sometimes it may be useful to exclude a URL from prerendering while still allowing it to be prefetched. For example, a page with client-side JavaScript to update user state should probably not be prerendered, but it would be reasonable to prefetch.
For this purpose, the
plsr_speculation_rules_href_exclude_paths
filter receives the current mode (either „prefetch” or „prerender”) to provide conditional exclusions.The following example ensures that URLs like
https://example.com/products/...
cannot be prerendered, while still allowing them to be prefetched:<?php add_filter( 'plsr_speculation_rules_href_exclude_paths', function ( array $exclude_paths, string $mode ): array { if ( 'prerender' === $mode ) { $exclude_paths[] = '/products/*'; } return $exclude_paths; }, 10, 2 );
As mentioned above, adding the
no-prerender
CSS class to a link will prevent it from being prerendered (but not prefetched). Additionally, links withrel=nofollow
will neither be prefetched nor prerendered because some plugins add this to non-idempotent links (e.g. add to cart); such links ideally should rather be buttons which trigger a POST request or at least they should usewp_nonce_url()
. -
How will this impact analytics and personalization?
-
Prerendering can affect analytics and personalization.
For client-side JavaScript, is recommended to delay these until the prerender is activated (for example by clicking on the link). Some solutions (like Google Analytics) already do this automatically, see Impact on Analytics. Additionally, cross-origin iframes are not loaded until activation which can further avoid issues here.
Speculating with the default
moderate
eagerness decreases the risk that the prerendered page will not be visited by the user and therefore will avoid any side effects of loading such a link in advance. In contrast,eager
speculation increases the risk that prerendered pages may not be loaded. Alternatively, the plugin offers to only speculate on mouse/pointer down (conservative) which reduces the risk even further and is an option for sites which are concerned about this, at the cost of having less of a lead time and so less of a performance gain.A prerendered page is linked to the page that prerenders it, so personalisation may already be known by this point and changes (e.g. browsing other products, or logging in/out) often require a new page load, and hence a new prerender, which will then take these into account. But it definitely is something to be aware of and test! Prerendered pages can be canceled by removing the speculation rules
<script>
element from the page using standard JavaScript DOM APIs should this be needed when state changes without a new page load. -
Where can I submit my plugin feedback?
-
Feedback is encouraged and much appreciated, especially since this plugin may contain future WordPress core features. If you have suggestions or requests for new features, you can submit them as an issue in the WordPress Performance Team’s GitHub repository. If you need help with troubleshooting or have a question about the plugin, please create a new topic on our support forum.
-
Where can I report security bugs?
-
The Performance team and WordPress community take security bugs seriously. We appreciate your efforts to responsibly disclose your findings, and will make every effort to acknowledge your contributions.
To report a security issue, please visit the WordPress HackerOne program.
-
How can I contribute to the plugin?
-
Contributions are always welcome! Learn more about how to get involved in the Core Performance Team Handbook.
Atsiliepimai
Programuotojai ir komandos nariai
“Speculative Loading” yra atviro kodo programa. Prie jos sukūrimo prisidėję žmonės surašyti toliau.
AutoriaiĮskiepis “Speculative Loading” išverstas į 8 kalbas. Dėkojame vertėjams už jų darbą.
Išverskite “Speculative Loading” į savo kalbą.
Domina programavimas?
Peržiūrėkite kodą, naršykite SVN repozitorijoje, arba užsiprenumeruokite kodo pakeitimų žurnalą per RSS.
Pakeitimų istorija
1.3.1
Bug Fixes
- Check if rel contains nofollow instead of being just nofollow when excluding speculative loading. (1232)
1.3.0
Enhancements
- Prevent speculatively loading links to the uploads, content, plugins, template, or stylesheet directories. (1167)
- Facilitate embedding Speculative Loading in other plugins/themes. (1159)
- Improve overall code quality with stricter static analysis checks. (775)
- Bump minimum PHP requirement to 7.2. (1130)
1.2.2
Bug Fixes
- Fix composition of href exclude paths to account for JSON encoding and differing site/home URLs. (1164)
Documentation
- Update readme with browser support and FAQ section about analytics and personalization. (1155)
1.2.1
Enhancements
- Add settings link to Speculative Loading plugin action links. (1145)
- Bump minimum PHP version to 7.2. (1130)
Bug Fixes
- Exclude _wpnonce URLs in speculation rules. (1143)
- Exclude rel=nofollow links from prefetch/prerender. (1142)
1.2.0
- Add missing uninstall.php to remove plugin’s database option. (1128)
1.1.0
- Allow excluding URL patterns from prerendering or prefetching specifically. (1025)
- Rename plugin to „Speculative Loading”. (1101)
- Add Speculative Loading generator tag. (1102)
- Bump minimum required WP version to 6.4. (1062)
- Update tested WordPress version to 6.5. (1027)
1.0.1
- Escape path prefix and restrict it to be a pathname in Speculation Rules. (951)
- Force HTML5 script theme support when printing JSON script. (952)
- Add icon and banner assets for plugin directory. (987)
1.0.0
- Initial release of the Speculative Loading plugin as a standalone plugin. (733)