Se você encontrar uma mensagem Uncaught ReferenceError , selecione-a – isso deve abrir uma nova tela contendo uma mensagem de erro. Para saber mais sobre esse erro, clique no ícone de X vermelho que o acompanha .
Ao revisar cuidadosamente todas as informações, você poderá diagnosticar o que está causando o erro. Se não tiver certeza sobre um erro específico, você pode tentar inserir o texto do erro em um mecanismo de pesquisa. Como alternativa, você pode postar a mensagem de erro completa em um site de perguntas e respostas com foco em tecnologia, como Stack Overflow .
Como mencionamos, você também pode verificar se há erros usando o Console da Web do Firefox ou o Microsoft Edge DevTools . No entanto, se estiver usando o Safari, você precisará habilitar as Ferramentas do Desenvolvedor antes de solucionar os problemas de instalação do WordPress.
Na barra de ferramentas do Safari, selecione Safari> Preferências> Avançado e selecione Mostrar menu de desenvolvimento na barra de menus. Agora você pode abrir a página em que está encontrando o problema e selecionar Desenvolver> Mostrar console de erro na barra de ferramentas do Safari.
4 maneiras de resolver um conflito de jQuery
Se você verificou que um conflito de jQuery está causando problemas com o seu site, existem etapas que você pode seguir para resolver esses problemas. Vamos examiná-los agora.
1. Atualize todos os seus temas e plug-ins
Desde o lançamento do WordPress 5.5, os desenvolvedores de temas e plugins têm trabalhado arduamente para atualizar seus softwares. Se você estiver executando um tema ou plugin desatualizado, pode estar encontrando um problema que já foi corrigido.
Para verificar se há atualizações disponíveis, faça login no painel do WordPress e selecione Atualizações . A partir daqui, você pode (é claro) atualizar todos os seus temas e plug-ins.
Se você instalou uma ou mais atualizações, verifique se isso resolveu o seu problema. Nosso conselho é tentar replicar o problema original ou, se você souber como procurá-lo, solucione o problema de seu site usando um kit de ferramentas como o Chrome DevTools.
2. Entre em contato com o desenvolvedor
Se você instalou a atualização mais recente e ainda está encontrando problemas, entrar em contato com o desenvolvedor do tema ou do plugin é uma boa ideia. É possível que o desenvolvedor não saiba do conflito do jQuery ou esteja planejando lançar uma atualização.
Se você baixou o tema ou plug-in do diretório oficial de plug-ins do WordPress, verifique a lista do plug-in. Essas listas geralmente incluem informações sobre sites, fóruns ou perfis de mídia social onde você pode entrar em contato com a equipe por trás do plugin ou tema em questão. Às vezes, essas listagens podem até conter os detalhes de contato direto do desenvolvedor.
Como alternativa, alguns desenvolvedores optam por incluir suas informações de contato no nível do código. Se você baixou o tema ou plugin para o seu computador, tente descompactar a pasta e procurar um arquivo que contenha os detalhes do desenvolvedor. O arquivo README geralmente é um bom lugar para começar. Esses arquivos geralmente contêm os nomes dos principais contribuidores ou o processo de contato com o suporte.
Ao entrar em contato com o desenvolvedor sobre os problemas que você está enfrentando, inclua o máximo de informações possível. Se você explorou o erro usando um kit de ferramentas como o Chrome DevTools, é uma boa idéia compartilhar esses dados com o plugin ou desenvolvedor do tema.
3. Verifique se o plugin ou tema não é mais mantido
Muitos plug-ins e temas são projetos apaixonados, em vez de empreendimentos comerciais. Quando um projeto é liderado por uma equipe muito pequena ou um único desenvolvedor, sempre há uma chance de que o projeto perca o ímpeto e pare de ser mantido, ou até mesmo abandonado.
O diretório oficial de plug-ins do WordPress exibe a data em que cada tema e plug-in foram atualizados pela última vez. Diferentes tipos de software requerem atualizações mais frequentes do que outros. No entanto, se um plugin ou tema não for atualizado dentro de seis meses, você deve abordar com cuidado.
Se um plugin ou tema tiver presença em um site ou mídia social, você também pode verificar se há atividades recentes. Tweets recentes ou um blog atualizado regularmente sugere que o tema ou plugin ainda está em desenvolvimento ativo.
Se você suspeitar que o tema ou plugin foi abandonado ou não é mais mantido, a solução é encontrar um que esteja sendo desenvolvido ativamente. Quase todas as vulnerabilidades do WordPress estão relacionadas a plug-ins , por isso é sempre uma boa ideia substituir temas e plug-ins não mantidos , independentemente dos conflitos do jQuery.
4. Use o plugin jQuery Migrate
Se você estiver enfrentando conflitos de jQuery relacionados à atualização 5.5, o WordPress tem sua própria solução temporária – o plugin Enable jQuery Migrate Helper . Se você precisar continuar usando um plugin ou tema que está causando conflitos no jQuery, este plugin fornece uma correção compatível com versões anteriores.
Essencialmente, ele reativa o script de migração para o seu site e dá ao desenvolvedor do tema ou do plugin algum tempo extra para atualizar o software.
Enquanto, o plugin auxiliar Enable jQuery é projetado para rodar em produção – isto é, em um site ativo – ele não corrige o que está quebrado pela atualização do WordPress 5.5. Como tal, você deve tratar este plugin como uma correção temporária, ao invés de uma solução permanente.
Preparando-se para WordPress 5.6 e além
Desativar o jQuery Migrate é a primeira etapa nos planos de três etapas do WordPress para jQuery. De acordo com Andrew Ozz, um dos desenvolvedores líderes, o WordPress planeja “provisoriamente” atualizar para a versão mais recente do jQuery e jQuery User Interface (UI) 1.12.1 no WordPress 5.6 . A versão mais recente do jQuery Migrate também será adicionada como parte do lançamento do WordPress 5.6.
O objetivo final é remover totalmente a dependência do jQuery Migrate. Portanto, no WordPress 5.7, a equipe planeja remover o jQuery Migrate, embora atualmente não esteja agendado para lançamento até 2021.
A longo prazo, Andrew Ozz sugeriu que o WordPress pretende mover a seção de administração para o JavaScript vanilla. “Há muito código para migrar, então vai demorar um pouco”, disse ele. Ele também confirmou que as bibliotecas e plug-ins jQuery permanecerão disponíveis para enfileirar por meio do Script Loader, a fim de manter a compatibilidade com versões anteriores.
Como preparar seu site WordPress para o futuro
Para evitar problemas no futuro, você deve começar a preparar seu site para WordPress 5.6 e 5.7 agora. Você pode testar como seu site funciona em vários ambientes jQuery, usando o plug-in Test jQuery Updates.
No WordPress 5.6, o plano atual é atualizar para a versão mais recente do jQuery e jQuery UI, mas deixar o plugin jQuery Migrate habilitado. Para testar esta configuração, navegue até Plugins> Testar atualizações do jQuery .
Agora você pode alterar a versão do jQuery para 3.5.1 e alterar a UI do jQuery para 1.12.1 . Você também deve garantir que o jQuery Migrate esteja definido como Enabled .
Agora, coloque seu site à prova. Se você encontrar qualquer comportamento inesperado, pode solucionar esses problemas usando um kit de ferramentas como o Chrome DevTools.
Para o lançamento do WordPress 5.7, a equipe planeja remover o jQuery Migrate. Para testar seu site neste ambiente, você deve definir jQuery Migrate como Disabled . Você também deseja definir a versão do jQuery e a interface do usuário do jQuery para a versão mais recente disponível.
Agora você pode testar seu site para quaisquer problemas ou erros. Se você experimentar o plugin Test jQuery Updates, lembre-se de restaurar as configurações padrão do plugin depois de terminar o teste. Como alternativa, você pode desativar ou excluir este plug-in se não for mais necessário.
Conclusão do conflito do WordPress jQuery
O conflito do WordPress jQuery pode causar problemas com milhares de temas e plug-ins de terceiros. Se você estiver tendo problemas após atualizar para 5.5, existem etapas que você pode seguir para resolvê-los:
- Verifique se você tem a versão mais recente de todos os temas e plug-ins.
- Contate o desenvolvedor sobre quaisquer conflitos de jQuery que você encontrar.
- Considere se o tema ou plugin foi abandonado.
- Reative o script de migração, usando Enable jQuery Migrate Helper .
Se você estiver preocupado com as atualizações do WordPress ou tiver conflitos com seus plug-ins e temas, seu provedor de hospedagem na web pode oferecer suporte. Na A2 Hosting, todos os nossos planos oferecem suporte 24 horas nos sete dias da semana como padrão . Você pode acessar o suporte via chat ao vivo, e-mail ou telefone, e todas as solicitações de suporte são tratadas por nossa equipe selecionada de especialistas em WordPress.