Speculative Loading

FAQ

Comment puis-je empêcher certaines URL d’être pré-chargées et pré-rendues ?

Toutes les URL ne peuvent pas être raisonnablement pré-rendues. Le pré-rendu du contenu statique est généralement fiable, mais le pré-rendu du contenu interactif, tel qu’une URL de déconnexion, peut entraîner des problèmes. Pour cette raison, certaines URL de base WordPress telles que /wp-login.php et /wp-admin/* sont exclues de la pré-lecture et du pré-rendu. De plus, toutes les URL générées avec wp_nonce_url() (ou qui contiennent la variable de _wpnonce requête) et nofollow les liens sont également ignorés. Vous pouvez exclure des modèles d’URL supplémentaires à l’aide du filtre plsr_speculation_rules_href_exclude_paths.

L’exemple suivant garantit que les URL aiment https://example.com/cart/ ou https://example.com/cart/foo sont exclues de la pré-lecture et du pré-rendu :

<?php
add_filter(
    'plsr_speculation_rules_href_exclude_paths',
    function ( array $exclude_paths ): array {
        $exclude_paths[] = '/cart/*';
        return $exclude_paths;
    }
);

Gardez à l’esprit qu’il peut parfois être utile d’exclure une URL du pré-rendu tout en lui permettant d’être pré-chargée. Par exemple, une page avec du code JavaScript côté client pour mettre à jour l’état de l’utilisateur ne devrait probablement pas être pré-rendue, mais il serait raisonnable de le faire.

For this purpose, the plsr_speculation_rules_href_exclude_paths filter receives the current mode (either « prefetch » or « prerender ») to provide conditional exclusions.

L’exemple suivant garantit que les URL telles https://example.com/products/... que ne peuvent pas être pré-affichées, tout en leur permettant d’être pré-chargées :

<?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 with rel=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 use wp_nonce_url().

Y a-t-il des considérations particulières pour le comportement de chargement spéculatif ?

Pour des raisons de sécurité, toute la fonctionnalité de chargement spéculatif est désactivée par défaut pour les internautes connectés et pour les sites qui n’utilisent pas de jolis permaliens. C’est le cas, car les extensions utilisent souvent des URL avec des réglages de requête personnalisés pour permettre aux internautes d’effectuer des actions, et ces URL ne doivent pas être chargées de manière spéculative. Pour les sites sans jolis permaliens, il est impossible ou du moins extrêmement complexe de différencier les réglages de requête par défaut et les réglages de requête personnalisés.

Si vous exécutez cette extension sur un site sans permaliens et que vous êtes sûr qu’il n’y a pas de réglages de requête personnalisés en cours d’utilisation qui peuvent provoquer des changements d’état, vous pouvez choisir d’activer le chargement spéculatif via le plsr_enabled_without_pretty_permalinks filtre :

<?php
add_filter( 'plsr_enabled_without_pretty_permalinks', '__return_true' );

Quel impact cela aura-t-il sur l’analyse et la personnalisation ?

Le pré-rendu peut affecter l’analyse et la personnalisation.

Pour le JavaScript côté client, il est recommandé de les retarder jusqu’à ce que le pré-rendu soit activé (par exemple en cliquant sur le lien). Certaines solutions (comme Google Analytics) le font déjà automatiquement, voir Impact sur Analytics. De plus, les iframes d’origine croisée ne sont pas chargées avant l’activation, ce qui permet d’éviter des problèmes ici.

Spéculer avec l’empressement par défaut modéré diminue le risque que la page pré-affichée ne soit pas visitée par l’internaute et évitera donc tout effet secondaire du chargement d’un tel lien à l’avance. En revanche, avec eager la spéculation augmente le risque que les pages pré-rendues ne soient pas chargées. Alternativement, l’extension propose de ne spéculer que sur la souris/le pointeur vers le bas (conservateur) ce qui réduit encore plus le risque et constitue une option pour les sites qui s’en préoccupent, au prix d’avoir moins de temps d’avance et donc moins de gain de performance.

Une page pré-rendue est liée à la page qui la pré-rend, de sorte que la personnalisation peut déjà être connue à ce stade et les modifications (par exemple, la navigation sur d’autres produits ou la connexion/déconnexion) nécessitent souvent un nouveau chargement de page, et donc un nouveau pré-rendu, qui les prendra ensuite en compte. Mais c’est certainement quelque chose à connaître et à tester ! Les pages pré-rendues peuvent être annulées en supprimant l’élément de règles <script> de spéculation de la page à l’aide des API DOM JavaScript standard si cela s’avère nécessaire lorsque l’état change sans qu’une nouvelle page ne soit chargée.

Où puis-je soumettre mes commentaires sur l’extension ?

Les commentaires sont encouragés et très appréciés, d’autant plus que cette extension peut contenir de futures fonctionnalités de base de WordPress. Si vous avez des suggestions ou des demandes pour de nouvelles fonctionnalités, vous pouvez les soumettre en tant que problème dans le référentiel GitHub de l’équipe de performance WordPress. Si vous avez besoin d’aide pour le dépannage ou si vous avez une question sur l’extension, veuillez créer un nouveau sujet sur notre forum d’assistance.

Où puis-je signaler des bogues de sécurité ?

L’équipe Performance et la communauté WordPress prennent les bogues de sécurité au sérieux. Nous apprécions vos efforts pour divulguer vos conclusions de manière responsable et nous ferons tout notre possible pour reconnaître vos contributions.

To report a security issue, please visit the WordPress HackerOne program.

Comment puis-je contribuer à l’extension ?

Les contributions sont toujours les bienvenues ! Pour en savoir plus sur la façon de s’impliquer, consultez le manuel de Core Performance Team.