Archivos (Documentos)

El gestor de Documents es el centro de descargas de Chinaski: cualquier archivo que un site ofrece a sus visitantes: PDFs, reportes, archivos ZIP, catálogos : se sube una sola vez, se administra con sus propios metadatos, y el CMS lo entrega con seguimiento. Se encuentra bajo Documents en el área de administración (solo para admins).

Subir archivos

Desde la pantalla Documents → New:

Cualquier tipo de archivo de hasta 50 MB: PDF, ZIP, DOCX, imágenes, archivos comprimidos; se pueden subir varios archivos de una sola vez.
Cada documento lleva un título, slug e idioma, además de una descripción y una carpeta; el slug se convierte en su URL pública de descarga (/documents/<slug>).
Publicación: los documentos son no publicados por defecto; publicarlos (o programar una ventana de publicación) hace viva la descarga. Los documentos no publicados devuelven 404 a los visitantes.
Metadatos capturados por documento: número de páginas, fecha de creación, dimensiones y modo de color (se llenan cuando son extraíbles), campos de autor, tags (con un conjunto opcional de document-tags codificado por colores), y descripciones : notas internas frente a descripciones públicas.

Carpetas y organización

Los documentos pertenecen a carpetas (una faceta de listado por la que filtras), y la vista de listado admite filtros por idioma y por estado (publicado/no publicado), además de búsqueda libre en títulos, slugs y descripciones. Ordenable por nombre, slug, tamaño, fecha de creación o número de descargas. 50 elementos por página.

Reemplazar y duplicar

Replace file: sube una nueva versión en lugar del archivo actual: el slug y la URL pública quedan exactamente como estaban, así que los enlaces incrustados en las páginas construidas siguen funcionando después de una actualización. Los archivos de reemplazo respetan el mismo límite de 50 MB.
Duplicate : crea una copia nueva del título/archivo/metadatos bajo un documento nuevo, para los casos en que un archivo similar necesita su propia URL y su propio ciclo de vida. La duplicación queda auditada.
Cada guardado de un documento (incluido el reemplazo de archivo) genera una instantánea de revisión: el panel de versiones muestra cada guardado.

Entrega y seguimiento

Cuando está publicado, un documento se puede descargar en /documents/<slug>; cada descarga incrementa el contador de descargas del documento (visible en el ordenamiento del listado).
Los documentos se sirven a través del CMS : nunca por el canal estático. Tu reverse proxy o host estático reenvía /documents/<slug> al CMS (los ejemplos de nginx/Caddy que vienen incluidos incluyen esta ruta; sin ella, cada URL de documento devuelve 404 a los visitantes).
El enlace del site estático proviene del tipo de bloque document: pon un bloque document en el cuerpo de una página ({{document:slug}) y el builder incrusta la referencia; reemplaza el archivo más adelante, y el enlace construido sigue funcionando porque el slug nunca cambia.

Mantenimiento

Eliminar mueve un documento a la papelera (Trash): desde ahí se restaura o se destruye permanentemente.
Las operaciones masivas (delete/cambios de estado de publicación) se ejecutan sobre los documentos seleccionados.
Existe una exportación (incluida una variante CSV) y una importación JSON para la lista de documentos.
El editor de bloques tiene un picker de documentos para arrastrar un documento al cuerpo de una página.