Centro de Medios

Descripción general

Centro de Medios reemplaza la Biblioteca de Medios predeterminada de WordPress con una interfaz completa de gestión de archivos. Añade carpetas jerárquicas, etiquetas con código de colores, edición de imágenes, compresión con conversión de formato (WebP, AVIF) e integración con backups. Toda la interfaz está construida con JavaScript puro y se comunica con el backend a través de una API REST.

Una vez que el servicio está habilitado, el menú Medios predeterminado en el administrador de WordPress se reemplaza con la interfaz del Centro de Medios. No se requiere configuración adicional.

Organización

El Centro de Medios ofrece cuatro formas de explorar y filtrar tus archivos, accesibles desde la barra lateral en el lado izquierdo de la pantalla.

Carpetas

Las carpetas crean una estructura jerárquica para tus archivos multimedia, similar a un sistema de archivos. Cada carpeta puede tener un color asignado para su identificación visual.

• Hasta tres niveles de anidamiento (raíz, subcarpeta, sub-subcarpeta).
• Cada archivo pertenece como máximo a una carpeta. Los archivos no asignados a ninguna carpeta aparecen en el grupo Sin categoría.
• Las carpetas muestran el número de archivos que contienen.
• Haz clic derecho en una carpeta para renombrarla, cambiar su color, crear una subcarpeta, moverla o eliminarla.

Etiquetas

Las etiquetas proporcionan una capa de clasificación plana y transversal. A diferencia de las carpetas, un solo archivo puede tener múltiples etiquetas, y las etiquetas no se anidan.

• Cada etiqueta tiene un nombre y un color opcional.
• Los archivos sin ninguna etiqueta aparecen en el grupo Sin etiquetas.
• Las etiquetas se gestionan desde la pestaña Etiquetas en la barra lateral o desde el modal de detalles del archivo.

Fechas

La pestaña Fechas agrupa los archivos por año y mes de subida. Esta vista es de solo lectura y se genera automáticamente a partir de las marcas de tiempo de subida almacenadas por WordPress.

Tipos

La pestaña Tipos agrupa los archivos por tipo MIME en categorías: Imágenes, Vídeos, Audio, PDFs, Hojas de cálculo, Documentos Word, Presentaciones, Archivos de texto y Otros.

Explorador de archivos

El área principal de la pantalla muestra tus archivos en vista de cuadrícula o de lista, alternando desde la barra de herramientas.

• Vista de cuadrícula: tarjetas con miniatura, título del archivo e icono de tipo.
• Vista de lista: una tabla con columnas para nombre, tipo, tamaño, fecha y autor.
• Búsqueda: filtra archivos por título y nombre de archivo.
• Ordenar: por fecha, nombre o tamaño de archivo, en orden ascendente o descendente.
• Paginación: elementos por página configurables (predeterminado 40, máximo 100) con un botón Cargar más.

Subir archivos

Arrastra y suelta archivos en cualquier parte del explorador, o haz clic en el botón Subir de la barra de herramientas. Los archivos se validan contra el tamaño máximo de subida y los tipos MIME permitidos configurados en WordPress. Si hay una carpeta seleccionada, los archivos subidos se asignan automáticamente a esa carpeta.

Selección múltiple y acciones masivas

Mantén Ctrl (o Cmd en Mac) y haz clic para seleccionar archivos individuales. Mantén Shift y haz clic para seleccionar un rango. Una vez seleccionados varios archivos, las acciones masivas disponibles incluyen eliminar, descargar como archivo ZIP, mover a una carpeta y añadir etiquetas.

Modal de detalles del archivo

Haz clic en cualquier archivo para abrir el modal de detalles. El modal se organiza en pestañas que varían según el tipo de archivo.

Información

Muestra una vista previa del archivo (o un icono de tipo para archivos que no son imágenes) junto con los metadatos: nombre de archivo, tipo MIME, tamaño, dimensiones (para imágenes), fecha de subida, autor y a qué entrada está adjunto, si corresponde. Debajo de los metadatos puedes editar el título, texto alternativo, leyenda y descripción. La URL del archivo se muestra con un botón de copiar. También puedes asignar una carpeta y gestionar etiquetas desde esta pestaña.

Miniaturas (solo imágenes)

Lista todos los tamaños de miniaturas que WordPress ha generado para la imagen. Cada entrada muestra el nombre del tamaño, las dimensiones y el peso del archivo. Puedes copiar la URL directa de cualquier miniatura o descargarla individualmente.

Editar (solo imágenes)

Un editor de imágenes basado en canvas con cuatro conjuntos de herramientas:

• Recortar: forma libre o proporciones predefinidas (1:1, 4:3, 16:9 y más).
• Ajustes: controles deslizantes para brillo, contraste, exposición, luces, sombras, saturación e intensidad.
• Filtros: preajustes como sepia, escala de grises, rotación de tono, desenfoque y nitidez, cada uno con un control de intensidad.
• Voltear y Rotar: volteo horizontal, volteo vertical y rotación de 90 grados.

Las ediciones se aplican en el servidor al guardar. Las miniaturas de WordPress se regeneran automáticamente después de una edición.

Compresión (solo imágenes)

Permite reducir el tamaño del archivo y, opcionalmente, convertir la imagen a un formato diferente.

• Control de calidad: de 1 a 100.
• Formato: mantener el formato original, convertir a WebP o convertir a AVIF (cuando el servidor lo soporte).
• Eliminación de metadatos: opcionalmente elimina los datos EXIF del archivo.
• Vista previa: antes de aplicar, puedes previsualizar el resultado comprimido con el ahorro estimado.

Las capacidades del servidor (soporte para WebP y AVIF) se detectan automáticamente y los formatos no disponibles se ocultan.

Backup (imágenes, cuando el servicio de Backup está habilitado)

Lista las versiones anteriores del archivo almacenadas por el servicio de Backup de RakuWP. Cada versión muestra su fecha y origen. Puedes previsualizar cualquier versión y restaurarla con un solo clic. Al restaurar un archivo se regeneran todas las miniaturas.

Menús contextuales

Al hacer clic derecho sobre carpetas, etiquetas y tarjetas de archivos se abre un menú contextual con las acciones correspondientes:

• Carpeta: renombrar, cambiar color, crear subcarpeta, mover, eliminar.
• Etiqueta: renombrar, cambiar color, eliminar.
• Archivo: previsualizar, editar detalles, duplicar, eliminar, copiar URL.

API REST

Todas las operaciones se realizan a través de la API REST bajo el espacio de nombres rakuwp/v1/media-center/. Los endpoints utilizan autenticación por nonce de WordPress. Las acciones administrativas (crear carpetas/etiquetas, eliminar archivos, regenerar miniaturas) requieren la capacidad manage_options. Las operaciones de subida y exploración requieren la capacidad upload_files.

Endpoints principales

GET /folders — Árbol de carpetas con conteo de archivos.
POST /folders — Crear una carpeta.
GET /tags — Todas las etiquetas con conteo de archivos.
POST /tags — Crear una etiqueta.
GET /files — Listar archivos con filtros, búsqueda y paginación.
POST /files — Subir un archivo.
PUT /files/{id} — Actualizar metadatos del archivo.
DELETE /files/{id} — Eliminar un archivo.
POST /files/{id}/edit — Aplicar ediciones de imagen.
POST /files/{id}/compress — Comprimir o convertir una imagen.
GET /files/{id}/backup-versions — Historial de versiones de backup.
POST /files/{id}/backup-restore — Restaurar desde respaldo.

Base de datos

El Centro de Medios crea tres tablas personalizadas en la base de datos de WordPress:

• rakuwp_media_folders: almacena la jerarquía de carpetas (id, parent_id, name, color, sort_order).
• rakuwp_media_tags: almacena las etiquetas (id, name, color, sort_order).
• rakuwp_media_file_tags: tabla de relación que vincula adjuntos con etiquetas (attachment_id, tag_id).

La asignación de carpeta se almacena como post meta de WordPress (_rakuwp_folder_id) en cada adjunto. El versionado del esquema se rastrea en la opción rakuwp_mediacenter_db_version.