function wp_enqueue_script($handle, $src, $deps, $ver, $in_footer);
Paramètres
Nom
Description
$handle
Ce paramètre permet d'indiquer le nom du script.
$src
Ce paramètre permet d'indiquer le chemin vers le script d'un répertoire racine de WordPress. La valeur par défaut est «false».
$deps
Ce paramètre permet d'indiquer un tableau de dépendances de gestionnaires enregistré dans le script. La valeur par défaut est «array()».
$ver
Ce paramètre permet d'indiquer le numéro de version du script, s'il existe. La valeur par défaut est «false».
$in_footer
Ce paramètre permet d'indiquer s'il faut ajouter le script dans le file d'attente avant la balise «» (false) ou avant la balise «
» (true). La valeur par défaut est false.
Description
Cette fonction permet d'ajouter un script dans la file d'attente des scripts à ajouter dans la page Web.
Remarques
Cette fonction doit être appeler par l'intermédiaire d'une fonction «crochet» si vous souhaitez l'appeler dans le Front-End de votre site WordPress et elle appelé par les fonctions «wp_head()» et «wp_footer()».
Si vous tentez d'enregistrer ou de mettre dans la file d'attente un gestionnaire déjà enregistré avec des paramètres différents, les nouveaux paramètres seront ignorées.
Avantage de cette fonction : Il est préférable d'utiliser cette fonction plutôt que d'indiquer directement dans les gabarits le JavaScript pour les raisons suivants : il charge uniquement les scripts en cas de besoin (dont gain de vitesse), gère les dépendances de façon sécuritaire (élimine les erreurs, les erreurs de chargements en double et de collision), pour le contrôle par thème et pour la gestion de mise en cache.
Exemple
L'exemple suivant, insérer par exemple de le fichier «fonctions.php» de votre thème courant permet d'inclure un fichier JavaScript «http://www.gladir.com/include/menu.js» dans le contenu de votre page :
