Fichiers (Documents)
Le gestionnaire Documents est le centre de téléchargement de Chinaski : tout fichier qu'un site propose aux visiteurs (PDFs, rapports, archives ZIP, catalogues) téléversé une seule fois, géré avec ses propres métadonnées, et délivré par le CMS avec suivi des téléchargements. On le trouve sous Documents dans la zone d'administration (admin uniquement).
Téléverser des fichiers
Depuis l'écran Documents → New :
- N'importe quel type de fichier jusqu'à 50 Mo : PDF, ZIP, DOCX, images, archives ; plusieurs fichiers peuvent être téléversés en une seule fois.
- Chaque document porte un titre, un slug et une langue, plus une description et un dossier ; le slug devient son URL publique de téléchargement (
/documents/<slug>). - Publication : les documents sont par défaut non publiés ; la publication (ou la planification d'une fenêtre de publication) rend le téléchargement en ligne. Les documents non publiés renvoient 404 aux visiteurs.
- Métadonnées capturées par document : nombre de pages, date de création, dimensions et mode colorimétrique (renseignées quand c'est extractible), champs auteur, tags (avec un jeu de tags de documents optionnel et codé par couleur), et descriptions, notes internes versus descriptions publiques.
Dossiers et organisation
Les documents appartiennent à des dossiers (une facette de liste que vous filtrez), et la vue de liste prend en charge des filtres par langue et par statut (publié/non publié) ainsi qu'une recherche libre sur les titres, slugs et descriptions. Tri par nom, slug, taille, date de création ou nombre de téléchargements. 50 éléments par page.
Remplacement et duplication
- Replace file: téléverser une nouvelle version à la place de l'actuelle : le slug et l'URL publique restent exactement tels quels, si bien que les liens intégrés dans les pages générées continuent de fonctionner après une mise à jour. Les fichiers de remplacement sont soumis à la même limite de 50 Mo.
- Duplicate: crée une copie fraîche du titre/fichier/métadonnées sous un nouveau document, pour les cas où un fichier similaire a besoin de sa propre URL et de son propre cycle de vie. La duplication est auditée.
- Chaque enregistrement d'un document (y compris le remplacement du fichier) fait un instantané sous forme de révision : le panneau des versions montre chaque enregistrement.
Délivrance et suivi
- Une fois publié, un document est téléchargeable à
/documents/<slug>; chaque téléchargement incrémente le compteur de téléchargements du document (visible dans le tri de la liste). - Les documents sont servis via le CMS, jamais par le canal statique. Votre reverse proxy ou votre hébergeur statique doit transmettre
/documents/<slug>au CMS (les exemples nginx/Caddy fournis incluent cette route ; sans elle, chaque URL de document renvoie 404 aux visiteurs). - Le lien du site statique provient du type de bloc document : placez un bloc document dans le corps d'une page (
{{document:slug}}) et le builder intègre la référence ; remplacez le fichier plus tard, et le lien généré continue de fonctionner car le slug ne change jamais.
Ménage
- La suppression déplace un document à la Corbeille : restauration ou destruction permanente depuis cet endroit.
- Les opérations en masse (suppression/changement d'état de publication) s'exécutent sur les documents sélectionnés.
- Un export (avec une variante CSV) et un import JSON existent pour la liste des documents.
- L'éditeur de blocs dispose d'un picker de document pour glisser un document dans le corps d'une page.