这是原厂英文文档的翻译页面. 欢迎帮助我们 完善文档.

模块文件结构

与模块相关的所有代码都存储在 Zabbix 前端安装的 modules 目录内的单个目录中(例如,zabbix/ui/modules)。

模块文件树

example_module_directory/ (必需)
       manifest.json (必需) 元数据和操作定义。
       Module.php 模块初始化和事件处理。
       action/ 操作控制器文件。
       SomethingView.php
       SomethingCreate.php
       SomethingDelete.php
       data_export/
       ExportAsXml.php
       ExportAsExcel.php
       views/ 视图文件。
       example.something.view.php
       example.something.delete.php
       assets/ 视图中使用的任何其他文件。必须在 manifest.json 中指定。
       js/ 视图中使用的 JavaScript 文件。
       example.something.view.js.php
       css/ 视图中使用的 CSS 文件。
       example.something.css
       image.png 视图中使用的图像。
       example.something.file 视图中使用的任何文件。

编写模块

示例模块编写过程包括以下步骤(如果可用,请单击文件或文件夹名称以查看有关该步骤的其他详细信息):

  1. zabbix/ui/modules/ 内为模块创建一个新目录。
  2. 添加包含模块元数据的 manifest.json 文件。
  3. 创建 views 文件夹并定义模块视图。
  4. 创建 actions 文件夹并定义模块操作。
  5. 创建 Module.php(或仪表板小部件的 Widget.php)文件并定义初始化和事件处理规则。
  6. 创建 assets 文件夹,用于存放 JavaScript 文件(放入 assets/js)、CSS 样式(放入 assets/css)或任何其他附加文件。
  7. 确保在 manifest.json 中指定所需的视图、操作和资产文件。
  8. 在 Zabbix 前端 注册 模块并开始使用它。

您可以在创建 manifest.json 文件后立即注册和启用模块。 启用模块后,您可以通过刷新 Zabbix 前端立即预览对模块文件所做的所有更改。