> ## Documentation Index
> Fetch the complete documentation index at: https://docs.doglytdc.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Menú y @nav

> Cómo cambiar el orden, el nombre, el icono y el grupo de los elementos del Panel Dev y poner funciones nuevas en el menú.

El menú del Panel Dev es la lista `nav` de `painel-dev/painel.json`. Cada elemento apunta a una función con `@nav`:

| Marca | Apunta a |
| - | - |
| `@core:<id>` | Una función fija |
| `@fn:<id>` | Una función tuya, de la carpeta `painel-dev/funcoes/<id>/` |

## Campos de un elemento

| Campo | Tipo | Regla |
| - | - | - |
| `@nav` | texto | Obligatorio. `@core:<id>` o `@fn:<id>`, sin repetir |
| `label` | texto | Hasta 40 caracteres o `@t.clave` |
| `icon` | texto | Un nombre de la [lista de iconos](https://docs.doglytdc.dev/es/scripts/dev-panel/translations-and-validation.md#iconos) |
| `group` | texto | Título del grupo, hasta 32 caracteres o `@t.clave` |
| `position` | entero | De 1 a 999. Menor queda más arriba |

Cualquier otro campo es rechazado. `hidden`, `remove` y `delete` dan error: **ninguna función del menú se puede borrar aquí**.

## Funciones fijas

| `@core:` | Nombre por defecto | Icono | Grupo | Posición |
| - | - | - | - | - |
| `home` | Inicio | `home` | Visión general | 10 |
| `code` | Código | `code` | Visión general | 20 |
| `releases` | Versiones | `rocket` | Distribución | 30 |
| `installations` | Instalaciones | `monitor` | Distribución | 35 |
| `users` | Usuarios | `users` | Personas | 40 |
| `sales` | Ventas | `wallet` | Personas | 50 |
| `discord` | Bot de Discord | `bot` | Integraciones | 55 |
| `api` | MCP y API | `bot` | Integraciones | 60 |
| `webhook` | Webhook | `webhook` | Integraciones | 70 |
| `backend` | Funciones | `server` | Avanzado | 80 |
| `config` | Configuración | `settings` | Avanzado | 90 |
| `translations` | Traducciones | `languages` | Avanzado | 95 |

`installations` solo aparece en scripts que se instalan en el computador o el celular; `discord`, solo en bots de Discord.

## Ejemplos

### Subir Ventas justo después del Inicio

```json painel-dev/painel.json theme={null}
{
  "nav": [
    { "@nav": "@core:sales", "label": "Facturación", "icon": "trending", "position": 15 }
  ]
}
```

Los elementos que no listas quedan como por defecto.

### Poner una función tuya en el menú

La función ya se coloca sola en el menú con el `@nav` de `funcao.json`. Usa `painel.json` solo para moverla después:

```json painel-dev/painel.json theme={null}
{
  "nav": [
    { "@nav": "@fn:avisos", "group": "Personas", "position": 45 }
  ]
}
```

### Crear un grupo nuevo

Basta con usar el mismo `group` en más de un elemento:

```json painel-dev/painel.json theme={null}
{
  "nav": [
    { "@nav": "@core:sales", "group": "@t.group.money", "position": 41 },
    { "@nav": "@fn:avisos", "group": "@t.group.money", "position": 42 }
  ]
}
```

Y la traducción, en cada idioma:

```json painel-dev/traducoes/es.json theme={null}
{ "@lang": "Español", "group.money": "Dinero" }
```

## Orden final

1. Menor `position` primero.
2. Empate: la función fija va antes que la tuya.
3. Empate entre dos tuyas: orden alfabético del id.

Tus funciones sin `group` van al grupo **Funciones del panel**.

## Dirección de cada elemento

Cada elemento abre con el mismo sistema de pestañas del Dashboard: `?tab=<id>`. Una función en `funcoes/cupons/` abre en `?tab=cupons`; el botón Atrás del navegador vuelve a la pestaña anterior.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.