Trusted WordPress tutorials, when you need them most.
Beginner’s Guide to WordPress
Copa WPB
25 Million+
Websites using our plugins
16+
Years of WordPress experience
3000+
WordPress tutorials
by experts

O que é: wp_enqueue

Nota editorial: Ganhamos uma comissão de links de parceiros no WPBeginner. As comissões não afetam as opiniões ou avaliações de nossos editores. Saiba mais sobre Processo editorial.

wp_enqueue é uma função do WordPress que permite aos desenvolvedores enfileirar scripts (arquivos JavaScript) e estilos (arquivos CSS).

Isso significa que os desenvolvedores podem informar ao WordPress quais scripts e estilos desejam usar em uma determinada página, e o WordPress os carregará automaticamente.

Isso ajuda a garantir que suas páginas carreguem de forma rápida e eficiente e também pode ajudar a evitar conflitos entre diferentes scripts e estilos.

Ao enfileirar corretamente os scripts, os desenvolvedores podem criar plug-ins, temas e sites eficientes, compatíveis e passíveis de manutenção.

Glossary: wp_enqueue

Quando você deve enfileirar JavaScript e CSS no WordPress?

Você pode usar códigos JavaScript e CSS para personalizar seu site WordPress, e os desenvolvedores usam essas linguagens ao criar plug-ins e temas do WordPress.

  • O JavaScript é executado no navegador do usuário e é usado para adicionar elementos interativos ao seu site, como controles deslizantes, alertas, botões, pop-ups e muito mais.
  • O CSS (Cascading Style Sheets) é usado para definir a aparência visual do seu site, como o tamanho e a cor das fontes, a cor do plano de fundo e a largura da página.

Se você for proprietário de um site e quiser adicionar JavaScript e CSS a posts e páginas específicos, não precisará usar o wp_enqueue. Em vez disso, recomendamos que você use o plug-in de snippets de código WPCode porque é a maneira mais segura de adicionar código a um site do WordPress.

Você pode saber mais em nossos guias sobre como adicionar JavaScript facilmente e como adicionar CSS personalizado facilmente ao seu site WordPress.

No entanto, se você for um desenvolvedor ou estiver aprendendo a criar plug-ins e temas do WordPress, precisará enfileirar corretamente os arquivos JavaScript e as folhas de estilo CSS em seus projetos.

Como funciona o sistema de fila de espera do WordPress?

Os novos desenvolvedores podem cometer o erro de chamar diretamente scripts e folhas de estilo em seus plug-ins e temas. Isso pode gerar conflitos e prejudicar o desempenho do WordPress.

Para evitar esses problemas, o WordPress oferece um sistema de fila de espera. Isso oferece aos desenvolvedores uma maneira de carregar scripts e folhas de estilo para que tudo funcione corretamente e sem conflitos.

Veja como o sistema de fila funciona:

  1. Primeiro, você precisa registrar o script ou a folha de estilo usando a função wp_register para que o WordPress saiba que ele existe e onde encontrá-lo.
  2. Em seguida, você enfileira os scripts e as folhas de estilo usando a função wp_enqueue, e isso permite que o WordPress saiba que você deseja carregá-los.
  3. Então, quando a página for carregada, o WordPress carregará todos os scripts enfileirados na ordem correta para garantir que tudo funcione corretamente.

Você pode saber mais em nosso guia sobre como adicionar corretamente JavaScript e estilos no WordPress.

Exemplos de código

Você pode usar as funções wp_enqueue_script e wp_enqueue_style para informar ao WordPress quando carregar um arquivo, onde encontrá-lo e quais são suas dependências.

Talvez você queira ver alguns exemplos de código úteis que demonstram como usar o sistema de fila do WordPress.

Aqui está um exemplo de código que você pode colar nos arquivos de plug-in ou no arquivofunctions.php do tema para carregar corretamente os scripts no WordPress:

?php
function wpb_adding_scripts() {
  
wp_register_script('my_amazing_script', plugins_url('amazing_script.js', __FILE__), array('jquery'),'1.1', true);
  
wp_enqueue_script('my_amazing_script');
}
   
add_action( 'wp_enqueue_scripts', 'wpb_adding_scripts' );  
?>

E aqui está um exemplo de como enfileirar suas folhas de estilo:

<?php
function wpb_adding_styles() {
wp_register_style('my_stylesheet', plugins_url('my-stylesheet.css', __FILE__));
wp_enqueue_style('my_stylesheet');
}
add_action( 'wp_enqueue_scripts', 'wpb_adding_styles' );  
?>

Para obter explicações completas sobre esses exemplos de código, consulte nosso guia sobre como adicionar corretamente JavaScript e estilos no WordPress.

Esperamos que este artigo tenha ajudado você a saber mais sobre o wp_enqueue no WordPress. Talvez você também queira ver nossa lista de Leitura adicional abaixo para obter artigos relacionados sobre dicas, truques e ideias úteis do WordPress.

Se você gostou deste artigo, inscreva-se em nosso canal do YouTube para receber tutoriais em vídeo sobre o WordPress. Você também pode nos encontrar no Twitter e no Facebook.

Leitura adicional

Avatar

Editorial Staff at WPBeginner is a team of WordPress experts led by Syed Balkhi with over 16 years of experience in WordPress, Web Hosting, eCommerce, SEO, and Marketing. Started in 2009, WPBeginner is now the largest free WordPress resource site in the industry and is often referred to as the Wikipedia for WordPress.

O kit de ferramentas definitivo WordPress

Obtenha acesso GRATUITO ao nosso kit de ferramentas - uma coleção de produtos e recursos relacionados ao WordPress que todo profissional deve ter!