EasyFields 1: campos personalizados en pestañas sin programar

castor.agra_2284 castor.agra_2284 Noticias Plugin EasyFields Fecha de creación: 28-06-2026 17:27:22 Última actualización: 03-10-2026 Contador de visitas: 267




EasyFields 1: campos personalizados en pestañas sin programar

Manual de EasyFields

EasyFields permite añadir campos personalizados a cualquier ficha de FacturaScripts (Cliente, Producto, Factura…) sin programar, organizados en pestañas. Los datos se guardan en tablas propias del plugin (almacenamiento EAV tipado), sin modificar el esquema del core, de modo que la desinstalación es limpia y robusta ante actualizaciones.

Versión del core: FacturaScripts 2025+ (probado en 2026.x, PHP 8.1+). Idiomas: es_ES / en_EN.

Versión del plugin documentada: 1.0

Si esta versión no coincide con la del plugin instalado (Admin → Plugins), el manual podría estar desactualizado.


1. Conceptos

| Término | Significado |

|----------------|-------------|

| Target | Modelo del core al que se añaden campos: Cliente, Producto, FacturaCliente… |

| Campo | Una definición: clave, etiqueta, tipo, reglas, grupo… |

| Grupo | Nombre de la pestaña donde se agrupa el campo. Cada grupo distinto = una pestaña. |

| Catálogo | Lista de opciones reutilizable para campos select / multiselect. |

| Valor | El dato concreto guardado para un registro (p. ej. la talla del cliente nº 5). |

Cada group_name distinto genera una pestaña en la ficha del target. Los campos sin grupo caen en la pestaña por defecto "Campos personalizados", que siempre queda al final.


2. Crear un campo personalizado

Admin → Campos personalizados → Nuevo.

Crear un campo personalizado

Datos generales

  • Modelo destino (target): desplegable con los modelos del core (Cliente, Producto,

Factura de cliente, Pedido…).

  • Clave: identificador único del campo dentro del target. Sin espacios (usa

talla_zapato, no talla zapato).

  • Etiqueta: texto visible junto al campo en la ficha.
  • Grupo (pestaña): nombre de la pestaña. Vacío = pestaña "Campos personalizados".
  • Tipo: ver la tabla de tipos más abajo.
  • Orden: posición del campo dentro de su pestaña (menor = antes).
  • Activo: si está desmarcado, el campo no se muestra.
  • Obligatorio: bloquea el guardado de la pestaña si se deja vacío.
  • Filtrable en listado: añade un filtro por este campo en el listado del target

(ver sección 5).

Tipos de campo

| Tipo | Se muestra como | Notas |

|---------------|-----------------|-------|

| text | Caja de texto | Reglas de longitud / patrón. |

| textarea | Área de texto | Texto largo. |

| number | Numérico | Reglas de valor mínimo / máximo. |

| date | Selector de fecha | |

| boolean | Casilla | Sí / no. |

| select | Desplegable | Opciones desde catálogo, lista en línea o relación. |

| multiselect | Selección múltiple | Igual que select pero admite varios valores. |

| relation | Desplegable de registros | Apunta a otro modelo del core (ver sección 4). |

| file | Subida de fichero | Uno o varios adjuntos (Máximo de ficheros). |

| photo | Subida de imagen | Solo imágenes. |

Reglas de validación (pestaña Validación)

Según el tipo: longitud mínima/máxima, valor mínimo/máximo y patrón (expresión regular sin delimitadores, p. ej. ^[0-9]{9}$). La validación es de servidor y bloqueante: si algo no cumple, no se guarda nada de esa pestaña y se muestran los errores.


3. Opciones para select / multiselect

En la pestaña Opciones del campo, tres formas (excluyentes) de poblar las opciones:

  1. Catálogo: elige un catálogo reutilizable (ver sección 6).
  2. Opciones manuales: una por línea, formato valor|etiqueta

(p. ej. S|Pequeña, M|Mediana). Si omites la etiqueta, se usa el valor.

  1. Relación: rellena Modelo de la relación (entonces el tipo suele ser relation).

4. Campos de tipo relation

Un campo relation con Modelo de la relación = Proveedor muestra en la ficha un desplegable con todos los proveedores (por su nombre), y guarda el código del proveedor elegido. Funciona con cualquier modelo del core (Cliente, Agente, Almacén…).

Campo relation a Proveedor en Producto

Ejemplo: en Producto, un campo relation a Proveedor para indicar el "proveedor predeterminado" de cada artículo.


5. Filtrar listados por un campo

Marca el campo como Filtrable en listado. En el listado del target (p. ej. Productos) aparecerá un desplegable de filtro con:

  • (todos) — sin filtro.
  • ✓ \<etiqueta> — registros que tienen valor.
  • ✗ \<etiqueta> — registros sin valor.
  • Para select/multiselect/relation: una opción por cada valor posible

(cada proveedor, cada opción del catálogo…).

El filtro restringe el listado con una subconsulta sobre los valores del plugin.

Filtrar el listado por un campo personalizado


6. Catálogos (opciones reutilizables)

Admin → Campos personalizados → pestaña Catálogos.

Un catálogo es una lista de opciones con nombre que puedes reutilizar en varios campos select/multiselect. Cada opción tiene valor, etiqueta, orden y activo. Edita el catálogo y sus opciones en línea (maestro-detalle).


7. Rellenar los campos en una ficha

Rellenar y guardar un campo en la ficha

  1. Abre una ficha del target (p. ej. un Cliente). Aparece una pestaña por grupo.
  2. Rellena los campos y pulsa Guardar dentro de esa pestaña.
    • Cada pestaña es su propio formulario: tiene su botón de guardado independiente

del de la ficha nativa.

  • Si un campo obligatorio está vacío (o falla una regla), no se guarda esa

pestaña y se muestran los errores conservando lo introducido.

  1. Los valores se recargan al volver a abrir la ficha.

Nota: para campos de tipo fichero/foto, primero guarda la ficha del core (para que el registro tenga código) y luego sube los adjuntos.


8. Borrado en cascada

Al eliminar un registro del core (p. ej. borrar un Cliente), EasyFields elimina automáticamente todos sus valores personalizados y los adjuntos asociados. No quedan datos huérfanos.


9. Administración: las tres pestañas

Admin → Campos personalizados:

  • Campos: alta/edición de definiciones (lo de la sección 2).
  • Catálogos: gestión de catálogos y sus opciones (sección 6).
  • Valores: vista de los valores guardados (auditoría / depuración).

10. Preguntas frecuentes

¿Modifica las tablas del core? No. Todo vive en tablas easyfields_* propias.

¿Qué pasa al desinstalar? Las tablas easyfields_* se conservan por seguridad de datos; el borrado se gestiona aparte con aviso.

Puse una clave con espacios y algo falla. Usa claves sin espacios (identificadores). La etiqueta sí puede tener espacios y acentos; la clave no.

El campo obligatorio no bloquea el guardado de la ficha nativa. Correcto: el core guarda la ficha antes de ejecutar la lógica del plugin. El required bloquea el guardado de su pestaña, no el de la pestaña principal del core.


Amplía tus conocimientos con los cursos oficiales

Curso de Documentos Recurrentes
1 h 30 min
Plugin DocumentosRecurrentes Nuevo

Curso de Documentos Recurrentes

Aprenderás a crear y configurar documentos recurrentes en FacturaScripts, definir sus líneas y periodicidad, generar documentos manual y...

9 lecciones

Curso de creación de plugins
3 h 14 min
Programación

Curso de creación de plugins

Con este curso aprenderás a crear plugins para FacturaScripts: añadir nuevas páginas, listados, formularios, tablas, columnas, generar...

34 lecciones

Curso básico de PHP
2 h 59 min
Programación

Curso básico de PHP

¡Aprende a programar en PHP de manera fácil y divertida con nuestro curso básico! En este curso, te enseñaremos los conceptos...

38 lecciones · 63 alumnos

Patrocinadores

Estas empresas y profesionales apoyan económicamente FacturaScripts y nos ayudan a dedicar más tiempo al desarrollo, las pruebas y la documentación.

ORO
PLATA
BRONCE
PRO
mililitrosdeperfume_lao
mililitrosdeperfume_lao
eduardo_12367
eduardo_12367
miguel.garcia_l25
miguel.garcia_l25
carlos
carlos
daniel89fg
daniel89fg
yopli2000_5
yopli2000_5
adelantia_8n
adelantia_8n
esteban
esteban
davidpujantelopez_mrf
davidpujantelopez_mrf
luis_12743
luis_12743
gestion_kw4
gestion_kw4
mariano_6807
mariano_6807
juancarlos_ptr
juancarlos_ptr
jmoreno_2610
jmoreno_2610
galonso_12031
galonso_12031
antoniommoranrubio_qvj
antoniommoranrubio_qvj
jmboqui_qw3
jmboqui_qw3
miriam_qt0
miriam_qt0
rubaraja_15078
rubaraja_15078
euroviane_qmo
euroviane_qmo
jserrano_qv8
jserrano_qv8
djs2035_pha
djs2035_pha
pedropccribeiro_ppz
pedropccribeiro_ppz
mgila.contabilidad_qw9
mgila.contabilidad_qw9
elimbroda_ohe
elimbroda_ohe
ivancuello_qwj
ivancuello_qwj
urban_qwk
urban_qwk
mariojimenezcruz33_mx3
mariojimenezcruz33_mx3
radiotesla2011.008_qwo
radiotesla2011.008_qwo
rrespaldo430_22233
rrespaldo430_22233
calle.laplata.41_n6s
calle.laplata.41_n6s
marcossanzlatorre_o8v
marcossanzlatorre_o8v
roberto.a.paneque_qx4
roberto.a.paneque_qx4
jurgen_qx2
jurgen_qx2
leivair_qgm
leivair_qgm
victor.exland_7712
victor.exland_7712
bluehservice_18942
bluehservice_18942
jgarrancho_qvi
jgarrancho_qvi
proyecto.ronin49_qxd
proyecto.ronin49_qxd
gesebi_74c
gesebi_74c
supmanagement_qxf
supmanagement_qxf
liliosot_qxq
liliosot_qxq
mariansomesa_qt2
mariansomesa_qt2
andrea.vives_qxe
andrea.vives_qxe
carlosmorenogil_16533
carlosmorenogil_16533
myles_qxy
myles_qxy
jorge849_qy2
jorge849_qy2
compra_q6p
compra_q6p
juanrmoreira371_qw2
juanrmoreira371_qw2
aferinoxidables_oa0
aferinoxidables_oa0
a.useropelaez_qy7
a.useropelaez_qy7
fran.cornide_qyl
fran.cornide_qyl
dwujgnmxwk_qwb
dwujgnmxwk_qwb
clave80detectives_qr6
clave80detectives_qr6
oscarsoler71_k7r
oscarsoler71_k7r
jrodriguezlinar_qyx
jrodriguezlinar_qyx
david_qyz
david_qyz
pescanelasl_qz1
pescanelasl_qz1
vilaboa.angel_qz4
vilaboa.angel_qz4
ferrervicent_89t
ferrervicent_89t
raljopa_851
raljopa_851
eurogaran_nct
eurogaran_nct
hospitalaria_18966
hospitalaria_18966
administracion_qzl
administracion_qzl
it_qzm
it_qzm
ezequieltotoras_4123
ezequieltotoras_4123
hermes6686_oc2
hermes6686_oc2
marcel_qzr
marcel_qzr
rie_17672
rie_17672
maximilianoalameddin_qyp
maximilianoalameddin_qyp
imentsociedadlimitada_qzs
imentsociedadlimitada_qzs
carlos.benitez.hurtado_qzu
carlos.benitez.hurtado_qzu
miquel_qzy
miquel_qzy
danieltorresh2_r01
danieltorresh2_r01
perezvallejoa_qww
perezvallejoa_qww
mbenitezsan_r07
mbenitezsan_r07
alegria_r08
alegria_r08
crismer_r09
crismer_r09
fernandogbj_3fk
fernandogbj_3fk
hola_r0h
hola_r0h
auto-marner_r0g
auto-marner_r0g
it_r0n
it_r0n
salonmanuelafernandez_qgy
salonmanuelafernandez_qgy
tinorubiorollon_r0s
tinorubiorollon_r0s
fegugo1_qs5
fegugo1_qs5
limicompanysrl_qzn
limicompanysrl_qzn
spinardo_qzd
spinardo_qzd
bmg_r11
bmg_r11
raultvmusic_2402
raultvmusic_2402
yeisoncruz01_r13
yeisoncruz01_r13
mis_hierbitas_qvy
mis_hierbitas_qvy
ismasans_r14
ismasans_r14
merabyte_r18
merabyte_r18
cnovas.sanchez_r1b
cnovas.sanchez_r1b
autein_qu9
autein_qu9
paco100416_p0l
paco100416_p0l
r.raul.reinoso_r1m
r.raul.reinoso_r1m
dabos1705_n6y
dabos1705_n6y
davidgf7orellana_qvk
davidgf7orellana_qvk
vyxa.web_r1n
vyxa.web_r1n
radtotalcar_r1p
radtotalcar_r1p
businessgioglobal_qc9
businessgioglobal_qc9
casteret_r1q
casteret_r1q
piratapmc_r23
piratapmc_r23
jekaseo_qbu
jekaseo_qbu
marianomanzanares_19678
marianomanzanares_19678
idee-creatividad_r25
idee-creatividad_r25
fidel.martin_r2b
fidel.martin_r2b
paco_r2c
paco_r2c
crusaiderii_r0p
crusaiderii_r0p
alamas_r2j
alamas_r2j

Si quieres impulsar nuevas mejoras y ayudar a que el proyecto siga creciendo, conviértete en patrocinador y forma parte de quienes lo hacen posible.

Patrocinar

Cookies
Usamos cookies necesarias para el funcionamiento del sitio y cookies opcionales para recordar tus preferencias y mejorar tu experiencia. Puedes aceptarlas todas, rechazarlas o configurar tus preferencias

Soporte