Documentation

Assets
in package

Application

Uses UtilsProvider, Assets

Assets handling.

Properties

$ASSETS_BUMP : mixed: For future implementations and updates of this class you can differ from BUMP version.

Methods

admin_enqueue_scripts() : mixed: Enqueue scripts and styles for admin pages.
anonymous_localize_script() : mixed: Make a localized array anonymous. Some plugins like WP Rocket tries to lazy load also localized scripts and this should be avoided in some scenarios like Real Cookie Banners' banner script.
customize_controls_print_scripts() : mixed: Enqueue scripts in customize (not preview!)
enableAdvancedEnqueue() : mixed: Allows to enable advanced enqueue features for a given handle.
enableAsyncEnqueue() : mixed: Enable `async` attribute for given handle(s) (only scripts are supported).
enableDeferredEnqueue() : mixed: Enable `defer` attribute for given handle(s) (only scripts are supported, see https://stackoverflow.com/a/25890780).
enablePreloadEnqueue() : mixed: Enable `<link rel="preload" />` HTML tag for given handle(s).
enablePriorityQueue() : mixed: Enable scripts and styles to be appear at the top of `<head`.
enqueue_scripts_and_styles() : mixed: Enqueue scripts and styles depending on the type. This function is called from both admin_enqueue_scripts and wp_enqueue_scripts. You can check the type through the $type parameter. In this function you can include your external libraries from public/lib, too.
enqueueComposerScript() : string: Enqueue a composer package script from our multi-package repository.
enqueueComposerStyle() : string: Enqueue a composer package style from our multi-package repository.
enqueueLibraryScript() : string|bool: Wrapper for Assets#enqueueScript() method with $isLib = true.
enqueueLibraryStyle() : string|bool: Wrapper for Assets#enqueueStyle() method with $isLib = true.
enqueueMobx() : mixed: Enqueue mobx state management library.
enqueueReactJsxRuntime() : mixed: When using WordPress < 6.6 we need to enqueue the react/jsx-runtime UMD bundle to make the `ReactJSXRuntime` external work.
enqueueScript() : string|bool: Registers the script if $src provided (does NOT overwrite), and enqueues it. Use this wrapper method instead of wp_enqueue_script if you want to use the cachebuster for the given src. If the src is not found in the cachebuster (inc/base/others/cachebuster.php) it falls back to _VERSION.
enqueueStyle() : string|bool: Enqueue a CSS stylesheet. Use this wrapper method instead of wp_enqueue_style if you want to use the cachebuster for the given src. If the src is not found in the cachebuster (inc/base/others/cachebuster.php) it falls back to _VERSION.
enqueueUtils() : mixed: Enqueue utils and return an array of dependencies.
getAsciiUrl() : string: Convert a complete URL to IDN url. This is necessery if you use a URIBuilder like lil-url in your frontend.
getCachebusterVersion() : string: Get the cachebuster entry for a given file. If the $src begins with public/lib/ it will use the inc/base/others/cachebuster-lib.php cachebuster instead of inc/base/others/cachebuster.php.
getChunkTranslationMap() : mixed: Get a map of available translations for all available chunks.
getFirstAssetsToEnqueueComposer() : mixed: Get first found instance of utils' Assets class. This is needed to we can enqueue assets from their.
getPluginConstantPrefix() : string: Get the prefix of this package so we can utils package natively.
getPluginsUrl() : string: Wrapper for plugins_url. It respects the public folder depending on the SCRIPTS_DEBUG constant.
getPublicFolder() : string: Gets a public folder depending on the debug mode relative to the plugins folder with trailing slash.
instance() : mixed: New instance.
isScreenBase() : bool: Checks if a specific screen is active.
isSomeWelcomePage() : mixed: Get initiator if the current page is a welcome page.
load_script_textdomain_relative_path() : mixed: Force the basename for the md5 of a loaded JSON translation file.
load_script_translation_file() : mixed: Fix correct filename for enqueued composer packages.
localizeScript() : mixed: Localize the WordPress backend and frontend.
login_enqueue_scripts() : mixed
overrideLocalizeScript() : array<string|int, mixed>: Localize the plugin with additional options.
probablyDeregisterWhenNewerVersion() : mixed: Probably deregister a given handle when our requested version is higher than the current enqueued version script / style.
setLazyScriptTranslations() : mixed: The function and mechanism of wp_set_script_translations() is great of course. Unfortunately popular plugins like WP Rocket and Divi are not compatible with it (especially page builders and caching plugins). Why? Shortly explained, the injected inline scripts relies on `wp.i18n` which can be deferred or async loaded (the script itself) -> wp is not defined.
setupConstants() : mixed: Make sure the REAL_UTILS constants are available.
useNonMinifiedSources() : bool: Check if SCRIPT_DEBUG is set to true.
wp_enqueue_scripts() : mixed: Enqueue scripts and styles for frontend pages.
enqueue() : string|bool: Enqueue helper for entry points and libraries. See dependents for more documentation.
enqueueComposer() : string|bool: Enqueue helper for monorepo packages. See dependents for more documentation.
enqueueCrossSelling() : mixed: Enqueue cross selling script if possible.
enqueueFeedback() : mixed: Enqueue script for plugins page so "Deactivate" opens a popup.
enqueueHelper() : mixed: Enqueue helper from each initiator until one valid is found.
enqueueWelcome() : mixed: Enqueue script for welcome page.
getTranslationSuffixByBasename() : mixed: Get the suffix for `chunks` localized variable including dependencies.
probablyEnqueueChunk() : mixed: Checks if a `vendor-` file is created for a given script and enqueue it.
probablyEnqueueComposerChunk() : mixed: Checks if a `vendor-` file is created for a given script in a composer package and enqueue it.
__construct() : mixed: C'tor.

$ASSETS_BUMP

For future implementations and updates of this class you can differ from BUMP version.


    public
    static    mixed
    $ASSETS_BUMP
     = 4

Increment, if needed.

admin_enqueue_scripts()

Enqueue scripts and styles for admin pages.


    public
                    admin_enqueue_scripts(string $hook_suffix) : mixed

Parameters

$hook_suffix : string: The current admin page

anonymous_localize_script()

Make a localized array anonymous. Some plugins like WP Rocket tries to lazy load also localized scripts and this should be avoided in some scenarios like Real Cookie Banners' banner script.


    public
                    anonymous_localize_script(string $handle, string $object_name, array<string|int, mixed> $l10n[, array<string|int, mixed> $settings = [] ]) : mixed

Use this instead of wp_localize_script.

Settings:

string[]     makeBase64Encoded       List of keys of the array object which should be converted to base64 at output time (e.g. to avoid ModSecurity issues)
boolean      useCore                 Use `wp_localize_script` internally instead of custom localize script
string[]     lazyParse               A list of pathes of the array which should be lazy parsed. This could be useful to improve performance and parse as needed (e.g. huge arrays).

Parameters

$handle : string: Name of the script to attach data to.
$object_name : string: Name of the variable that will contain the data.
$l10n : array<string|int, mixed>: Array of data to localize.
$settings : array<string|int, mixed> = []

customize_controls_print_scripts()

Enqueue scripts in customize (not preview!)


    public
                    customize_controls_print_scripts() : mixed

enableAdvancedEnqueue()

Allows to enable advanced enqueue features for a given handle.


    public
                    enableAdvancedEnqueue(string|array<string|int, string> $handles[, array<string|int, string> $features = null ][, string $type = 'script' ]) : mixed

Parameters

$handles : string|array<string|int, string>
$features : array<string|int, string> = null: See $ADVANCED_ENQUEUE_FEATURE_* constants or null for all features
$type : string = 'script': Can be script or style

enableAsyncEnqueue()

Enable `async` attribute for given handle(s) (only scripts are supported).


    public
                    enableAsyncEnqueue(string|array<string|int, string> $handles) : mixed

Parameters

$handles : string|array<string|int, string>

enableDeferredEnqueue()

Enable `defer` attribute for given handle(s) (only scripts are supported, see https://stackoverflow.com/a/25890780).


    public
                    enableDeferredEnqueue(string|array<string|int, string> $handles) : mixed

Parameters

$handles : string|array<string|int, string>

enablePreloadEnqueue()

Enable `<link rel="preload" />` HTML tag for given handle(s).


    public
                    enablePreloadEnqueue(string|array<string|int, string> $handles[, string $type = 'script' ]) : mixed

Parameters

$handles : string|array<string|int, string>
$type : string = 'script': Can be script or style

enablePriorityQueue()

Enable scripts and styles to be appear at the top of `<head`.


    public
                    enablePriorityQueue(string|array<string|int, string> $handles[, string $type = 'script' ]) : mixed

Parameters

$handles : string|array<string|int, string>
$type : string = 'script': Can be script or style

enqueue_scripts_and_styles()

Enqueue scripts and styles depending on the type. This function is called from both admin_enqueue_scripts and wp_enqueue_scripts. You can check the type through the $type parameter. In this function you can include your external libraries from public/lib, too.


    public
                    enqueue_scripts_and_styles(string $type[, string $hook_suffix = null ]) : mixed

Note: The scripts are loaded only on backend (admin_enqueue_scripts). If your plugin is also loaded on frontend you need to make sure to enqueue via wp_enqueue_scripts, too. See also https://app.clickup.com/t/4rknyh for more information about this (commits).

Parameters

$type : string: The type (see Assets constants)
$hook_suffix : string = null: The current admin page

enqueueComposerScript()

Enqueue a composer package script from our multi-package repository.


    public
                    enqueueComposerScript(string $handle[, array<string|int, string> $deps = [] ][, string $src = 'index.js' ][, bool $in_footer = true ]) : string

Parameters

$handle : string: Name of the package.
$deps : array<string|int, string> = []: An array of registered scripts handles this script depends on.
$src : string = 'index.js': The file to use in dist or dev folder.
$in_footer : bool = true: Whether to enqueue the script before instead of in the .

Return values

string —

The used handle

enqueueComposerStyle()

Enqueue a composer package style from our multi-package repository.


    public
                    enqueueComposerStyle(string $handle[, array<string|int, string> $deps = [] ][, string $src = 'index.css' ][, string $media = 'all' ]) : string

Parameters

$handle : string: Name of the package.
$deps : array<string|int, string> = []: An array of registered scripts handles this script depends on.
$src : string = 'index.css': The file to use in dist or dev folder.
$media : string = 'all': The media for which this stylesheet has been defined. Accepts media types like 'all', 'print' and 'screen', or media queries like '(orientation: portrait)' and '(max-width: 640px)'.

Return values

string —

The used handle

enqueueLibraryScript()

Wrapper for Assets#enqueueScript() method with $isLib = true.


    public
                    enqueueLibraryScript(string $handle, mixed $src[, array<string|int, string> $deps = [] ][, bool $in_footer = false ]) : string|bool

Parameters

$handle : string
$src : mixed
$deps : array<string|int, string> = []
$in_footer : bool = false

Return values

string|bool —

The used handle

enqueueLibraryStyle()

Wrapper for Assets#enqueueStyle() method with $isLib = true.


    public
                    enqueueLibraryStyle(string $handle, mixed $src[, array<string|int, string> $deps = [] ][, string $media = 'all' ]) : string|bool

Parameters

$handle : string
$src : mixed
$deps : array<string|int, string> = []
$media : string = 'all'

Return values

string|bool —

The used handle

enqueueMobx()

Enqueue mobx state management library.


    public
                    enqueueMobx() : mixed

enqueueReactJsxRuntime()

When using WordPress < 6.6 we need to enqueue the react/jsx-runtime UMD bundle to make the `ReactJSXRuntime` external work.


    public
                    enqueueReactJsxRuntime() : mixed

enqueueScript()

Registers the script if $src provided (does NOT overwrite), and enqueues it. Use this wrapper method instead of wp_enqueue_script if you want to use the cachebuster for the given src. If the src is not found in the cachebuster (inc/base/others/cachebuster.php) it falls back to _VERSION.


    public
                    enqueueScript(string $handle, mixed $src[, array<string|int, string> $deps = [] ][, bool $in_footer = true ][, bool $isLib = false ]) : string|bool

You can also use something like this to determine SCRIPT_DEBUG files:

$this->enqueueLibraryScript(
    Constants::ASSETS_HANDLE_REACT_DOM,
    [[$useNonMinifiedSources, 'react-dom/umd/react-dom.development.js'], 'react-dom/umd/react-dom.production.min.js'],
    Constants::ASSETS_HANDLE_REACT
);

Parameters

$handle : string: Name of the script. Should be unique.
$src : mixed: The src relative to public/dist or public/dev folder (when $isLib is false)
$deps : array<string|int, string> = []: An array of registered script handles this script depends on.
$in_footer : bool = true: Whether to enqueue the script before instead of in the .
$isLib : bool = false: If true the public/lib/ folder is used.

Return values

string|bool —

The used handle

enqueueStyle()

Enqueue a CSS stylesheet. Use this wrapper method instead of wp_enqueue_style if you want to use the cachebuster for the given src. If the src is not found in the cachebuster (inc/base/others/cachebuster.php) it falls back to _VERSION.


    public
                    enqueueStyle(string $handle, mixed $src[, array<string|int, string> $deps = [] ][, string $media = 'all' ][, bool $isLib = false ]) : string|bool

It also allows $src to be like in enqueueScript()

Parameters

$handle : string: Name of the style. Should be unique.
$src : mixed: The src relative to public/dist or public/dev folder (when $isLib is false)
$deps : array<string|int, string> = []: An array of registered style handles this style depends on.
$media : string = 'all': The media for which this stylesheet has been defined. Accepts media types like 'all', 'print' and 'screen', or media queries like '(orientation: portrait)' and '(max-width: 640px)'.
$isLib : bool = false: If true the public/lib/ folder is used.

Return values

string|bool —

The used handle

enqueueUtils()

Enqueue utils and return an array of dependencies.


    public
                    enqueueUtils() : mixed

getAsciiUrl()

Convert a complete URL to IDN url. This is necessery if you use a URIBuilder like lil-url in your frontend.


    public
                    getAsciiUrl(string $url) : string

Parameters

$url : string: The url

Return values

string

getCachebusterVersion()

Get the cachebuster entry for a given file. If the $src begins with public/lib/ it will use the inc/base/others/cachebuster-lib.php cachebuster instead of inc/base/others/cachebuster.php.


    public
                    getCachebusterVersion(string $src[, bool $isLib = false ][, string $default = null ]) : string

Parameters

$src : string: The src relative to public/ folder
$isLib : bool = false: If true the cachebuster-lib.php cachebuster is used
$default : string = null

Return values

string —

_VERSION or cachebuster timestamp

getChunkTranslationMap()

Get a map of available translations for all available chunks.


    public
                    getChunkTranslationMap() : mixed

getFirstAssetsToEnqueueComposer()

Get first found instance of utils' Assets class. This is needed to we can enqueue assets from their.


    public
                    getFirstAssetsToEnqueueComposer() : mixed

getPluginConstantPrefix()

Get the prefix of this package so we can utils package natively.


    public
                    getPluginConstantPrefix() : string

Return values

string

getPluginsUrl()

Wrapper for plugins_url. It respects the public folder depending on the SCRIPTS_DEBUG constant.


    public
                    getPluginsUrl(string $asset[, bool $isLib = false ]) : string

Parameters

$asset : string: The file name relative to the public folder path (dist or dev)
$isLib : bool = false: If true the public/lib/ folder is used.

Return values

string

getPublicFolder()

Gets a public folder depending on the debug mode relative to the plugins folder with trailing slash.


    public
                    getPublicFolder([bool $isLib = false ]) : string

Parameters

$isLib : bool = false: If true the public/lib/ folder is returned.

Return values

string

instance()

New instance.


    public
            static        instance() : mixed

isScreenBase()

Checks if a specific screen is active.


    public
                    isScreenBase(string $base) : bool

Parameters

$base : string: The base

Return values

bool

isSomeWelcomePage()

Get initiator if the current page is a welcome page.


    public
                    isSomeWelcomePage() : mixed

load_script_textdomain_relative_path()

Force the basename for the md5 of a loaded JSON translation file.


    public
                    load_script_textdomain_relative_path(string $src) : mixed

Parameters

$src : string

load_script_translation_file()

Fix correct filename for enqueued composer packages.


    public
                    load_script_translation_file(string $file) : mixed

Parameters

$file : string

localizeScript()

Localize the WordPress backend and frontend.


    public
                    localizeScript(string $context) : mixed

Parameters

$context : string

login_enqueue_scripts()


    public
                    login_enqueue_scripts() : mixed

overrideLocalizeScript()

Localize the plugin with additional options.


    public
                    overrideLocalizeScript(string $context) : array<string|int, mixed>

Parameters

$context : string

Return values

array<string|int, mixed>

probablyDeregisterWhenNewerVersion()

Probably deregister a given handle when our requested version is higher than the current enqueued version script / style.


    public
                    probablyDeregisterWhenNewerVersion(string $handle, string $newVersion[, string $type = 'script' ]) : mixed

Parameters

$handle : string
$newVersion : string
$type : string = 'script'

setLazyScriptTranslations()

The function and mechanism of wp_set_script_translations() is great of course. Unfortunately popular plugins like WP Rocket and Divi are not compatible with it (especially page builders and caching plugins). Why? Shortly explained, the injected inline scripts relies on `wp.i18n` which can be deferred or async loaded (the script itself) -> wp is not defined.


    public
                    setLazyScriptTranslations(string $handle, string $domain, string $path) : mixed

In factory i18n.tsx the window.wpi18nLazy is automatically detected and the plugin gets localized.

Parameters

$handle : string
$domain : string
$path : string

setupConstants()

Make sure the REAL_UTILS constants are available.


    public
            static        setupConstants() : mixed

useNonMinifiedSources()

Check if SCRIPT_DEBUG is set to true.


    public
                    useNonMinifiedSources() : bool

Return values

bool

wp_enqueue_scripts()

Enqueue scripts and styles for frontend pages.


    public
                    wp_enqueue_scripts() : mixed

enqueue()

Enqueue helper for entry points and libraries. See dependents for more documentation.


    protected
                    enqueue(string $handle, mixed $src[, array<string|int, string> $deps = [] ][, bool $isLib = false ][, string $type = 'script' ][, bool $in_footer = true ][, string $media = 'all' ]) : string|bool

Parameters

$handle : string
$src : mixed
$deps : array<string|int, string> = []
$isLib : bool = false
$type : string = 'script': Can be 'script' or 'style'
$in_footer : bool = true
$media : string = 'all'

Return values

string|bool —

The used handle

enqueueComposer()

Enqueue helper for monorepo packages. See dependents for more documentation.


    protected
                    enqueueComposer(string $handle[, string $src = 'index.js' ][, array<string|int, string> $deps = [] ][, string $type = 'script' ][, bool $in_footer = true ][, string $media = 'all' ][, string $vendorHandle = null ]) : string|bool

Parameters

$handle : string
$src : string = 'index.js'
$deps : array<string|int, string> = []
$type : string = 'script': Can be 'script' or 'style'
$in_footer : bool = true
$media : string = 'all'
$vendorHandle : string = null

Return values

string|bool —

The used handle

enqueueCrossSelling()

Enqueue cross selling script if possible.


    protected
                    enqueueCrossSelling() : mixed

enqueueFeedback()

Enqueue script for plugins page so "Deactivate" opens a popup.


    protected
                    enqueueFeedback() : mixed

enqueueHelper()

Enqueue helper from each initiator until one valid is found.


    protected
                    enqueueHelper() : mixed

enqueueWelcome()

Enqueue script for welcome page.


    protected
                    enqueueWelcome() : mixed

getTranslationSuffixByBasename()

Get the suffix for `chunks` localized variable including dependencies.


    protected
                    getTranslationSuffixByBasename(string $basename) : mixed

Parameters

$basename : string

probablyEnqueueChunk()

Checks if a `vendor-` file is created for a given script and enqueue it.


    protected
                    probablyEnqueueChunk(string $handle, bool $isLib, string $src, array<string|int, string> &$deps, bool $in_footer, string $media) : mixed

Parameters

$handle : string
$isLib : bool
$src : string
$deps : array<string|int, string>
$in_footer : bool
$media : string

probablyEnqueueComposerChunk()

Checks if a `vendor-` file is created for a given script in a composer package and enqueue it.


    protected
                    probablyEnqueueComposerChunk(string $handle, string $src, array<string|int, string> &$deps, bool $in_footer, string $media) : mixed

Parameters

$handle : string
$src : string
$deps : array<string|int, string>
$in_footer : bool
$media : string

__construct()

C'tor.


    private
                    __construct() : mixed

Assets in package Application Uses UtilsProvider, Assets

Table of Contents

Properties

Methods

Properties

$ASSETS_BUMP

Methods

admin_enqueue_scripts()

Parameters

anonymous_localize_script()

Parameters

Tags

customize_controls_print_scripts()

enableAdvancedEnqueue()

Parameters

enableAsyncEnqueue()

Parameters

enableDeferredEnqueue()

Parameters

Tags

enablePreloadEnqueue()

Parameters

Tags

enablePriorityQueue()

Parameters

enqueue_scripts_and_styles()

Parameters

enqueueComposerScript()

Parameters

Return values

enqueueComposerStyle()

Parameters

Return values

enqueueLibraryScript()

Parameters

Tags

Return values

enqueueLibraryStyle()

Parameters

Tags

Return values

enqueueMobx()

enqueueReactJsxRuntime()

Tags

enqueueScript()

Parameters

Tags

Return values

enqueueStyle()

Parameters

Tags

Return values

enqueueUtils()

getAsciiUrl()

Parameters

Tags

Return values

getCachebusterVersion()

Parameters

Return values

getChunkTranslationMap()

getFirstAssetsToEnqueueComposer()

getPluginConstantPrefix()

Return values

getPluginsUrl()

Parameters

Tags

Return values

getPublicFolder()

Parameters

Return values

instance()

Tags

isScreenBase()

Parameters

Return values

isSomeWelcomePage()

load_script_textdomain_relative_path()

Parameters

Tags

Assets
in package

Application

Uses UtilsProvider, Assets