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.

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.