Share
los wp_enqueue_script La función es la mejor solución para cargar archivos JavaScript en su sitio de WordPress. Si está desarrollando un tema que utiliza JavaScript o bibliotecas de JavaScript, el wp_enqueue_script La función es el camino a seguir. Sin embargo, si realmente no ha usado esto antes, puede haber confusiones ... así que hoy, analizaremos en detalle cómo cargar correctamente las secuencias de comandos en su tema o plugin usando la función de puesta en cola..
Ciertos aspectos de las aplicaciones o técnicas utilizadas en este tutorial han cambiado desde que se publicó originalmente. Esto podría hacer que sea un poco difícil de seguir. Recomendamos ver estos tutoriales más recientes sobre el mismo tema:
Si viene de un fondo HTML básico, es probable que esté acostumbrado a simplemente cargar archivos Javascript (incluyendo cualquier cosa, desde jQuery hasta scripts de complementos) directamente en el encabezado o pie de página de su documento. Eso está bien cuando estás en un entorno independiente como una página HTML básica ... pero una vez que introduces la miríada de otros scripts que podrían ejecutarse en una instalación de WordPress, es más difícil hacer lo que llamaré "gestión de multitudes" con tu guiones.
Entonces, ¿por qué no cargar su JavaScript en el encabezado o en el pie de página? La respuesta es bastante simple: al incluir su JavaScript de esa manera, corre el riesgo de tener conflictos con su JavaScript en su instalación (piense, varios complementos que intentan cargar los mismos scripts o diferentes versiones de ese script). Además, tu JavaScript se cargará en cada Página, incluso si no lo necesitas. Esto causará un tiempo de carga innecesariamente más largo para sus páginas, y puede interferir con otro JavaScript, como desde un complemento o dentro del panel de control ... y eso es un No No en el desarrollo de WP.
Utilizando el wp_enqueue_script función. Tendrás un mejor control sobre cómo y cuándo cargarás tu JavaScript. Incluso puede decidir si cargar en el encabezado o pie de página.
los wp_enqueue_script La función es lo que carga los scripts en tu sitio de WordPress. Usualmente lo vas a usar en tu funciones.php expediente.
los wp_enqueue_script La función en sí es bastante sencilla, así que echemos un vistazo a su estructura.
wp_enqueue_script ($ handle, $ src, $ deps, $ ver, $ in_footer);
Accentsconagua
$ manejar content_url, bloginfo ("template_url"), o get_template_directory_uri () (recomendado por la Referencia de funciones de WordPress) para temas, y plugins_url para plugins. $ deps $ ver $ in_footer Como puedes ver, todos los parámetros excepto $ manejar son opcionales. A primera vista esto puede parecer extraño. Especialmente el $ scr parámetro. ¿Cómo puede WordPress localizar el script sin una URL??
La razón detrás de esto es que WordPress viene con scripts integrados. Por ejemplo, jQuery es parte del núcleo de WordPress, y el equipo de desarrollo de WordPress hizo que sea muy simple cargar estos scripts integrados. Todo lo que tienes que hacer es pasar el identificador del script a wp_enqueue_script.
Para obtener la lista completa de los scripts de WordPress integrados y sus controladores. Eche un vistazo a la Referencia de funciones de WordPress.
Ahora que entiendes las partes de wp_enqueue_script. Veamos cómo realmente usas esto con tu tema de WordPress.
Hay otras funciones de WordPress que debe conocer antes de poder comenzar a escribir scripts correctamente.
wp_register_script wp_register_script La función se utiliza para registrar su script con WordPress. Lo que esto significa es que podrás usar wp_enqueue_script para sus scripts al igual que los scripts incorporados que vienen con WordPresswp_register_script es exactamente lo mismo que el wp_enqueue_script Estructura, así que no voy a repasarlo de nuevo. Puede consultar la sección anterior si es necesario.wp_register_script tal como lo harías para wp_enqueue_script. Luego encolar el guión con wp_enqueue_script pasando el mango a ella. wp_deregister_script wp_deregister_script elimina un script registrado.wp_deregister_script wp_dequeue_script elimina un script registrado.La forma más fácil de cargar su script es colocar el wp_enqueue_script donde tu quieras en tu pagina.
Bastante fácil, pero no elegante. Una mejor manera, es utilizar su archivo function.php para cargar sus scripts. Para hacer esto necesitas hacer una función personalizada. Entonces use add_action para inicializar tu función.
load_my_scripts myscript myscript load_my_scripts La secuencia de comandos que acabamos de cargar necesita la versión actual de jQuery para ejecutarse, así que vamos a cancelar el registro de la versión predeterminada que viene con WordPress. Agregamos la nueva versión a nuestra función..
myscript OK, las buenas prácticas para la codificación de WordPress nos obligan a comprobar si existe una función antes de ejecutarla. Esto se logra así.
Esto verifica si su función ya existe. Si no lo hace, ejecutará su función.
Agreguemos esto a nuestro load_my_scripts función
Ahora, si vas a tu página de administrador, no quieres que tu script se cargue. Podría causar un conflicto y romper la página de administración. Una regla general es que no desea que sus scripts personalizados se carguen en la página de administración. Scripts para plugins es una historia diferente. Voy a repasar eso más tarde.
Vamos a comprobar si la página cargada es no La página de administración con! is_admin (). Si no es así, nuestros scripts se cargarán..
Ahora la función se ve así.
Hay que ir Una buena plantilla para que la utilices para poner en cola scripts
OK, ahora que tienes eso abajo. Agreguemos un script que solo se cargará en la página de administración de su complemento..
En realidad es muy simple. Simplemente escriba su función de script tal como lo hicimos en la sección anterior en el archivo de su complemento. Solo ahora, en lugar de usar 'init' en el add_action, use 'admin_init'.
Eso es todo, ahora su script solo se cargará cuando vaya a la página de administración de su plugin.
Espero que esto te ayude a entender mejor Encolar Scripts dentro de WordPress, así que ahora puedes salir y cargar algunos scripts propios!
Si hay algo que no entiendes o te gustaría leer. Recomiendo visitar el Codex de WordPress. Aquí hay una lista de otros enlaces de códice relevantes para ti también:
