龙虎赌博

Table of Contents

Crear un módulo (tutorial)

Crear un módulo (tutorial)

Este es un tutorial que muestra el paso a paso para crear un módulo frontend básico de 龙虎赌博. Puede descargar todos los archivos de este módulo en un archivo ZIP:MiDireccionIP.zip.

Que debe construir usted

Durante este tutorial, usted primero debe construir un módulo frontend que adicione una nueva sección en el menú My Address y luego convertirla en un más avanzado módulo frontend que haga una petición HTTP a https://api.seeip.org y mostrar la respuesta - la dirección IP de su computador - en una nueva página in la recién creada sección del menú My Address. A continuación, se observa como se vería el módulo creado:

Parte I - Nueva sección de menú

Agregar un módulo en blanco al frontend de 龙虎赌博

Cree el directorio 惭颈顿颈谤别肠肠颈ó苍 en el directorio 尘ó诲耻濒辞蝉 de su instalación del frontend de 龙虎赌博 (por ejemplo, zabbix/ui/modules).
Cree el archivo manifest.json con los metadatos básicos del módulo (consulte la descripción de los 辫补谤á尘别迟谤辞蝉 compatibles).

ui/modules/惭颈顿颈谤别肠肠颈ó苍/manifest.json

{
       "manifest_version": 2.0,
       "id": &辩耻辞迟;尘颈-诲颈谤别肠肠颈ó苍&辩耻辞迟;,
       "name": "Mi dirección IP",
       "version": "1.0",
       "namespace": "惭颈顿颈谤别肠肠颈ó苍",
       "description": "Mi dirección IP externa".
       }

En el frontend de 龙虎赌博, vaya a la sección Administración → General → 惭ó诲耻濒辞s y haga clic en el botón Escanear directorio.

Localice el nuevo módulo Mi dirección IP en la lista y haga clic en el enlace "Deshabilitado" para cambiar su estado de "Deshabilitado" a "Habilitado" (si el módulo no aparece en la lista, consulte la sección solución de problemas).

El módulo ya está registrado en el frontend. Sin embargo, aún no es visible, ya que aún debe definir su funcionalidad. Una vez que agregue contenido al directorio del módulo, verá los cambios inmediatamente en el frontend de 龙虎赌博 al actualizar la página.

Crear una sección de menú

Cree un archivo Module.php en el directorio MyAddress.

Este archivo implementa una nueva clase Module que extiende la clase CModule predeterminada. La clase 惭ó诲耻濒辞 insertará una nueva sección de menú Mi dirección en el menú principal.

El método setAction() especifica una acción que se ejecutará al hacer clic en la sección del menú. Para empezar, puede utilizar la acción predefinida userprofile.edit, que abrirá la página Perfil de usuario. En la parte III de este tutorial, aprenderá cómo crear una acción personalizada.

ui/modules/MyAddress/Module.php

<?php
       
       namespace Modules\MyAddress;
       
       use 龙虎赌博\Core\CModule,
       APP,
       CMenuItem;
       
       módulo de clase extiende CModule {
       
       class Module extends CModule {
       
       public function init(): void {
       APP::Component()->get('menu.main')
       ->add((new CMenuItem(_('My Address')))
       ->setAction('userprofile.edit'));
       }
       }

Puede reemplazar 'userprofile.edit' con otras acciones, por ejemplo, 'charts.view' (abre gráficos personalizados), 'problems.view' (abre Monitoreo → Problemas), o 'report.status' (abre el informe Información del sistema).

Actualice la interfaz de 龙虎赌博. Ahora hay una nueva sección Mi dirección en la parte inferior del menú principal de 龙虎赌博. Haga clic en Mi dirección para abrir la página Perfil de usuario.

Parte II - Cambio de ubicación de la sección del menú

En esta parte, moverá la sección del menú Mi dirección a la sección Monitoreo y luego le agregará un menú anidado.. Como resultado, los usuarios podrán acceder a dos páginas de submenú desde la sección del menú Monitoreo → Mi dirección.

Abra y edite el archivo Module.php.

ui/modules/MyAddress/Module.php

<?php
       
       namespace Modules\MyAddress;
       
       use 龙虎赌博\Core\CModule,
           APP,
           CMenuItem;
       
       class Module extends CModule {
       
           public function init(): void {
           APP::Component()->get('menu.main')
           ->findOrAdd(_('Monitoring'))
           ->getSubmenu()
           ->insertAfter(_('Discovery'),
           (new CMenuItem(_('Mi dirección')))->setAction('userprofile.edit')
           );
           }
       }

Actualice la interfaz de 龙虎赌博. Expanda la sección del menú Monitoreo y observe que la sección Mi dirección ahora se encuentra debajo de la sección Descubrimiento.

Parte III - 础肠肠颈ó苍 del módulo

Una acción se implementa en dos archivos: actions/MyAddress.php y views/my.address.php. El archivo actions/MyAddress.php se encarga de la implementación de la lógica de negocio, mientras que el archivo views/my.address.php es responsable de la vista.

Cree un directorio actions en el directorio MyAddress.
Cree un archivo MyAddress.php en el directorio actions.

La lógica de negocio se definirá en la clase MyAddress. Esta clase "action" implementará cuatro funciones: init(), checkInput(), checkPermissions() y doAction(). La interfaz de 龙虎赌博 llama a la función doAction() cuando se solicita la acción. Esta función es responsable de la lógica de negocio del módulo.

Los datos deben organizarse como una matriz asociativa. La matriz puede ser multidimensional y contener cualquier dato esperado por la vista.

ui/modules/MyAddress/actions/MyAddress.php

<?php
       
       namespace Modules\MyAddress\Actions;
       
       use CController,
           CControllerResponseData;
       
       class MyAddress extends CController {
       
           public function init(): void {
           $this->disableCsrfValidation();
           }
       
           protected function checkInput(): bool {
           return true;
           }
       
           protected function checkPermissions(): bool {
           return true;
           }
       
           protected function doAction(): void {
           $data = ['my-ip' => file_get_contents("https://api.seeip.org")];
           $response = new CControllerResponseData($data);
           $this->setResponse($response);
           }
       }

Cree un nuevo directorio views en el directorio MyAddress.
Cree un archivo my.address.php en el directorio views y defina la vista del módulo.

Tenga en cuenta que la variable $data está disponible en la vista sin definirla específicamente. El framework pasa automáticamente la matriz asociativa a la vista.

ui/modules/MyAddress/views/my.address.php

<?php
       
       (new CHtmlPage())
           ->setTitle(_('The HTML Title of My Address Page'))
           ->addItem(new CDiv($data['my-ip']))
           ->show();

La acción del módulo debe registrarse en el archivo manifest.json. Abra manifest.json y agregue un nuevo objeto actions que contenga:

la tecla de acción con el nombre de la acción escrito en minúsculas (a-z) y con palabras separadas por puntos (por ejemplo, my.address);
el nombre de la clase de acción (MyAddress) como valor para la clave class del objeto my.address;
el nombre de la vista de acción (my.address) como valor para la clave view del objeto my.address.