WOOF :: enqueue_theme_js( Array / String $files, Array $deps = array(), Boolean $in_footer = false, Boolean $timestamp = true, Boolean $root_relative = true, String $default_extension = "js", String $parent = "auto" )
A wrapper for wp_enqueue_script which can enqueue more than one stylesheet in your theme at once and assumes a base folder of THEME_DIR/js.
Note that this method runs all URLs through WOOF::theme_url which is child theme-aware, with the default setting being to look for files first in the child theme directory then the parent theme directory.
Note: in the example, we show this called directly in the template file before the call to wp_head(), but you also make use of the wp_enqueue_scripts action to call these functions. As long as the calls are before wp_head though, the effect is the same.
Parameters:
-
An array or CSV string of file names. The CSV string may contain spaces for clarity, these will be trimmed. If specified as a string you may also use the format:
sub_dir: filename1, filename2
which will cause all files to be prefixed by the sub_dir as well as the default base directory.
-
Array $deps = array()
An array of string IDs of previously registered stylesheets that must be loaded before this script. See: http://codex.wordpress.org/Function_Reference/wp_enqueue_script#Default_scripts_included_with_WordPress for more details.
-
Boolean $in_footer = false
Whether the script should be output in the footer
-
Boolean $timestamp = true
If true, a timestamp will be added to all URLs to ensure that as files change the URL will change too, which prevents unwanted caching.
-
Boolean $root_relative = true
Whether to use root relative URLs (excludes the protocol and domain)
-
String $default_extension = "js"
An extension to use if you do not specify an extension in any of the filenames. Note: take care with this, as specifying a filename of “script.min” without the js extension will still be taken as having an extension (.min).
-
String $parent = "auto"
Specifies where to look for the file, in the case of the current theme being a child-theme. If the active theme is not a child theme, this argument is essentially ignored. The following values are supported:
- “auto” – Will look for the file first in the child theme folder and if not found will then check the folder of the parent theme.
- false – Will only check for the file in the child theme. This will always return a URL as if the file exists, even if it does not.
- true – Will only check for the file in the parent theme. This will always return a URL as if the file exists, even if it does not.