aGo Files, documentación

Versión del plugin: 1.0.0 · Documentación actualizada: 2026-06-28

aGo Files organiza la biblioteca de medios de WordPress en carpetas virtuales. Los archivos no se mueven de su ubicación en el disco: el plugin solo agrega una taxonomía propia para que puedas filtrar, mover y asignar adjuntos por carpeta desde la pantalla de Medios. Es una alternativa ligera a HappyFiles y FileBird.

1. Instalación y activación

1. Sube la carpeta ago-files a /wp-content/plugins/, o instálala desde Plugins → Añadir nuevo plugin → Subir plugin con el archivo ago-files.zip.
2. Actívalo desde el menú Plugins.
3. Abre la Biblioteca de medios. La barra lateral de carpetas aparece a la izquierda.

Al activar, el plugin registra la taxonomía de carpetas y guarda los ajustes por defecto (barra lateral y columna de carpeta activadas). No requiere configuración previa para empezar a usarse.

2. Cómo funcionan las carpetas

Las carpetas son virtuales: se guardan como términos de una taxonomía propia (agofiles_media_folder) y un adjunto se relaciona con una carpeta sin cambiar de sitio en el servidor.

• Los archivos en disco no se mueven. Las URLs existentes siguen funcionando igual.
• Las carpetas son jerárquicas: puedes anidar subcarpetas dentro de otra.
• Un archivo sin carpeta asignada aparece en el filtro Sin clasificar.

3. Barra lateral de carpetas en la biblioteca

En la pantalla de medios (vista de lista y vista de cuadrícula) se muestra una barra lateral con el árbol de carpetas. Desde ahí:

• Ves Todos los archivos, Sin clasificar y cada carpeta con su número de elementos.
• Al hacer clic en una carpeta, la vista de medios se filtra para mostrar solo sus archivos.
• Creas, renombras y eliminas carpetas sin salir de la biblioteca.

La barra lateral también está disponible en el selector de adjuntos (el modal que abre WordPress al insertar imágenes en una entrada o página), de modo que puedes filtrar por carpeta al elegir un archivo.

4. Arrastrar y soltar

Para clasificar un archivo, arrástralo desde la cuadrícula o la lista y suéltalo sobre una carpeta de la barra lateral. El adjunto queda asignado a esa carpeta. Es la vía más rápida para ordenar la biblioteca pieza por pieza.

5. Selección múltiple y movimiento masivo

Cuando seleccionas varios archivos en la vista de lista, aparece la acción Mover seleccionados a… junto a las acciones en lote de WordPress. Eliges la carpeta de destino y todos los adjuntos seleccionados se mueven de una vez.

El plugin distingue dos operaciones internas:

• Asignar: añade los archivos a una carpeta sin quitarlos de otras a las que ya pertenezcan.
• Mover: reemplaza la carpeta del archivo, de modo que queda solo en el destino.

6. Menú contextual (clic derecho)

Al hacer clic derecho sobre una carpeta de la barra lateral se abre un menú con las acciones de gestión:

• Renombrar la carpeta.
• Eliminar la carpeta. Los archivos no se borran: vuelven a quedar sin clasificar.
• Crear subcarpeta dentro de la carpeta seleccionada, con edición en línea del nombre.

7. Filtrar por carpeta

La biblioteca se filtra por carpeta en ambas vistas:

• Vista de lista (upload.php): el filtro se aplica a la consulta principal de la pantalla.
• Vista de cuadrícula: el filtro se aplica a la carga de medios por AJAX.

El filtro Sin clasificar muestra los adjuntos que no están en ninguna carpeta, útil para revisar lo que falta por ordenar.

8. Columna de carpeta en la vista de lista

En la vista de lista de medios, una columna muestra la carpeta de cada archivo. Puedes desactivarla desde los ajustes si prefieres una pantalla más limpia.

9. Página de ajustes y gestión de carpetas

En aGo Tools → Files encuentras dos áreas:

Ajustes. Dos interruptores que se guardan al instante:

• Mostrar barra lateral de carpetas: muestra u oculta la barra lateral en la biblioteca de medios.
• Mostrar columna de carpeta: muestra u oculta la columna de carpeta en la vista de lista.

Gestión de carpetas. Un panel para crear una carpeta nueva (con opción de carpeta padre) y un árbol completo donde renombras y eliminas las carpetas existentes. Es la misma gestión disponible desde la barra lateral, reunida en una sola pantalla.

10. REST API

Todas las operaciones de carpetas pasan por una REST API propia bajo el espacio ago-files/v1: listar el árbol de carpetas, crear, renombrar y eliminar carpetas, asignar o mover adjuntos, consultar conteos y leer o guardar los ajustes.

Los permisos están acotados: las operaciones sobre carpetas y adjuntos requieren la capacidad de subir archivos, y los ajustes requieren la capacidad de gestionar opciones. Si integras flujos propios, esta API es el punto de entrada.

11. Rendimiento

La consulta de la taxonomía está indexada. El plugin se ha probado con bibliotecas de más de 10.000 adjuntos sin retraso perceptible en la pantalla de medios.

12. Privacidad y datos

• El plugin no se conecta a ningún servicio externo. Los enlaces de donación y el enlace a aGo Lab de la página de administración apuntan a PayPal y a ago.cl, y solo se abren cuando haces clic.
• Guarda una taxonomía propia (agofiles_media_folder) para agrupar los adjuntos y una opción (agofiles_settings) con las preferencias de la barra lateral.
• No envía datos a terceros.

13. Desinstalación

Al desinstalar el plugin desde la pantalla de Plugins, se eliminan todos los términos de carpeta y la opción de ajustes. Los archivos de la biblioteca de medios no se tocan: solo desaparece la organización por carpetas.

14. Compatibilidad con FileBird y HappyFiles

aGo Files usa una taxonomía distinta a la de FileBird o HappyFiles, así que no importa los datos de esos plugins. Puedes tenerlos instalados a la vez, aunque lo habitual es elegir uno.

15. Soporte

aGo Files es un plugin gratuito de código abierto bajo licencia GPL-2.0+.

Cuando publiquemos este plugin en WordPress.org, las dudas y reportes de bugs se atenderán en su foro oficial (https://wordpress.org/support/plugin/ago-files/). El plugin es de código abierto bajo licencia GPL-2.0+ y se atiende según disponibilidad.

No damos soporte por correo electrónico para la versión gratuita. Para uso comercial con soporte directo y SLA, próximamente lanzaremos planes de suscripción anual y lifetime.