> ## 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.

# Crear una función

> Paso a paso para crear una función del Panel Dev con pantalla, elemento en el menú, conexión y traducciones, con tres ejemplos completos.

Una función es una carpeta en `painel-dev/funcoes/<id>/` con dos archivos. El `<id>` es el nombre de la carpeta y también la dirección: `?tab=<id>`.

**1. Elige el id**

Minúsculas, números y `-`, de 2 a 32 caracteres, empezando con letra. No puede ser el id de una función fija (`home`, `code`, `sales`…).

**2. Crea funcao.json**

El elemento del menú (`@nav`) y de dónde vienen los datos (`connect`).

**3. Crea tela.html**

El diseño, con las [piezas](https://docs.doglytdc.dev/es/scripts/dev-panel/pieces.md).

**4. Agrega los textos**

Cada `@t.clave` nueva en todos los archivos de `traducoes/`.

**5. Valida y haz merge**

`dev_panel_validate` en la rama y después merge en main. O usa `dev_panel_function_create` en el MCP, que crea la carpeta y valida de una vez.

## funcao.json

| Campo | Regla |
| - | - |
| `@nav.id` | Igual al nombre de la carpeta |
| `@nav.label` | Hasta 40 caracteres o `@t.clave` |
| `@nav.icon` | Un nombre de la lista de iconos |
| `@nav.position` | Entero de 1 a 999 |
| `@nav.group` | Opcional. Sin él, va a **Funciones del panel** |
| `description` | Opcional, hasta 160 caracteres |
| `connect` | Obligatorio. Ver [Conexiones y acciones](https://docs.doglytdc.dev/es/scripts/dev-panel/connections.md) |

Límite: **30 funciones** por script.

## Ejemplo 1 — Avisos (configuración)

Edita campos de la configuración remota del script. El script lee esos valores en `window.DoglyScript.config`.

```json painel-dev/funcoes/avisos/funcao.json theme={null}
{
  "@nav": { "id": "avisos", "label": "@t.aviso.titulo", "icon": "megaphone", "position": 100 },
  "description": "Mensaje que ve quien usa el script.",
  "connect": { "type": "config", "keys": ["aviso_ativo", "aviso_texto", "aviso_tipo", "aviso_cor"] }
}
```

```html painel-dev/funcoes/avisos/tela.html theme={null}
<section class="dt-stack">
  <h2>@t.aviso.titulo</h2>
  <p>@t.aviso.descricao</p>
  <dt-switch bind="aviso_ativo" label="@t.aviso.ativo" />
  <dt-textarea bind="aviso_texto" label="@t.aviso.texto" placeholder="@t.aviso.placeholder" />
  <dt-select bind="aviso_tipo" label="@t.aviso.tipo">
    <dt-option value="info" label="@t.aviso.tipo.info" />
    <dt-option value="alerta" label="@t.aviso.tipo.alerta" />
  </dt-select>
  <dt-color bind="aviso_cor" label="@t.aviso.cor" hint="@t.aviso.cor.dica" />
  <footer>
    <dt-button action="@reload" label="@t.comum.recarregar" tone="ghost" icon="refresh" />
    <dt-button action="@save" label="@t.comum.salvar" icon="check" />
  </footer>
</section>
```

Cada `bind` tiene que estar en `connect.keys`. El panel solo lee y guarda esos campos; el resto de la configuración no se toca.

## Ejemplo 2 — Cupones (función del servidor)

Llama a una función del servidor del script, que decide qué mostrar y qué hace cada botón.

```json painel-dev/funcoes/cupons/funcao.json theme={null}
{
  "@nav": { "id": "cupons", "label": "@t.cupons.titulo", "icon": "ticket", "group": "Personas", "position": 45 },
  "description": "Crea y lista cupones de descuento.",
  "connect": { "type": "function", "name": "cupons" }
}
```

```html painel-dev/funcoes/cupons/tela.html theme={null}
<section class="dt-stack">
  <h2>@t.cupons.titulo</h2>
  <div class="dt-grid">
    <dt-stat bind="ativos" label="@t.cupons.ativos" icon="ticket" />
    <dt-stat bind="usos" label="@t.cupons.usos" icon="chart" />
  </div>
  <dt-text bind="codigo" label="@t.cupons.codigo" placeholder="BIENVENIDO10" />
  <dt-select bind="tipo" label="@t.cupons.tipo" placeholder="@t.cupons.tipo.escolher">
    <dt-option value="pct" label="@t.cupons.tipo.pct" />
    <dt-option value="valor" label="@t.cupons.tipo.valor" />
  </dt-select>
  <dt-number bind="desconto" label="@t.cupons.desconto" min="1" max="100" step="1" />
  <dt-button action="@call:criar" label="@t.cupons.criar" icon="plus" />
  <hr />
  <dt-table bind="lista" columns="codigo,tipo,desconto,usos" empty="@t.cupons.vazio" />
</section>
```

Lo que hace cada botón está en [Conexiones y acciones](https://docs.doglytdc.dev/es/scripts/dev-panel/connections.md#function-función-del-servidor).

## Ejemplo 3 — Informe (colección, solo lectura)

Muestra hasta 100 registros de una colección del script. Las colecciones son **solo lectura** en el Panel Dev: solo `dt-table`, `dt-stat` y `@reload`.

```json painel-dev/funcoes/relatorio/funcao.json theme={null}
{
  "@nav": { "id": "relatorio", "label": "@t.relatorio.titulo", "icon": "bar-chart", "position": 110 },
  "connect": { "type": "collection", "name": "acessos" }
}
```

```html painel-dev/funcoes/relatorio/tela.html theme={null}
<section class="dt-stack">
  <header>
    <h2>@t.relatorio.titulo</h2>
    <dt-button action="@reload" label="@t.comum.recarregar" tone="ghost" icon="refresh" />
  </header>
  <dt-alert tone="info">@t.relatorio.aviso</dt-alert>
  <dt-table bind="itens" columns="usuario,pagina,quando" empty="@t.relatorio.vazio" />
</section>
```

## Los textos

```json painel-dev/traducoes/es.json theme={null}
{
  "@lang": "Español",
  "aviso.titulo": "Avisos",
  "aviso.descricao": "Mensaje que ve quien usa el script.",
  "aviso.ativo": "Mostrar aviso",
  "aviso.texto": "Texto",
  "aviso.placeholder": "Ej.: ¡Nueva versión disponible!",
  "aviso.tipo": "Tipo",
  "aviso.tipo.info": "Información",
  "aviso.tipo.alerta": "Alerta",
  "aviso.cor": "Color",
  "aviso.cor.dica": "Color de la franja del aviso.",
  "comum.salvar": "Guardar",
  "comum.recarregar": "Recargar",
  "cupons.titulo": "Cupones",
  "cupons.criar": "Crear cupón",
  "relatorio.titulo": "Informe"
}
```

Haz lo mismo en `pt-BR.json`, `en.json` y en los idiomas extra. La pantalla **Traducciones** muestra las claves que faltan.


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