Blog de engenharia
Como conferimos a mudança antes de gravar no WordPress
Resposta curta
Quando o dono do site escolhe aplicar uma sugestão, buscamos o conteúdo atual do WordPress e conferimos onde a edição se encaixa. Gravamos quando o alvo está claro e, quando é preciso editar à mão, oferecemos o texto para copiar.
Restringir a conexão e o alvo
Guardamos a senha de aplicativo do WordPress criptografada e a usamos para chamar a REST API via HTTPS no host cadastrado. No momento de aplicar, conferimos a situação da assinatura e se a página da proposta pertence àquele site.
Para posts e páginas, comparamos com a URL retornada pelo WordPress. Para a página inicial, lemos a configuração de página inicial do WordPress.
Planejar a partir do valor atual
Em títulos e descrições, o texto original precisa coincidir com um valor atual. Numa edição do conteúdo do post, analisamos o HTML, procuramos uma única ocorrência elegível num nó de texto visível e comparamos a quantidade de nós que não são texto antes e depois da mudança.
Gravar no conteúdo também exige permissão para preservar o HTML. Se o HTML público tiver um marcador reconhecido de construtor de páginas ou se o texto original aparecer em dois lugares elegíveis, oferecemos o texto para o dono do site copiar no próprio editor.
Conferir a resposta e limitar o desfazer
Registramos a mudança planejada antes de gravar e comparamos o valor salvo que volta na resposta com o valor esperado. Se forem diferentes, tentamos restaurar o valor anterior e informamos a falha; a própria restauração pode falhar. Essa restauração também não impede totalmente que uma edição feita no meio do caminho seja sobrescrita.
O desfazer compara um hash do campo alvo inteiro e não sobrescreve o campo se ele mudou depois da gravação. Uma edição entre a leitura e a gravação ainda pode concorrer com esse processo. O conteúdo aplicado à mão a partir de uma cópia fica fora desse caminho de desfazer.
Acompanhe uma edição fictícia no corpo do texto
Suponha que o corpo salvo da página fictícia de uma oficina seja “<p>Consertamos bicicletas.</p>”. O original proposto é “Consertamos bicicletas.” e a substituição é “Fazemos a manutenção de bicicletas.”. Se a URL coincidir, se o original aparecer em um único nó de texto visível elegível e se as outras condições passarem, o sistema planeja essa substituição. Um plano não garante que a gravação vai dar certo.
Se a frase original aparecer duas vezes, o sistema não consegue escolher entre elas e oferece o texto para cópia manual. Um valor atual alterado, uma descrição de SEO de um plugin compatível que não pode ser lida ou a falta de permissão para preservar o HTML também podem impedir a aplicação automática. Compare a proposta com o editor do WordPress e escolha o lugar certo.
Conferir a página e recuperar com cuidado
Antes de aplicar, confira a URL e as duas versões. Depois de aplicar, abra a página pública e veja a frase editada e o layout ao redor. Um cache pode atrasar o que os visitantes veem, então confira separadamente o valor salvo e a exibição pública.
Se o desfazer informar um valor alterado ou falhar, não sobrescreva às cegas as edições posteriores. Compare o campo atual do WordPress com as revisões disponíveis e decida com quem mantém o site o que restaurar. A restauração automática também pode falhar; mudanças coladas à mão ficam fora do caminho de desfazer deste serviço. Para a etapa anterior, veja “Como conferimos as sugestões de IA para sites antes do cliente ver”.