Estructura del archivo del módulo

Todo el código relacionado con un módulo se almacena en un solo directorio dentro del directorio modules de la instalación del frontal Zabbix (por ejemplo, zabbix/ui/modules).

Árbol de archivos del módulo

ejemplo_módulo_directorio/ (obligatorio)
   manifest.json (obligatorio) Metadatos y definición de acción.
   Module.php Inicialización del módulo y manejo de eventos.
   acctions/ Archivos de controlador de acción.
       AlgoView.php
       AlgoCreate.php
       AlgoDelete.php
       data_export/
           ExportarComoXml.php
           ExportarComoExcel.php
   views/ Ver archivos.
       ejemplo.algo.view.php
       ejemplo.algo.delete.php
   assets/ Cualquier archivo adicional que se utilizará en las vistas. Debe especificarse en manifest.json.
       js/ archivos JavaScript utilizados en las vistas.
           ejemplo.algo.view.js.php
       css/ Archivos CSS utilizados en las vistas.
           ejemplo.algo.css
        image.png Imágenes utilizadas en las vistas.
        ejemplo.algo.archivo Cualquier archivo para usar en las vistas.

Escribir un módulo

Un proceso de escritura de módulo de muestra consta de los siguientes pasos (si están disponibles, haga clic en el nombre del archivo o carpeta para ver detalles adicionales sobre el paso):

  1. Cree un nuevo directorio para el módulo dentro de zabbix/ui/modules/.
  2. Agregue el archivo manifest.json con los metadatos del módulo.
  3. Cree la carpeta views y defina una(s) vista(s) de módulo.
  4. Cree la carpeta actions y defina una(s) acción(es) de módulo.
  5. Cree el archivo Module.php (o Widget.php para los widgets del tablero) y defina las reglas de inicialización y manejo de eventos.
  6. Cree la carpeta assets para archivos JavaScript (coloquelos en assets/js), Estilos CSS (coloquelos en assets/css) o cualquier otro archivo adicional.
  7. Asegúrese de especificar las vistas, las acciones y los archivos de recursos necesarios en el archivo manifest.json.
  8. Registrar el módulo en la interfaz de Zabbix y comenzar a usarlo.

:::nota Puede registrarse y habilitar un módulo tan pronto como cree el archivo manifest.json. Una vez que el módulo está habilitado, puede obtener una vista previa de todos los cambios realizados en los archivos del módulo inmediatamente al actualizar la interfaz de Zabbix. :::