O que é: wp_enqueue

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 dizer ao WordPress quais scripts e estilos desejam usar em uma página específica, 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 prevenir conflitos entre diferentes scripts e estilos.

Ao enfileirar scripts corretamente, os desenvolvedores podem criar plugins, temas e sites que são eficientes, fáceis de manter e compatíveis.

Glossário: wp_enqueue

Quando você deve enfileirar JavaScript e CSS no WordPress?

Você pode usar código JavaScript e CSS para personalizar seu site WordPress, e os desenvolvedores usam essas linguagens ao criar plugins e temas para WordPress.

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

Se você é proprietário de um site e deseja adicionar JavaScript e CSS a posts e páginas específicas, não precisará usar wp_enqueue. Em vez disso, recomendamos que você use o plugin de snippets de código WPCode, pois é a maneira mais segura de adicionar código a um site WordPress.

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

No entanto, se você é um desenvolvedor ou está aprendendo a criar plugins e temas para WordPress, precisará enfileirar corretamente arquivos JavaScript e folhas de estilo CSS em seus projetos.

Como Funciona o Sistema de Enfileiramento do WordPress?

Novos desenvolvedores podem cometer o erro de chamar scripts e folhas de estilo diretamente em seus plugins e temas. Isso pode levar a conflitos e prejudicar a performance do WordPress.

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

Veja como funciona o sistema de enfileiramento:

  1. Primeiro, você precisa registrar o script ou 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 folhas de estilo usando a função wp_enqueue, e isso informa ao WordPress que você deseja carregá-los.
  3. Em seguida, assim que a página for carregada, o WordPress carregará todos os scripts enfileirados na ordem correta para garantir que tudo funcione adequadamente.

Você pode aprender mais em nosso guia sobre como adicionar JavaScript e estilos corretamente 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.

Você pode gostar de ver alguns exemplos de código úteis que demonstram como usar o sistema de enfileiramento do WordPress.

Aqui está um exemplo de código que você pode colar nos arquivos do seu plugin ou no arquivo functions.php do seu tema para carregar scripts corretamente 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 explicações completas desses exemplos de código, consulte nosso guia sobre como adicionar JavaScript e estilos corretamente no WordPress.

Esperamos que este artigo tenha ajudado você a aprender mais sobre wp_enqueue no WordPress. Você também pode querer ver nossa lista de Leitura Adicional abaixo para artigos relacionados sobre dicas, truques e ideias úteis do WordPress.

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

Leitura Adicional

O Kit de Ferramentas Definitivo para WordPress

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