README

DustPress插件：DustPress调试器

DustPress调试器是一个WordPress插件，可以在JSON查看器中显示您的当前DustPress模型加载的数据。

• 贡献者：devgeniem / Nomafin, villesiltala
• 插件URL: https://github.com/devgeniem/dustpress-debugger
• 标签：dustpress, wordpress, 插件, dustjs, dust.js
• 至少需要：4.2.0
• 已测试到：5.3.0
• 许可协议：GPL-3.0
• 许可协议URI: https://gnu.ac.cn/licenses/gpl-3.0.html

安装

Composer

使用composer运行以下命令进行安装

$ composer require devgeniem/dustpress-debugger

或者将其添加到您的 composer.json

{
  "require": {
    "devgeniem/dustpress-debugger": "*"
  }
}

手动安装

• 将DustPress调试器仓库克隆到您的WordPress插件目录。

激活

要启用调试器，请转到WordPress仪表板并激活插件。激活后，具有manage_options权限的用户可以在用户配置文件页面上通过勾选“DustPress调试器已启用”复选框来启用调试器。

您也可以通过在项目中定义DUSTPRESS_DEBUGGER_ALWAYS_ON常量来为任何用户激活调试器。这将覆盖手动设置，因此不建议在生产环境中使用此设置！

使用方法

安装浏览器扩展程序，打开您的开发工具并选择“dustpress-debugger”标签页。如果在第一次打开视图时在Chrome中，您需要请求相关URL的脚本和cookie访问权限。

构建浏览器扩展程序

通过安装 nvm 并运行指定文件中的node版本，在.nvmrc文件中选择指定的node版本

nvm install # install specified node version
nvm use # use specified node version

或者手动安装。

然后运行以下命令

npm ci # install npm packages
npm run build # build the extensions assets

对于使用manifest版本2的firefox构建，您可以运行

npm run build -- --env=target=firefox

构建的资产将在dist/文件夹中。

开发版本

您可以通过运行构建部分中指定的命令来构建扩展程序的开发版本，但不是运行npm run build，而是运行以下命令

npm run watch

或者对于firefox版本

npm run watch -- --env=target=firefox

这将构建资产并等待文件更改。然后根据您使用的浏览器，将dist/文件夹的内容添加为临时插件或未打包的插件。

使用JavaScript添加数据

您可以使用JavaScript的全局调试对象的全局extend函数手动将数据添加到调试器中。第一个参数是您的数据。第二个参数是添加数据的键。您可以在同一键下添加多个数据集。

window.DustPressDebugger.extend('someData', 'my-data-key');

如果您使用的是DustPress.js插件，通过AJAX加载的数据将自动添加到调试器视图中。