README

包含用于提高资源（脚本等）加载功能的包

包括路径操作、异步脚本的队列和DNS资源提示。

使用方法

• ::get_file_url_for_environment( $min_path, $non_min_path, $package_path ) -- 与 plugins_url() 类似，但根据常量 SCRIPT_DEBUG 在 $min_path 和 $non_min_path 之间选择。可以使用过滤器 jetpack_get_file_for_environment 来控制返回的URL。
• ::add_resource_hint( $urls, $type ) -- 将域名（字符串或数组）添加到WordPress的资源提示中。接受类型为dns-prefetch（默认）、preconnect、prefetch或prerender。
• ::normalize_path( $path ) -- 标准化路径或URL中的 . 和 .. 组件。
• ::register_script( $handle, $path, $relative_to, $options ) -- 使用由 @wordpress/dependency-extraction-webpack-plugin 产生的数据注册Webpack捆绑脚本和样式。这代替了读取 .asset.php 文件然后调用 wp_register_script()、wp_register_style()（可能根据 is_rtl() 有不同的文件名）和 wp_set_script_translations()。请参阅内联文档以获取详细信息。
• ::enqueue_script( $handle ) -- 将之前使用 ::register_script() 注册的脚本和样式入队。
• ::alias_textdomains_from_file( $file ) -- 使用由 automattic/jetpack-composer-plugin 记录的数据来启用对共享Composer库的翻译的使用。
• ::alias_textdomains( $from, $to, $totype, $ver ) -- 如果由于某种原因 ::alias_textdomains_from_file() 不够用，则手动添加一个文本域别名。

资产包还提供了一个 wp-jp-i18n-loader 脚本来支持使用 @automattic/i18n-loader-webpack-plugin 的Webpack延迟加载包。不需要初始化，只需调用 ::alias_textdomains_from_file() 或 ::alias_textdomains() 即可，如果这些包来自共享Composer库。

测试

$ composer run phpunit

在您的WordPress插件中使用此包

如果您计划在WordPress插件中使用此包，我们建议您使用 Jetpack Autoloader 作为自动加载器。这将允许与其他也使用此包的插件的最大互操作性。

安全性

需要报告安全漏洞？请访问 https://automattic.com/security/ 或直接访问我们的安全漏洞赏金网站 https://hackerone.com/automattic。

许可证

jetpack-assets 使用 GNU通用公共许可证第2版（或更高版本） 许可。