Speculative Loading

Perguntas frequentes

Como posso evitar que determinados URLs sejam pré-carregados e pré-montados?

Nem todo o URL pode ser pré-montado de maneira razoável. A pré-montagem de conteúdo estático é normalmente confiável, no entanto, a pré-montagem de conteúdo dinâmico ou interativo, como uma página de saída de sessão, pode levar a problemas. Por esse motivo, certas páginas do WordPress, como /wp-login.php e /wp-admin/*, são excluídas da pré-carga e pré-montagem. Além disso, quaisquer URLs gerados com wp_nonce_url() (ou que contenham a variável de consulta _wpnonce) e links nofollow também são ignorados. Você pode excluir padrões adicionais de URL usando o filtro plsr_speculation_rules_href_exclude_paths.

O exemplo a seguir garante que URLs como https://example.com/cart/ ou https://example.com/cart/foo sejam excluídas da pré-carga e pré-montagem:

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

Lembre-se de que, às vezes, pode ser útil excluir um URL da pré-montagem mas permitir que ele seja pré-carregado. Por exemplo, uma página com JavaScript do lado do cliente para atualizar o status do usuário provavelmente não deve ser pré-montada, mas seria razoável fazer a pré-carga.

Para esse propósito, o filtro plsr_speculation_rules_href_exclude_paths recebe o modo atual — “prefetch” (pré-carga) ou “prerender” (pré-montagem) — para fornecer exclusões condicionais.

O exemplo a seguir garante que URLs como https://example.com/products/... não possam ser pré-montadas, mas ainda permite que sejam pré-carregadas:

<?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
);

Conforme mencionado acima, adicionar a classe CSS no-prerender a um link impedirá que ele seja pré-montado (mas não pré-carregado). Além disso, links com rel=nofollow não serão pré-carregados nem pré-montados porque alguns plugins adicionam isso a links não-idempotentes (links não-redundantes, por exemplo: adicionar ao carrinho); tais links idealmente devem ser botões que disparam uma solicitação POST ou pelo menos devem usar wp_nonce_url().

Há alguma consideração especial sobre o comportamento do carregamento especulativo?

Por razões de segurança, toda a funcionalidade de carregamento especulativo é desabilitada por padrão para usuários autenticados e para sites que não usam “pretty permalinks” (links permanentes amigáveis). Este último é o caso porque os plugins geralmente usam URLs com parâmetros de consulta personalizados para permitir que os usuários executem ações, e tais URLs não devem ser carregadas de maneira especulativa. Para sites sem links amigáveis, é impossível ou pelo menos extremamente complexo diferenciar entre quais parâmetros de consulta são comuns e quais são personalizados.

Se você estiver executando este plugin em um site sem links amigáveis (“pretty permalinks”) e tiver certeza de que não há parâmetros de consulta personalizados em uso que possam causar alterações de estado das páginas quando chamados, você pode optar por ativar o carregamento especulativo diretamente com o filtro plsr_enabled_without_pretty_permalinks:

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

Como isso irá impactar a análise e a personalização?

A pré-montagem pode afetar análises e personalizações.

Para o JavaScript do lado do cliente, é recomendado atrasar isso até que o pré-montador seja ativado (por exemplo, clicando no link). Algumas soluções (como o Google Analytics) já fazem isso automaticamente, veja Impacto nas análises. Além disso, iframes de origem cruzada não são carregados até a ativação, o que ainda pode evitar mais problemas aqui.

Especular com modo padrão “moderado” (moderate) diminui o risco de que uma página pré-montada não seja visitada pelo usuário e, portanto, evitará quaisquer efeitos colaterais de carregar tal página com antecedência. Em contrapartida, a especulação “ávida”(eager) aumenta o risco de que páginas pré-montadas não sejam vistas. Alternativamente, o plugin oferece especular apenas com o mouse/ponteiro clicado (modo “conservative”, conservador), o que reduz ainda mais este risco, e é uma opção para websites que não se importam em ter ganhos menores de desempenho.

Uma página pré-montada é vinculada à página que a chama, então a personalização pode já ser conhecida neste ponto e as alterações (por exemplo, navegar em outros produtos ou iniciar/encerrar uma sessão) geralmente exigem um novo carregamento de página e, portanto, um novo pré-montador, que levará isso em consideração. Mas definitivamente é algo para estar ciente e testar! As páginas pré-montadas podem ser canceladas removendo da página o elemento <script>com as regras de especulação, usando APIs DOM padrão do JavaScript, caso isso seja necessário quando o estado mudar sem uma nova carga de página.

Onde posso enviar os meus comentários sobre o plugin?

Comentários e sugestões são encorajados e muito apreciados, especialmente porque este plugin pode conter futuras funcionalidades para o núcleo do WordPress. Se tiver sugestões ou pedidos de novas funcionalidades, pode submetê-los como um issue no repositório GitHub da equipe de desempenho do WordPress. Se precisar de ajuda para resolver problemas ou tiver uma pergunta sobre o plugin, por favor crie um novo tópico no nosso fórum de suporte.

Onde posso relatar erros de segurança?

A equipe de desempenho e a comunidade WordPress levam as brechas de segurança a sério. Apreciamos os seus esforços para divulgar de forma responsável as suas descobertas e faremos nosso melhor para reconhecer as suas contribuições.

Para comunicar um problema de segurança, visite o programa WordPress HackerOne.

Como eu posso contribuir com o plugin?

Contribuições são sempre bem-vindas! Saiba mais sobre como se envolver com o projeto, consulte o Manual da equipe de desempenho do WordPress