Actualización plugin Control de Prórrogas de Email, cuaderno técnico

Actualizado el 19/11/2026 para incluir la versión 2.1.0

Valencia, 18/11/2026, G.B.
Actualizo el plugin Control de Prórrogas de Email de la versión 1.4.0 a la 2.1.0. Lo hice en dos pasos: la 2.0.0 trajo importación, campos propios, usuarios gestores y exportación con filtros, y la 2.1.0 añade tres avisos de vencimiento y la gestión completa desde el front end. Lo cuento por partes y con las preguntas que yo mismo me hacía.

¿Qué cambia en la versión 2.0.0?

¿Quién puede gestionar las prórrogas sin ser administrador?

Cualquier usuario que marques en la pestaña dedicada, creada con cpe_render_usuarios(). Tiene un buscador que usa la API de usuarios de WordPress y casillas para elegir a quién das acceso.

  • La función cpe_usuario_autorizado() sigue validando a los administradores (manage_options) y los IDs guardados en la opción cpe_usuarios_permitidos, así que lo que ya tenías configurado sigue valiendo.
  • Los usuarios autorizados pueden ver, crear, editar, eliminar, importar y exportar registros. Los campos personalizados, la lista de usuarios y los ajustes quedan solo para administradores.

¿Se puede importar desde Excel, LibreOffice o CSV?

Sí. El plugin lee ficheros .csv, .xlsx y .ods con código propio, sin librerías externas.

  • Los formatos .xlsx y .ods se leen con ZipArchive y SimpleXML. Si el servidor no tiene ZipArchive, el plugin avisa y solo admite CSV.
  • La importación es un asistente por pasos: subes el fichero, el plugin analiza las columnas, tú asignas cada una a un campo y confirmas. No deja asignar dos columnas al mismo campo.
  • Por defecto omite los duplicados, que son registros con el mismo email y las mismas fechas de prórroga.

¿Se pueden crear campos nuevos desde el panel?

Sí, desde la pestaña Campos, con cpe_render_campos(). Puedes crear campos de texto corto, texto largo, fecha o número, y marcarlos como obligatorios.

  • Cada campo nuevo es una columna real de la tabla, creada con ALTER TABLE sobre una lista blanca de validación y con el prefijo cx_.
  • El campo aparece en el formulario, el listado, los filtros, la importación y la exportación.
  • Borrar un campo borra también sus datos, así que el plugin pide confirmación y solo lo permite a los administradores.

¿Cómo queda el panel de administración?

Organizado en pestañas: Gestión, Importar, Campos, Usuarios autorizados, Ajustes, Instrucciones y Ficha técnica, siguiendo el estándar de Indaga.net. Los usuarios que no son administradores solo ven las pestañas que pueden usar.

¿Cómo se exporta con filtros?

El bloque de exportación, gestionado por cpe_accion_exportar(), genera el fichero con exactamente los filtros que tienes aplicados en pantalla.

  • Se puede filtrar por texto, estado, solicitante, rango de fechas de cualquier campo de fecha y por el contenido de cualquier campo, incluidos los personalizados.
  • Tú eliges qué columnas incluir.
  • El formato puede ser Excel nativo (.xlsx), con panel congelado y autofiltros, o CSV con delimitador ; y BOM UTF-8, para que Excel y LibreOffice Calc respeten tildes y eñes.
  • Los textos que empiezan por símbolos de fórmula se neutralizan al exportar, para evitar la inyección de fórmulas en hojas de cálculo.

¿Qué hay de la seguridad?

Todas las acciones llevan nonces (CSRF) y consultas preparadas con $wpdb->prepare. Las columnas se validan siempre contra una lista blanca y cada dato se sanea según su tipo (sanitize_text_field, sanitize_email, cpe_validar_fecha). Al leer ficheros XML se rechazan las entidades externas.

¿Qué añade la versión 2.1.0?

¿Cómo funcionan los tres avisos de vencimiento?

Cada prórroga recibe tres avisos, uno por semana, cuando faltan 21, 14 y 7 días para su final. El calendario está fijo en una sola función:

function cpe_etapas_aviso() {
	return array( 21, 14, 7 );
}
  • Cada registro lleva un contador de avisos enviados, de 0 a 3, así que ningún aviso se manda dos veces.
  • Si un día no se ejecuta la tarea programada, la siguiente vez se envía el aviso pendiente. Una prórroga dada de alta con menos de tres semanas por delante recibe el aviso que le corresponda y los siguientes en su fecha.
  • Cada día de envío salen dos tipos de email: un resumen para los destinatarios internos que configuras en Ajustes, y un aviso individual a la dirección de correo del propio registro, es decir, a la persona cuya cuenta va a caducar. Este segundo envío se activa con una casilla y admite un mensaje adicional, por ejemplo para explicar cómo pedir una ampliación.
  • Si editas la fecha final de un registro, su ciclo de avisos vuelve a empezar. Los registros con fecha de baja ya pasada no reciben avisos.
  • El botón de prueba envía el resumen solo a los destinatarios internos y no marca ningún aviso como enviado.

La comprobación se hace una vez al día con WP-Cron, que solo se ejecuta cuando alguien visita el sitio. En un sitio con poco tráfico el aviso puede retrasarse unas horas.

¿Se puede editar y eliminar desde el front end?

Sí. Los usuarios autorizados pueden guardar, editar, eliminar y exportar registros desde la página donde hayas puesto el shortcode, sin entrar en el panel de administración:

[control_prorrogas]
[control_prorrogas por_pagina="50"]

Antes los formularios enviaban los datos a wp-admin/admin-post.php, y muchos sitios bloquean wp-admin a quien no es administrador. Ahora esas acciones se procesan en la propia página, con nonce y con la comprobación de cpe_usuario_autorizado().

¿Qué pasa con los datos al actualizar?

La tabla se migra sola al cargar el plugin y añade la columna del contador de avisos. Los registros que ya habían recibido el aviso único de la versión anterior quedan marcados como avisados del todo, para que nadie reciba tres emails de golpe. Aun así, haz una copia de la tabla antes de actualizar.

¿Cómo lo instalo sobre la versión anterior?

Lo más seguro es sustituir el fichero control-prorrogas-email.php dentro de la misma carpeta de wp-content/plugins/ donde ya está instalado. Si subes un ZIP con otra carpeta, WordPress instala una copia aparte, y no hay que activarla mientras la anterior siga activa, porque las dos usan los mismos nombres de funciones.

El plugin está pensado para funcionar con MySQL y MariaDB.

Ficha técnica y descarga (Control de plugins)

Consentimiento y control: así funcionan mis nuevos plugins de cookies para WordPress

Valencia, 13/11/2026, G.B.
Hola de nuevo. Siguiendo con mi compromiso de desarrollar soluciones totalmente nativas, ligeras y adaptadas a nuestras necesidades reales en WordPress, hoy os presento un tándem de plugins diseñado para resolver de principio a fin la gestión y auditoría de cookies: Indaga Cookies (el banner de consentimiento) y Indaga Cookie Scanner (el escáner y listado automático).

Indaga Cookies: consentimiento, bloqueo y registro seguro

El primer pilar de este sistema es el plugin de consentimiento de cookies, concebido bajo la premisa de no depender de servicios externos de pago ni librerías pesadas:

  • Banner y bloqueo automático: Muestra un aviso limpio y bloquea de forma inteligente los scripts de terceros y los iframes (como vídeos de YouTube o mapas) hasta que el usuario acepta la categoría correspondiente.
  • Modo dual flexible: Permite funcionar en modo Completo (gestionando el banner, el bloqueo y el registro) o en modo Solo registro, ideal si prefieres utilizar la interfaz gráfica de otro banner (como Complianz o CookieYes) pero quieres centralizar toda la auditoría legal en tu propia base de datos.
  • Registro íntegro con firma HMAC: Cada decisión del usuario genera un identificador único (UUID) y se almacena en una tabla propia de la base de datos de WordPress, firmada criptográficamente para garantizar su inalterabilidad y permitiendo la exportación segura a CSV con protección anti-fórmulas.Ficha técnica y descarga (control de plugins)

Indaga Cookie Scanner: auditoría transparente en tiempo real

Para cumplir con las exigencias del RGPD y la LSSI, las páginas de política de cookies deben incluir un listado detallado de los elementos que se utilizan en el sitio. En lugar de depender de scripts lentos o bases de datos externas de pago, he desarrollado Indaga Cookie Scanner.

¿Qué diferencia a Indaga Cookie Scanner de soluciones comerciales como Complianz?

Herramientas como Complianz realizan escaneos profundos consultando bases de datos externas teóricas (como cookiedatabase.org), lo que a menudo genera listas sobredimensionadas con decenas de cookies hipotéticas que tu web ni siquiera está utilizando. En cambio, Indaga Cookie Scanner adopta un enfoque mucho más ligero y real:

  • Escaneo real en el navegador (Client-side): El plugin analiza de forma autónoma y en tiempo real únicamente las cookies que físicamente existen y están activas en el navegador del visitante en el momento de la carga.
  • Rendimiento absoluto: Al no realizar peticiones pesadas a APIs externas en el servidor, la velocidad de tu web se mantiene intacta.
  • Hibridación SEO: Utiliza un sistema inteligente que combina un volcado estático de referencia en PHP (asegurando una indexación perfecta para buscadores y accesibilidad) con un reemplazo dinámico mediante sessionStorage que destaca al instante las cookies activas del usuario.

Ampliación y personalización desde el panel de administración

Para asegurar que tu política de cookies sea exhaustiva y cubra tanto los elementos detectados al vuelo como aquellos propios de pasarelas de pago, plugins de analítica o herramientas específicas, el plugin incluye un panel de control dedicado (Cookie Scanner > Catálogo y Ajustes).

Desde ahí puedes ampliar y personalizar fácilmente el catálogo de reconocimiento mediante una sintaxis muy sencilla (patrones exactos o prefijos terminados en guion bajo, categoría y descripción):

indaga_cc_consent,indaga_cookies_consent|consentimiento|Gestión de la preferencia de cookies del usuario.
_wp_session|técnica|Mantiene la sesión de usuario activa en WordPress.
wordpress_logged_in_,wp-settings-|sesión|Identifica al usuario autenticado en el panel de administración.
_ga,_gid,_gat|analítica|Cookies de Google Analytics para medición de tráfico y estadísticas de uso.
_fbp,_gcl_au|marketing|Cookies de seguimiento publicitario y redes sociales.
_pk_id,_pk_ses,matomo_|analítica|Cookies de Matomo para análisis y estadísticas de tráfico web.
_fbp,_fbc|marketing|Cookies de Meta (Facebook) para seguimiento publicitario y conversiones.
__kla_id|marketing|Cookie de Klaviyo para seguimiento de marketing y campañas de email.
IDE,test_cookie|marketing|Cookies de Google DoubleClick y publicidad conductual.
NID,CONSENT|preferencias|Cookies de Google para recordar preferencias de usuario y personalización de anuncios.
wp-wpml_current_language|preferencias|Cookie de WPML para almacenar la preferencia de idioma del sitio._pk_id,_pk_ses,matomo_|analítica|Cookies de Matomo para análisis y estadísticas de tráfico web.
_fbp,_fbc|marketing|Cookies de Meta (Facebook) para seguimiento publicitario.
NID,CONSENT|preferencias|Cookies de Google para recordar preferencias de usuario.

Listado automático mediante Shortcode

Una vez configurado tu catálogo, integrar la tabla en tu página legal es tan sencillo como insertar el siguiente shortcode donde desees que aparezca el listado:

[indaga_lista_cookies]

El shortcode genera automáticamente una tabla perfectamente maquetada, con estilos visuales totalmente coherentes con el resto de mis plugins de cookies, mostrando de forma transparente el nombre, la categoría y la finalidad de cada elemento.

Con este ecosistema nativo, cierro un poco más el círculo de la privacidad en mis desarrollos: control absoluto sobre los datos, cero dependencias externas, cumplimiento normativo estricto y una velocidad de carga inmejorable.

Ficha técnica y descarga (Control de plugins)

Indaga Galerías: un plugin propio de sliders y galerías sin librerías externas

Presento Indaga Galerías 1.0.0, un plugin nativo para mostrar imágenes de la Biblioteca de medios como carrusel o rejilla, con visor y sin dependencias de terceros

Valencia, 11/11/2026, G.B.
Me apetecía poder mostrar sliders y galerías de fotos en el blog sin instalar nada de terceros, así que me he hecho un plugin propio. Se llama Indaga Galerías, va por la versión 1.0.0 y hace justo eso: coge imágenes de la Biblioteca de medios y las muestra como carrusel o como rejilla, con un visor para ampliarlas. Todo en un único fichero PHP y sin librerías externas.

¿Por qué un plugin propio si WordPress ya tiene galerías?

Porque lo que trae el editor se me quedaba corto. Desde WordPress 6.4 el bloque Imagen incluye la opción de ampliar al hacer clic, pero es un visor básico pensado para imágenes sueltas: según WPBeginner, en una galería hay que activarlo imagen por imagen. Y un carrusel, directamente, no lo trae.

Para cubrir ese hueco lo habitual son plugins de terceros con sus librerías, sus hojas de estilo y sus actualizaciones. Yo prefiero lo que ya he hecho con el resto de plugins del sitio: algo pequeño, que controlo yo y que solo carga lo necesario.

¿Cómo se crea un slider o una galería?

Desde el panel Indaga Galerías del menú de administración, en la pestaña Instancias. Una instancia es un conjunto de imágenes con su configuración, y sirve igual para mostrarlo como slider o como galería.

  • Pulsas Añadir instancia y le pones un identificador (por ejemplo capturas) y un nombre.
  • Con Seleccionar imágenes eliges las fotos de la Biblioteca de medios y las ordenas con las flechas de cada miniatura.
  • Ajustas la proporción (16:9, 21:9, 3:2, 4:3 o 1:1), las columnas, el autoplay, las leyendas y el visor.
  • Guardas y copias el shortcode del listado.

El plugin solo guarda los IDs de las imágenes, así que no duplica nada: el texto alternativo y las leyendas salen de la propia Biblioteca de medios.

¿Qué shortcodes y opciones tiene?

Dos shortcodes, uno para el carrusel y otro para la rejilla (nota: pongo dobles corchetes en vez de uno solo para que no se ejecute, ya que ya lo he instalado):

[indaga_slider id="capturas"]
[indaga_galeria id="capturas"]

Y estos atributos opcionales, que sustituyen a lo guardado en la instancia:

  • id: identificador de la instancia. Es obligatorio salvo que uses ids.
  • ids: lista de IDs de imágenes separados por comas, para usarlo sin instancia.
  • leyendas: si o no.
  • lightbox: si o no, para activar o desactivar el visor.
  • autoplay: segundos entre diapositivas, de 0 a 30 (solo slider). Con 0 no avanza solo.
  • columnas: de 1 a 6 (solo galería). En móvil baja a 2 y después a 1.

Por ejemplo, una rejilla de cuatro columnas sin leyendas:

[indaga_galeria id="capturas" columnas="4" leyendas="no"]

¿Se puede usar sin crear una instancia antes?

Sí, con el atributo ids. Es útil para algo rápido, como un par de capturas en una entrada:

[indaga_slider ids="12,15,18"]

El ID de cada imagen aparece en la barra de direcciones cuando la abres en la Biblioteca de medios. En este modo se aplican las opciones por defecto, y si además indicas un id de instancia, usa las opciones de esa instancia pero con tus imágenes.

Un ejemplo

plugin comandos linux
plugin recursos
autores-plugin

¿Carga librerías externas o pesa mucho?

No carga ninguna librería. El carrusel se apoya en CSS scroll-snap y un JavaScript mínimo para las flechas, los puntos y el teclado, y el visor usa el elemento dialog del propio navegador. MDN clasifica el método showModal() como una funcionalidad bien establecida, disponible en los principales navegadores desde marzo de 2022. Si alguno no lo soporta, el clic abre la imagen a tamaño completo y ya está.

El CSS y el JavaScript van embebidos en el plugin y solo se cargan en las páginas que contienen alguno de los shortcodes. Las imágenes usan los tamaños que WordPress ya genera, con srcset y carga diferida, y el visor solo descarga la imagen grande cuando haces clic.

¿Es accesible?

Sí, en lo básico, y es algo que quería cuidar. El autoplay viene desactivado por defecto. Si lo activas aparece un botón de pausa, el avance se detiene al pasar el ratón o al enfocar con el teclado, y no se activa nunca si el sistema del usuario tiene reducido el movimiento. Va en la línea del criterio 2.2.2 de las pautas WCAG del W3C, que pide poder pausar, detener u ocultar el contenido que se mueve o se actualiza solo y se muestra junto a otro contenido (W3C).

Además, el carrusel se maneja con el teclado (flechas, Inicio y Fin), el visor se cierra con Esc y se recorre con las flechas, hay etiquetas ARIA, foco visible y el texto alternativo de cada imagen sale de la Biblioteca de medios.

¿Qué le falta?

Poco de lo vistoso, a propósito. Es una 1.0.0 y la he dejado sencilla: rejilla uniforme, carrusel horizontal y visor. No hay masonry, ni efectos de transición, ni vídeo. Las imágenes se recortan al centro con la proporción elegida para que el conjunto quede uniforme, así que si quieres ver la foto entera conviene escoger la proporción que más se parezca a la original. Y como con el resto de plugins, lo iré ajustando según lo vaya usando.

Como siempre, lo tienes en la página de plugins del blog.

Ficha técnica

  • Fecha: noviembre 2026
  • Nombre: Indaga Galerías
  • Versión: 1.0.0
  • Autor: Guillermo Beltrán Pilato
  • Descripción: Sliders y galerías de imágenes 100% nativos. Instancias gestionadas desde el panel con selector de la Biblioteca de medios, shortcodes indaga_slider e indaga_galeria (también con ids sin crear instancia), visor con dialog nativo, autoplay con pausa y sin dependencias externas.
  • Tags: slider, galeria, lightbox, imagenes
  • Enlace de descarga: pCloud

[Actualización]: Contabilidad Casera Indaga v1.8.0: cero dependencias, máxima privacidad

Valencia, 04/11/2026, G.B.
Llevo algún tiempo dándole vueltas a una idea que tenía clavada como una espina: mi plugin de contabilidad casera seguía cargando Chart.js desde un CDN externo. Y eso, en un proyecto que defiende la privacidad y el control absoluto del rendimiento, no tenía sentido.
Hoy publico la versión 1.8.0 de Contabilidad Casera Indaga, y lo hago con la satisfacción de haber cerrado esa espina. Los tres gráficos del plugin (evolución mensual, gastos por categoría y evolución de pasos) ahora son SVG nativos generados directamente con PHP. Ni una sola librería externa. Ni un script de más. Ni una petición a un CDN que pueda caer o rastrearte.

Qué hay de nuevo en la v1.8.0

  • Adiós a Chart.js, hola al SVG nativo. El plugin ya es 100% autónomo. Si mañana desaparece Internet, tu contabilidad sigue funcionando.
  • Dos pestañas nuevas en el panel de administración: Instrucciones de uso y Ficha técnica, tal como marca mi estándar de desarrollo.
  • Edición inline más segura. He reescrito la forma en que se cargan los datos al pulsar «Editar»: ahora se usan atributos data-* en cada fila, eliminando cualquier riesgo de XSS.
  • Consultas optimizadas. La pestaña de presupuestos, que antes hacía una consulta por cada categoría, ahora resuelve todo con una única GROUP BY. Con 20 categorías, pasas de 20 queries a 1.
  • Índices nuevos en la tabla de contabilidad para que los filtros por fecha, tipo y categoría vuelen.
  • Paginación en el listado de movimientos (20 por página), para que el plugin siga siendo ágil aunque lleves años registrando datos.
  • Autocompletado de categorías con datalist al escribir en el formulario de movimientos.

Lo que no ha cambiado

La cabecera del plugin sigue siendo prácticamente la misma. Los datos de tu base de datos siguen intactos. Las funcionalidades que ya tenías —exportación CSV con UTF-8 y BOM, presupuestos flexibles, edición de pasos, buscador multicriterio— siguen funcionando exactamente igual. Porque actualizar un plugin de Indaga.net nunca significa perder nada de lo que ya tenías.

Si ya lo usabas, actualiza sin miedo. Si no lo conocías, te invito a echarle un vistazo: es ligero, es tuyo, y vive enteramente dentro de tu WordPress.

PD. Ya está esta última versión en Control de plugins.

Menor superficie de ataque y control total: claves de la arquitectura de plugins en un único archivo PHP

Valencia, 03/11/2026, G.B. (una aclaración…).
Fuente: FAQs Puntocomunica

La seguridad en los plugins de WordPress es un pilar fundamental para garantizar la estabilidad, el rendimiento y la integridad de cualquier sitio web. Al tratarse del gestor de contenidos más utilizado del mundo, WordPress es un blanco frecuente para ataques malintencionados. Un plugin vulnerable o desactualizado puede convertirse en la vía de acceso perfecta para que actores maliciosos comprometan la base de datos o ejecuten código de forma remota.Para mitigar estos riesgos de manera drástica, proyectos como Indaga.net aplican una estrategia de desarrollo muy particular que a menudo genera debate en la comunidad técnica: agrupar gran parte de la funcionalidad en un único archivo PHP centralizado, una aproximación que algunos desarrolladores denominan popularmente como la filosofía de los spaghetti plugins.Lejos de ser una decisión tomada al azar, centralizar el código en un único archivo .php responde a razones estratégicas muy meditadas para mantener el control absoluto sobre la seguridad y el mantenimiento:

  • Menor superficie de ataque: Al concentrar la lógica principal en un único archivo controlado, se simplifica enormemente la auditoría de código y la detección rápida de brechas de seguridad, evitando la dispersión de vulnerabilidades a través de múltiples subcarpetas o dependencias externas ocultas.
  • Control de dependencias: Se evita por completo la inclusión de librerías de terceros obsoletas o vulnerables, un problema muy común en plugins complejos que cargan scripts externos sin supervisión directa.
  • Optimización y rendimiento: Reducir la modularidad excesiva disminuye la sobrecarga de peticiones y llamadas innecesarias al  servidor, mejorando de forma notable los tiempos de carga generales.

Como ejemplo práctico de esta estrategia aplicada en Indaga.net, se han desarrollado utilidades internas y específicas para la importación directa de archivos masivos a bases de datos y la optimización de motores de búsqueda que operan de forma autónoma, ligera y segura bajo este esquema compacto.

Guardar datos

 

En conclusión, aunque una arquitectura basada en un único archivo .php pueda chocar con los patrones de modularidad estándar de WordPress, en determinados entornos orientados al rendimiento y al control de riesgos demuestra ser una alternativa sumamente eficaz y segura frente a las vulnerabilidades asociadas a complementos sobrecargados.

Qué es el patrón Singleton y porqué se usa en el plugin CRR

Valencia, 30/10/2026, G.B.
El patrón Singleton garantiza que una clase tenga una única instancia en toda la aplicación y ofrece un punto de acceso global a ella. A raíz de la preparación del cuaderno técnico del plugin Control y Reserva de Recursos (CRR), que publicaré en breve, cuento que, a diferencia de otros desarrollos anteriores como Agenda Indaga, en el CRR no utilizo una clase con patrón Singleton, sino un conjunto de funciones planas con el prefijo crr_ en un único archivo. Vamos a ver qué es este patrón y por qué decidí prescindir de él en este plugin.

Pero, ¿qué es eso del patrón Singleton?

El patrón Singleton (o patrón de instancia única) es un patrón de diseño de software pensado para que una clase tenga una sola instancia y para dar acceso global a ella.

Normalmente, en PHP puedes crear tantos objetos de una clase como quieras con la palabra clave new. El Singleton restringe esto con tres reglas clave:

  1. Constructor privado (private function __construct): impide que cualquier código externo cree nuevos objetos con new MiClase().
  2. Propiedad estática (private static $instance): almacena dentro de la propia clase la única instancia permitida.
  3. Método de acceso público estático (public static function get_instance()): es el único punto de entrada. Si la instancia no existe, la crea; si ya existe, devuelve la que estaba guardada.
class Mi_Plugin_Singleton {
    private static $instance = null;

    // 1. Constructor privado para evitar instanciación externa
    private function __construct() {
        // Inicialización del plugin (ganchos, acciones, etc.)
    }

    // 2. Método global para obtener la única instancia
    public static function get_instance() {
        if ( self::$instance === null ) {
            self::$instance = new self();
        }
        return self::$instance;
    }
}

// Arranque del plugin
Mi_Plugin_Singleton::get_instance();

Por qué se usa habitualmente en WordPress

  • Organización orientada a objetos: permite agrupar la lógica, las propiedades y los métodos del plugin en una estructura limpia y encapsulada
  • Ayuda a evitar duplicidades: reduce el riesgo de que los ganchos de WordPress (add_action, add_filter) se registren más de una vez si la clase se carga en distintos puntos del ciclo de vida
  • Punto de acceso único: cualquier parte del plugin puede obtener el mismo objeto con get_instance(), sin pasarlo de un sitio a otro

Por qué decidí no usarlo en el CRR

En el plugin Control y Reserva de Recursos (CRR) opté por un enfoque más directo: un conjunto de funciones con el prefijo único crr_ dentro de un único archivo. Así se ve el arranque en el código real del plugin:

function crr_instalar() {
    // Creación de las tablas con dbDelta, versión de la base de datos, etc.
}
register_activation_hook( __FILE__, 'crr_instalar' );

function crr_comprobar_actualizacion_db() {
    if ( get_option( 'crr_db_version' ) !== CRR_VERSION ) {
        crr_instalar();
    }
}
add_action( 'plugins_loaded', 'crr_comprobar_actualizacion_db' );
  • Simplicidad y legibilidad: se trata de un sistema autocontenido, centrado en la gestión de recursos y reservas mediante formularios e inventario. Un único archivo de funciones se lee de arriba abajo, sin saltar entre clases, y es fácil de mantener
  • Colisiones de nombres prácticamente eliminadas: al usar el prefijo crr_ en todas las funciones y constantes, el riesgo de choque con WordPress o con otros plugins activos es mínimo. No es una garantía absoluta, pero en la práctica basta

Los inconvenientes del Singleton

Conviene ser honestos: el Singleton tampoco está libre de críticas, y muchos desarrolladores lo consideran un antipatrón. Introduce estado global, dificulta las pruebas automatizadas y aumenta el acoplamiento entre componentes. Que sea habitual en WordPress no significa que sea siempre la mejor opción.

Cuándo sí y cuándo no

  • Singleton (o clases en general): si el plugin crece, tiene estado compartido o se compone de varios componentes que deben colaborar
  • Funciones planas con prefijo: si el plugin es pequeño, autocontenido y no necesita compartir estado entre piezas

Este post es, en sí, un apunte técnico; la primera parte del cuaderno técnico del CRR llegará en breve.

Singleton explicado en Refactoring Guru

Indaga Native Icons 1.2.0: Control de tamaño nativo y más iconos para nuestra biblioteca SVG

Valencia, 29/10/2026, G.B.
En mi intento hacia un desarrollo web completamente independiente y optimizado, los iconos son una pieza fundamental. Tras el lanzamiento inicial de una biblioteca de iconos vectoriales, echaba en falta una característica muy concreta para el día a día en la maquetación: un control de tamaño más versátil y directo sin necesidad de sobrecargar las hojas de estilo con clases auxiliares para cada medida. Con esa idea nace la versión 1.2.0 de Indaga Native Icons. Manteniendo el compromiso de cero dependencias externas y cero peticiones HTTP adicionales, esta nueva actualización introduce mejoras estructurales importantes tanto en el backend como en el motor de renderizado de los SVG.

Qué hay de nuevo en la versión 1.2.0

  • Control de tamaño nativo por atributo: Ahora el shortcode y la función PHP incorporan el parámetro size. Podemos definir tamaños preestablecidos (sm para 16px, md para 24px, lg para 32px y xl para 48px) o pasar directamente valores numéricos en píxeles (por ejemplo, size="32") para un control absoluto del diseño.
  • Ampliación de la biblioteca de iconos: Se han incorporado nuevos iconos clave para interfaces modernas de administración y frontend, abarcando elementos de estado, acciones de edición, seguridad (candados, visibilidad), utilidades de nube y el logotipo oficial de WordPress en SVG puro.
  • Optimización del panel de administración: La cuadrícula visual de la biblioteca en wp-admin se ha actualizado para reflejar de forma más intuitiva las opciones de copia rápida de shortcodes y las nuevas directrices de uso técnico.

Ejemplos prácticos de uso

La flexibilidad que aporta el nuevo atributo size simplifica la inserción de iconos tanto en el editor de bloques como en las plantillas PHP personalizadas de nuestros temas (siempre entre corchetes):


Y si estamos picando código directamente en un template del theme:

<?php echo indaga_icon( 'close', 'indaga-icon-danger', 'Cerrar ventana', '32' ); ?>

Privacidad, rendimiento y control absoluto

Depender de librerías de iconos externas como Font Awesome implica abrir la puerta a peticiones de red hacia servidores de terceros, scripts pesados y posibles problemas de privacidad o rendimiento en la carga inicial. Con Indaga Native Icons, todo el código SVG vive de forma interna, inyectándose de manera limpia y segura.

Seguimos sumando herramientas propias a Indaga.net y para quien las necesite. Hasta pronto!

Ficha técnica del plugin

  • Nombre del Plugin: Indaga Native Icons
  • Versión: 1.2.0 (Con control de tamaño nativo)
  • Autor: Guillermo Beltrán Pilato (Indaga.net)
  • Descripción: Biblioteca ampliada de iconos SVG nativos con control de tamaño dinámico mediante atributos. Diseñada para reemplazar por completo a Font Awesome y soluciones de terceros en WordPress con rendimiento absoluto y control total.
  • Acceso Backend: Menú lateral Iconos Indaga (wp-admin/admin.php?page=indaga-icons).
  • Alias / Shortcodes: (entre corchetes) indaga_icon name="nombre-icono" size="md" (admite parámetros adicionales como size [sm, md, lg, xl o numérico], class y label).
  • Dependencias: 0 (Cero) – Sin CDNs, sin llamadas a servidores externos, sin librerías pesadas.
  • Seguridad: Sanitización completa mediante sanitize_key(), esc_attr() y esc_html(). Bloqueo estricto de accesos directos (ABSPATH) y validación de permisos de usuario (manage_options).

Descargar plugin

Cuaderno Técnico: Plugin «Agenda Indaga» (v1.3.0), parte 3

Entrega 3: Los Shortcodes de Frontend (Formulario y Calendario Interactivo)

Valencia, 25/10/2026, G.B.
En las entregas anteriores vimos cómo levantar los cimientos del plugin en la base de datos y cómo estructurar el panel de administración en el backend. En este tercer bloque me centro en la parte visible para el usuario: los shortcodes que dan vida a la agenda en el frontend de la web.

Para conseguirlo, divido la funcionalidad en dos shortcodes independientes pero complementarios: indaga_agenda (entre corchetes) para gestionar el alta, edición y listado de citas, y calendario_agenda (entre corchetes) para renderizar el calendario mensual interactivo.

1. El Shortcode de Gestión y Formulario (indaga_agenda) (entre corchetes)

Este shortcode permite desplegar un formulario de alta y edición de eventos, acompañado de una tabla con los registros actuales de la instancia. Todo ello protegido mediante comprobaciones de sesión de usuario, validación de nonces y funciones de saneamiento de datos.

public function renderizar_shortcode_agenda( $atts ) {
    global $wpdb;
    $tabla = $wpdb->prefix . 'indaga_agenda';
    $atts = shortcode_atts( array( 'id' => 'default' ), $atts, 'indaga_agenda' );
    $grupo_id = sanitize_text_field( $atts['id'] );
    $user_id = get_current_user_id();
    $mensaje = '';

    // Procesamiento del formulario de guardado / edición
    if ( isset( $_POST['indaga_agenda_frontend_nonce'] ) && wp_verify_nonce( $_POST['indaga_agenda_frontend_nonce'], 'guardar_evento_frontend' ) ) {
        if ( !is_user_logged_in() ) {
            return '<p style="color:red;">Debes iniciar sesión para gestionar la agenda.</p>';
        }

        $evento_id = isset( $_POST['evento_id'] ) ? absint( $_POST['evento_id'] ) : 0;
        $titulo = sanitize_text_field( $_POST['titulo'] );
        $descripcion = sanitize_textarea_field( $_POST['descripcion'] );
        $fecha_inicio = sanitize_text_field( $_POST['fecha_inicio'] );
        $fecha_fin = sanitize_text_field( $_POST['fecha_fin'] );
        $categoria = sanitize_text_field( $_POST['categoria'] );

        if ( !empty( $titulo ) && !empty( $fecha_inicio ) ) {
            $datos = array(
                'user_id' => $user_id,
                'grupo_id' => $grupo_id,
                'titulo' => $titulo,
                'descripcion' => $descripcion,
                'fecha_inicio' => $fecha_inicio,
                'fecha_fin' => !empty( $fecha_fin ) ? $fecha_fin : $fecha_inicio,
                'categoria' => $categoria
            );

            if ( $evento_id > 0 ) {
                $wpdb->update( $tabla, $datos, array( 'id' => $evento_id ), array( '%d', '%s', '%s', '%s', '%s', '%s', '%s' ), array( '%d' ) );
                $mensaje = '<div style="background:#d4edda; color:#155724; padding:10px; margin-bottom:15px; border-radius:4px;">¡Evento actualizado con éxito!</div>';
            } else {
                $wpdb->insert( $tabla, $datos, array( '%d', '%s', '%s', '%s', '%s', '%s', '%s' ) );
                $mensaje = '<div style="background:#d4edda; color:#155724; padding:10px; margin-bottom:15px; border-radius:4px;">¡Evento creado con éxito!</div>';
            }
        }
    }
    // ... (código de renderizado de la vista y formulario)
}

Puntos clave del formulario:

  • Soporte multinstancia por atributo: A través del parámetro id="nombre_instancia" (por defecto default), delimito los registros que pertenecen a esa agenda concreta.
  • Doble funcionalidad (Alta / Edición): Si el sistema detecta un parámetro editar_id en la URL, carga automáticamente los datos del evento en los inputs para modificarlos sin duplicar registros.

2. El calendario interactivo (calendario_agenda) (entre corchetes)

Para mostrar los eventos en una vista de calendario mensual limpia y visual, transformo los registros de la base de datos a un array de JavaScript y construyo una cuadrícula dinámica.

public function renderizar_shortcode_calendario( $atts ) {
    global $wpdb;
    $tabla = $wpdb->prefix . 'indaga_agenda';
    $atts = shortcode_atts( array( 'id' => 'default' ), $atts, 'calendario_agenda' );
    $grupo_id = sanitize_text_field( $atts['id'] );

    $eventos = $wpdb->get_results( $wpdb->prepare( "SELECT * FROM $tabla WHERE grupo_id = %s ORDER BY fecha_inicio ASC", $grupo_id ) );
    
    $eventos_js = array();
    foreach ( $eventos as $ev ) {
        $eventos_js[] = array(
            'id' => $ev->id,
            'titulo' => $ev->titulo,
            'descripcion' => $ev->descripcion,
            'categoria' => $ev->categoria,
            'fecha_inicio' => $ev->fecha_inicio,
            'fecha_fin' => $ev->fecha_fin
        );
    }
    // ... (retorno del HTML y script de renderizado)
}

Características del motor visual en JavaScript:

  • Navegación fluida por meses: Botones de avance y retroceso (cambiarMes()) que recalculan los días de la semana y sitúan correctamente el primer día del mes.
  • Fichas modales emergentes: Al hacer clic sobre cualquier evento listado dentro de una casilla del calendario, se despliega una ventana flotante con los detalles completos (horarios, categoría y descripción).
  • Conexión directa con el alta: El botón superior «+ Añadir Evento» o hacer clic directamente sobre cualquier día del calendario desplaza la vista automáticamente hacia el formulario y precarga la fecha seleccionada.

Con esta tercera entrega queda completamente documentada la arquitectura del plugin Agenda Indaga (v1.3.0): desde los cimientos en la base de datos, pasando por el panel de administración multinstancia, hasta la interacción visual en el frontend.

Cuaderno Técnico: Plugin «Agenda Indaga» (v1.3.0), parte 2

Entrega 2: El Panel de Administración y la Gestión Multinstancia

En la primera entrega vimos los cimientos del plugin: la estructura principal con la clase IndagaAgenda, la seguridad inicial para bloquear accesos directos y la creación nativa de la tabla en la base de datos.

En este segundo bloque me centro en cómo está construido el panel de administración en el backend de WordPress (ubicado en Ajustes > Agenda Indaga), explicando el menú nativo, la estructura modular por pestañas y el control de las distintas instancias o grupos de eventos.

1. Registro del menú en el panel de administración

Para integrar la interfaz dentro del escritorio de WordPress sin cargar librerías adicionales, utilizo la API nativa de menús a través del gancho admin_menu:

public function registrar_menu_admin() {
    add_menu_page(
        'Agenda Indaga',              // Título de la página
        'Agenda Indaga',              // Título del menú
        'manage_options',             // Capacidad / Permiso requerido
        'indaga-agenda',              // Slug único del menú
        array( $this, 'renderizar_panel_admin' ), // Función de callback
        'dashicons-calendar-alt',     // Icono nativo de Dashicons
        6                             // Posición en la barra lateral
    );
}

Puntos clave:

  • manage_options: Garantizo que solo las cuentas con perfil de administración puedan acceder a este panel de control.
  • dashicons-calendar-alt: Aprovecho la librería de iconos nativa de WordPress (Dashicons), manteniendo el plugin sin dependencias externas.

2. Estructura modular por pestañas

Para que la experiencia de uso sea limpia e intuitiva, organizo el panel de administración en tres pestañas bien diferenciadas usando la navegación nativa de WordPress (nav-tab-wrapper):

  1. Gestión e Instancias: Control global de los eventos y de las instancias creadas.
  2. Instrucciones y Shortcodes: Guía rápida para saber cómo insertar los shortcodes.
  3. Ficha Técnica: Resumen de especificaciones del desarrollo.

El cambio entre pestañas se gestiona capturando el parámetro tab mediante la URL (p. ej., ?page=indaga-agenda&tab=instrucciones), sanitizándolo adecuadamente:

$tab = isset( $_GET['tab'] ) ? sanitize_text_field( $_GET['tab'] ) : 'gestion';
?>
<h2 class="nav-tab-wrapper">
    <a href="?page=indaga-agenda&tab=gestion" class="nav-tab <?php echo $tab === 'gestion' ? 'nav-tab-active' : ''; ?>">Gestión e Instancias</a>
    <a href="?page=indaga-agenda&tab=instrucciones" class="nav-tab <?php echo $tab === 'instrucciones' ? 'nav-tab-active' : ''; ?>">Instrucciones y Shortcodes</a>
    <a href="?page=indaga-agenda&tab=tecnica" class="nav-tab <?php echo $tab === 'tecnica' ? 'nav-tab-active' : ''; ?>">Ficha Técnica</a>
</h2>

3. Procesamiento seguro de acciones (eliminación con nonces)

Antes de pintar la vista o consultar los datos, verifico si se ha enviado alguna petición desde los formularios de administración (por ejemplo, para eliminar un evento suelto o una instancia completa).

La seguridad aquí descansa en dos pilares: comprobación de permisos y validación de Nonce para evitar ataques CSRF:

if ( isset( $_POST['indaga_agenda_nonce'] ) && wp_verify_nonce( $_POST['indaga_agenda_nonce'], 'indaga_agenda_admin_action' ) ) {
    
    // Eliminación de un evento individual
    if ( isset( $_POST['accion'] ) && $_POST['accion'] === 'eliminar_evento' && !empty( $_POST['evento_id'] ) ) {
        $evento_id = absint( $_POST['evento_id'] );
        $wpdb->delete( $tabla, array( 'id' => $evento_id ), array( '%d' ) );
        $mensaje = '<div class="updated notice"><p>Evento eliminado correctamente.</p></div>';
    
    // Eliminación de una instancia completa (y todos sus eventos asociados)
    } elseif ( isset( $_POST['accion'] ) && $_POST['accion'] === 'eliminar_instancia' && !empty( $_POST['grupo_id'] ) ) {
        $grupo_id = sanitize_text_field( $_POST['grupo_id'] );
        $wpdb->delete( $tabla, array( 'grupo_id' => $grupo_id ), array( '%s' ) );
        $mensaje = '<div class="updated notice"><p>Instancia completa y todos sus eventos asociados eliminados correctamente.</p></div>';
    }
}
  • wp_verify_nonce(): Garantiza que la petición se ha originado legítimamente dentro del panel y por un usuario autorizado.
  • absint() y sanitize_text_field(): Aseguran que los datos recibidos sean enteros positivos o cadenas limpias sin código malicioso.

4. Consulta agrupada para la gestión multinstancia

El valor diferencial de la versión 1.3.0 es el soporte multinstancia. Mediante una consulta SQL optimizada con agrupamiento (GROUP BY), obtengo la lista de todas las agendas o grupos existentes en la base de datos sin necesidad de tablas auxiliares:

$instancias = $wpdb->get_results( 
    "SELECT grupo_id, COUNT(*) as total_eventos, MIN(fecha_inicio) as primer_evento 
     FROM $tabla 
     GROUP BY grupo_id 
     ORDER BY grupo_id ASC" 
);

Con esto puedo renderizar una tabla clara que indica el nombre del grupo, cuántos eventos almacena y qué shortcode exacto debe copiarse para mostrar esa agenda concreta en el frontend:

<?php foreach ( $instancias as $inst ): ?>
    <tr>
        <td><strong><?php echo esc_html( $inst->grupo_id ); ?></strong></td>
        <td><?php echo esc_html( $inst->total_eventos ); ?> evento(s)</td>
        <td><code>

Acceso restringido: necesitas permisos de administrador para gestionar esta agenda. Iniciar sesión

</code></td> <td><code>

</code></td> <td> <form method="POST" style="display:inline;" onsubmit="return confirm('¿Estás seguro de eliminar esta instancia completa y todos sus eventos?');"> <?php wp_nonce_field( 'indaga_agenda_admin_action', 'indaga_agenda_nonce' ); ?> <input type="hidden" name="accion" value="eliminar_instancia"> <input type="hidden" name="grupo_id" value="<?php echo esc_attr( $inst->grupo_id ); ?>"> <button type="submit" class="button button-small button-link-delete">Eliminar Instancia</button> </form> </td> </tr> <?php endforeach; ?>

Con esto queda cubierto todo el funcionamiento del panel de administración y el control multinstancia desde el backend.

En la siguiente entrega abordaremos la tercera parte del cuaderno técnico: los Shortcodes de Frontend (indaga_agenda y calendario_agenda) (entre corchetes), analizando el formulario de alta de eventos y el calendario mensual interactivo programado en JavaScript nativo.

Hasta pronto!

Plugin Resúmenes Indaga

Ya lo explicaré. aquí va el shortcode. Las  cinco últimas entradas publicadas en Indaga.net.

Últimas entradas