He desarrollado el plugin Indaga Directorio de Personal (versión 1.2.6) porque me falló el plugin Name Directory y quise ampliar las funcionalidades de mi plugin Import to Excel. Mi objetivo ha sido contar con una herramienta propia, estable y totalmente integrada en WordPress para gestionar directorios de personal con campos estructurados, importación y exportación CSV y búsqueda rápida sin depender de plugins de terceros.
Por qué creé este plugin
Al fallarme Name Directory y buscar ampliar las capacidades de Import to Excel, decidí construir una solución nativa bajo el patrón Singleton (Indaga_Directorio_Personal::get_instance()) que separara los datos de cada persona en campos limpios en base de datos, manteniendo al mismo tiempo compatibilidad con el formato CSV heredado para poder migrar y trabajar sin fricciones.
Principales funciones de la versión 1.2.6
- Gestión estructurada en administración: alta, edición y borrado de fichas con campos independientes (
name,role_title,department,extension,email,profile_url,photo_url, tamaño y dimensiones de imagen,statusysubmitter), conservandoraw_descriptionpor retrocompatibilidad. - Acciones en lote y paginación: selección masiva (
publish,draft,delete) protegida con nonce y paginación de 50 registros por página en el listado administrativo. - Conservación temporal de formularios: uso de transients (
indaga_dp_form_{user_id}durante 10 minutos) para no perder los datos introducidos ante errores de validación o nombres duplicados. - Importación y exportación CSV: detección automática de delimitador (
,o;), limpieza de BOM UTF-8, conversión a UTF-8 cuando corresponde, validación de extensión (.csvo.txt), normalización de dimensiones de imagen y exportación en formato estructurado o compatible con Name Directory. - Shortcodes y filtrado en cliente: shortcodes
[indaga_directorio_personal]y[name_directory]con soporte multi-instancia, índice alfabético (#yA–Z), búsqueda sin tildes y filtros combinados por departamento y categoría o cargo.
Ficha técnica
- Versión mínima de WordPress: 5.8 o superior
- Versión mínima de PHP: 7.4 o superior
- Arquitectura: Patrón Singleton (
Indaga_Directorio_Personal::get_instance()) - Dependencias de otros plugins: Ninguna (100 % autónomo)
- Dependencias externas (CDNs / APIs): Ninguna (0 dependencias externas; sin peticiones a servicios de terceros como cdnjs o Google Fonts)
- Compatibilidad con caché / proxy: Compatible con proxy inverso y plugins de caché (p. ej., WP Fastest Cache), con filtrado en cliente sin recarga
- Tabla personalizada:
{prefijo}indaga_directorio_personal, gestionada mediantedbDelta()enactivate()ymaybe_upgrade_schema(), con los camposid,name,profile_url,photo_url,photo_size,photo_width,photo_height,role_title,department,extension,email,raw_description,submitter,status,created_atyupdated_at - Opciones y datos temporales (
wp_options):indaga_dp_db_version,indaga_dp_hidden_categories(autoload = false) yindaga_dp_form_{user_id}(transient de 10 minutos) - Rutas y recursos estáticos: carga condicional de
admin.css,admin.js,frontend.cssyfrontend.jsúnicamente en las pantallas de administración del plugin o páginas con el shortcode activo - Funcionalidad principal e integración: gestión integral del directorio de personal con alta/edición, gestión de categorías/cargos, importación/exportación CSV y visualización filtrable mediante los shortcodes
[indaga_directorio_personal]y[name_directory]
Seguridad y retrocompatibilidad
Todo el código utiliza exclusivamente las APIs oficiales de WordPress ($wpdb con consultas preparadas y esc_like(), admin-post.php, Options API, Transients API y wp_enqueue_*), comprobando capacidades (manage_options), validando nonces frente a CSRF, sanitizando entradas y escapando salidas. Las novedades se añaden de forma acumulativa manteniendo la retrocompatibilidad con Name Directory.
