Desarrollo de Plugins con Paquetes OPM

En esta sección, aprenderás a crear, instalar y distribuir tus propios plugins como paquetes OPM para OTOBO.

---

1. Estructura de un .sopm

El archivo SOPM (*.sopm) contiene todos los metadatos de tu paquete:

<?xml version="1.0" encoding="utf-8"?>
<otobo_package version="1.0">
  <Name>MyExtension</Name>
  <Version>1.0.0</Version>
  <Framework>10.0.x</Framework>   <!-- Versión mínima de OTOBO -->
  <Vendor>TuNombre GmbH</Vendor>
  <URL>https://github.com/tu-usuario/otobo-mypackage</URL>
  <License>GPL-3.0</License>
  <Description Lang="es">Extensión para funciones especiales</Description>
  <ChangeLog Version="1.0.0" Date="13.06.2025 12:00:00">Publicación inicial</ChangeLog>
  <Filelist>
    <File Location="Kernel/Config/Files/XML/MyExtension.xml" Permission="644"></File>
    <File Location="Kernel/System/MyExtension.pm"            Permission="644"></File>
    <File Location="Kernel/Modules/AgentMyPage.pm>           Permission="644"></File>
    <File Location="Kernel/Output/HTML/Standard/AgentMyPage.tt" Permission="644"></File>
    <File Location="Kernel/Language/es_MyExtension.pm"       Permission="644"></File>
  </Filelist>
</otobo_package>

• Name/Version/Framework: Identificador único del paquete y versión compatible de OTOBO.
• Filelist: Todos los archivos que se copiarán durante la instalación.

---

2. Archivos y Estructura de Directorios

Crea tu paquete en un directorio propio, por ejemplo, MyExtension/:

MyExtension/
├─ MyExtension.sopm
├─ Kernel/
│  ├─ Config/Files/XML/MyExtension.xml
│  ├─ System/MyExtension.pm
│  ├─ Modules/AgentMyPage.pm
│  ├─ Output/HTML/Standard/AgentMyPage.tt
│  └─ Language/es_MyExtension.pm
└─ sql/
   └─ create_tables.sql      # opcional, para migraciones de DB

• Kernel/Config/Files/XML/: Registra módulos, menús o campos dinámicos.
• Kernel/System/: Clase de lógica de negocio.
• Kernel/Modules/: Controlador frontend.
• Plantillas y Idioma: Archivos TT + archivo .pm de traducción.

---

3. Construir e Instalar el Paquete

3.1 Crear OPM

Utiliza la herramienta CLI para construir un OPM a partir de tu SOPM:

cd /ruta/a/MyExtension
bin/otobo.Console.pl Dev::Package::Build \
  --sopm-file MyExtension.sopm \
  --output /tmp/MyExtension.opm

3.2 Instalación

Interfaz de Administración: Sube el paquete en Admin → Configuración → Gestión de Paquetes. Consola:

bin/otobo.Console.pl Admin::Package::Install /tmp/MyExtension.opm

Para desinstalar o actualizar:

bin/otobo.Console.pl Admin::Package::Uninstall /tmp/MyExtension.opm
bin/otobo.Console.pl Admin::Package::Upgrade   /tmp/MyExtension.opm

---

4. Puntos de Extensión

4.1 Campos Dinámicos

En Kernel/Config/Files/XML/MyExtension.xml, registra un nuevo Driver de Campo Dinámico:

<Setting Name="DynamicFields::Driver###MyCustomField" Required="0" Valid="1">
  <Navigation>DynamicFields::Driver</Navigation>
  <Value>
    <Array>
      <Item><Hash>
        <Item Key="DriverName">MyCustomField</Item>
        <Item Key="Module">Kernel::System::DynamicField::Driver::MyCustomField</Item>
      </Hash></Item>
    </Array>
  </Value>
</Setting>

Implementa el driver en Kernel/System/DynamicField/Driver/MyCustomField.pm.

4.2 Manejadores de Eventos

Registra tu manejador de eventos:

<Setting Name="Event::EventHandler###MyHandler" Required="0" Valid="1">
  <Navigation>Event::EventHandler</Navigation>
  <Value>
    <Array>
      <Item><Hash>
        <Item Key="Module">Kernel::System::Event::Handler::MyHandler</Item>
      </Hash></Item>
    </Array>
  </Value>
</Setting>

Implementa el manejador en Kernel/System/Event/Handler/MyHandler.pm (método Run()).

4.3 Filtros de Salida

<Setting Name="Output::Filter###MyFilter" Required="0" Valid="1">
  <Navigation>Output::Filter</Navigation>
  <Value>
    <Array>
      <Item><Hash>
        <Item Key="Module">Kernel::System::Output::Filter::MyFilter</Item>
      </Hash></Item>
    </Array>
  </Value>
</Setting>

Filtro en Kernel/System/Output/Filter/MyFilter.pm.

---

5. Despliegue y OTOpar

• Índice de Repositorio: Crea Packages.xml para tu propio repositorio:

  bin/otobo.Console.pl Dev::Package::RepositoryIndex \
    --directory /var/www/otobo-packages

• En SysConfig, añade la URL de tu repositorio en Package::RepositoryList.

• OTOpar: Sube tu OPM a https://otopar.perl-services.de para que otros puedan instalarlo directamente.

---

6. Ejemplo: Paquete MyCalendar

1. Crea el SOPM con el nombre MyCalendar.
2. Script de DB sql/create_calendar.sql para la tabla calendar_events.
3. XML de Configuración define un nuevo campo de ticket "Fecha".
4. Módulo Core Kernel/System/CalendarEvent.pm con métodos CRUD.
5. Módulos Frontend Kernel/Modules/AgentCalendar.pm, plantilla AgentCalendar.tt.
6. Construye el paquete y súbelo a OTOpar.

---

7. Consejos y Buenas Prácticas

• Ajusta el número de versión en el sopm (SemVer).
• Versiona limpiamente las migraciones de DB en sql/.
• Crea pruebas unitarias para las clases de sistema y módulos.
• Documentación en README y POD en módulos Perl.
• Traducciones en Language/es_*.pm y en_*.pm.

Con esto, tendrás una base sólida para desarrollar, distribuir y desplegar tus propios plugins de OTOBO en proyectos de clientes de manera mantenible. ¡Diviértete!