automattic / jetpack-assets
Asset management utilities for Jetpack ecosystem packages
Installs: 361 875
Dependents: 20
Suggesters: 0
Security: 0
Stars: 1
Watchers: 2
Forks: 2
Type:jetpack-library
Requires
- automattic/jetpack-constants: ^1.6.20
Requires (Dev)
- automattic/jetpack-changelogger: ^3.3.1
- brain/monkey: 2.6.1
- wikimedia/testing-access-wrapper: ^1.0 || ^2.0
- yoast/phpunit-polyfills: 1.0.4
- dev-trunk / 1.17.x-dev
- v1.17.30
- v1.17.29
- v1.17.28
- v1.17.27
- v1.17.26
- v1.17.25
- v1.17.24
- v1.17.23
- v1.17.22
- v1.17.21
- v1.17.20
- v1.17.19
- v1.17.18
- v1.17.17
- v1.17.16
- v1.17.15
- v1.17.14
- v1.17.13
- v1.17.12
- v1.17.11
- v1.17.10
- v1.17.9
- v1.17.8
- v1.17.7
- v1.17.6
- v1.17.5
- v1.17.4
- v1.17.3
- v1.17.2
- v1.17.1
- v1.17.0
- v1.16.2
- v1.16.1
- v1.16.0
- v1.15.0
- v1.14.0
- v1.13.1
- v1.13.0
- v1.12.0
- v1.11.10
- v1.11.9
- v1.11.8
- v1.11.7
- v1.11.6
- v1.11.5
- v1.11.4
- 1.11.3
- v1.11.2
- v1.11.1
- v1.11.0
- v1.10.0
- v1.9.1
- v1.9.0
- v1.8.0
- v1.7.0
- v1.6.0
- v1.5.0
- v1.4.0
- v1.3.0
- v1.2.0
- v1.1.1
- v1.1.0
- v1.0.3
- v1.0.1
- v1.0.0
- dev-prerelease
- dev-fix/slack-workflow-branch-detection
- dev-fix/release-branch-typo
- dev-update/generate-branch-plugin
- dev-release-v1.11.2
- dev-release-v1.11.1
- dev-feature/reorg
- dev-release-v1.11.0
- dev-release-v1.10.0
- dev-release-v1.9.1
- dev-release-v1.9.0
- dev-release-v1.8.0
- dev-release-v1.7.0
- dev-release-v1.6.0
- dev-release-v1.5.0
- dev-release-v1.4.0
- dev-release-v1.3.0
- dev-release-v1.2.0
This package is auto-updated.
Last update: 2023-02-06 22:35:03 UTC
README
A package containing functionality to improve loading of assets (scripts, etc).
Includes manipulation of paths, enqueuing async scripts, and DNS resource hinting.
Usage
::get_file_url_for_environment( $min_path, $non_min_path, $package_path )
-- This is similar toplugins_url()
, but chooses between$min_path
and$non_min_path
based on the constantSCRIPT_DEBUG
. The filterjetpack_get_file_for_environment
may be used to control the returned URL.::add_resource_hint( $urls, $type )
-- Adds domains (string or array) to the WordPress' resource hinting. Accepts type of dns-prefetch (default), preconnect, prefetch, or prerender.::normalize_path( $path )
-- Normalize.
and..
components in a path or URL.::register_script( $handle, $path, $relative_to, $options )
-- Register a Webpack bundled script and styles using data produced by@wordpress/dependency-extraction-webpack-plugin
. This replaces reading the.asset.php
file and then making calls towp_register_script()
,wp_register_style()
(with a potentially varying filename based onis_rtl()
), andwp_set_script_translations()
. See the inline documentation for details.::enqueue_script( $handle )
-- Enqueue a script and style previously registered with::register_script()
.::alias_textdomains_from_file( $file )
-- Use data recorded by automattic/jetpack-composer-plugin to enable use of translations for shared Composer libraries.::alias_textdomains( $from, $to, $totype, $ver )
-- Manually add a textdomain alias, if for some reason::alias_textdomains_from_file()
is insufficient.
The Assets package also provides a wp-jp-i18n-loader
script to support Webpack lazy-loaded bundles using @automattic/i18n-loader-webpack-plugin. No initialization is required, other than calling ::alias_textdomains_from_file()
or ::alias_textdomains()
if said bundles are coming from shared Composer libraries.
Testing
$ composer run phpunit