---
url: https://docs.ogmabox.com/es/app/plugins.md
description: >-
  Instala, gestiona, actualiza y desarrolla plugins de Ogma desde paquetes
  locales, carpetas, archivos ZIP y el catálogo.
---

# Plugins {#plugins}

Los plugins amplían Ogma con páginas de interfaz personalizadas, procesamiento de backend, hooks de eventos y paneles de configuración, todo ello limitado a los permisos declarados por el plugin.

## Qué pueden añadir los plugins {#what-plugins-can-add}

* Páginas de interfaz personalizadas accesibles desde la navegación izquierda.
* Rutas de backend que procesan solicitudes o respuestas.
* Hooks de eventos activados por el tráfico capturado.
* Páginas de configuración específicas del plugin.
* Comandos que se pueden registrar en la paleta de comandos.

## Instalar desde una carpeta {#install-from-folder}

1. Haz clic en **Instalar** en la vista Plugins.
2. Elige **Carpeta**.
3. Selecciona el directorio raíz del plugin. El directorio debe contener un manifiesto de plugin válido y los archivos que este declara.
4. Ogma valida el paquete y lo registra.
5. Habilita el plugin para activarlo.

## Instalar desde un archivo ZIP {#install-from-zip-archive}

1. Haz clic en **Instalar** en la vista Plugins.
2. Elige **Zip**.
3. Selecciona el archivo `.zip` del plugin.
4. Revisa el nombre y la versión del plugin detectados.
5. Haz clic en **Instalar** y después habilita el plugin.

Las instalaciones ZIP se copian al directorio de plugins gestionado por Ogma. El archivo original se puede eliminar después de la instalación.

## Advertencias de compatibilidad {#compatibility-warnings}

Después de instalar, Ogma puede mostrar advertencias en la página de detalles del plugin. Son informativas; no impiden que el plugin se ejecute.

Advertencias habituales:

* **Archivos no referenciados**: archivos presentes en el paquete que el manifiesto no declara.
* **Falta una capa de compatibilidad de ejecución**: el plugin utiliza una API que requiere una capa de compatibilidad no incluida en esta versión de Ogma.

Revisa las advertencias antes de habilitar un plugin que no conozcas.

## Habilitar y deshabilitar {#enable-and-disable}

Utiliza el interruptor **Activado** de la fila del plugin para activarlo o desactivarlo. Los plugins deshabilitados permanecen instalados, pero no se ejecutan. Volver a habilitarlos restaura el plugin sin reinstalarlo.

## Pestañas de detalles del plugin {#plugin-detail-tabs}

Selecciona un plugin para abrir su panel de detalles. El panel tiene las siguientes pestañas.

| Pestaña | Contenido |
|-----|----------|
| Resumen | Nombre, versión, autor, descripción y origen del plugin. |
| Advertencias | Problemas de compatibilidad detectados al instalar o habilitar. |
| Permisos | Lo que el plugin solicitó y lo que Ogma concedió en tiempo de ejecución. |
| Archivos | La lista de archivos del paquete del plugin. |
| Registros | Salida de ejecución del plugin, con resaltado de sintaxis para las líneas de registro estructuradas. |
| Interfaz | La página personalizada del plugin, renderizada dentro del panel. |

## Permisos {#permissions}

La pestaña Permisos enumera cada permiso que el plugin declaró en su manifiesto y su estado de concesión actual. Las llamadas de backend se controlan en el servidor. La interfaz refleja el estado actual de cada permiso.

Si un plugin no se comporta como esperas, comprueba en la pestaña Permisos que los permisos necesarios estén concedidos.

## Modo de desarrollo {#dev-mode}

Los plugins instalados desde una carpeta muestran una insignia **Desarrollo** y un botón **Recargar**.

Haz clic en **Recargar** para aplicar cambios de código sin reinstalar. El plugin se reinicia y vuelve a registrar todos los hooks y rutas. Este es el ciclo de iteración habitual para los autores de plugins.

Los plugins en modo de desarrollo permanecen vinculados a la carpeta de origen. Los cambios en los archivos de esa carpeta se aplican en la siguiente recarga.

## Marketplace {#marketplace}

La pestaña **Marketplace** enumera los plugins de la comunidad del registro Awesome Ogma Plugins.

1. Explora o busca en la lista de plugins.
2. Haz clic en un plugin para ver su descripción, versión y metadatos de compatibilidad.
3. Haz clic en **Instalar** para instalarlo directamente.
4. Si hay una versión compatible más reciente de un plugin instalado desde el catálogo, la acción cambia a **Actualizar**.

Las instalaciones del catálogo requieren una conexión de red para descargar el paquete.

## Páginas relacionadas {#related-pages}

* [Inicio rápido de plugins](/es/plugins/quickstart)
* [SDK de backend](/es/plugins/backend-sdk)
* [SDK de frontend](/es/plugins/frontend-sdk)