MasterPress 1.2.8 is now available
It was brought to our attention that MasterPress would give a tonne of warnings and deprecation notices when used with PHP 7.4 – this update addresses those.
WOOF :: enqueue_theme_javascript_css( Array / String $file = style.css, Array $deps = array(), String $media = "all", Boolean $timestamp = true, String $default_extension = "css", String $parent = "auto" )
A wrapper for wp_enqueue_style which can enqueue more than one stylesheet in your theme at once and assumes a base folder of THEME_DIR/javascripts. Note that this is to be used for the case where a CSS file is located within your JS file, such as a library that includes stylesheets.
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.
Example:
Parameters:
-
Array / String $file = style.css
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 style.
-
String $media = "all"
The media type the stylsheet is applicable to: E.g. ‘all’, ‘screen’, ‘handheld’, ‘print’.
-
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.
-
String $default_extension = "css"
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 “style.min” without the css 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.