Je recopie les différentes descriptions que j'ai pu donner ici:

Syntaxe¶

{% zip expression_nom_du_fichier_zip [chemin=expression_fichier_contenu]* %}

• expression_nom_du_fichier_zip doit être une expression renvoyant une chaîne de caractère indiquant le nom du fichier .zip voulu
• expression_fichier_contenu doit être une expression rendant une valeur de type fichier (champ fichier) ou une liste de fichiers (champ fichier d'un bloc, ex. avec un champ "file" dans un bloc "bloc1" form_var_bloc1|getlist:"file")
• chemin est un chemin de répertoire pouvant se terminer par le nom d'un fichier, ex. "piece-jointe/piece.pdf"
• en cas de liste de fichier le chemin est utilisé comme motif pour les noms des fichiers finaux auquel est suffixé le numéro du fichier dans la liste en partant de 1, si chemin est "piece.pdf" les fichiers s'appelleront "piece-1.pd", "piece-2.pdf", etc...
• si chemin ne contient pas de nom de fichier (i.e il est vide =form_var_fichier ou se termine par un /, repertoire/=form_var_fichier) alors le nom d'origine du fichier (ou des fichiers dans une liste) est (sont) conservé(s).
• l'extension du nom de fichier est adapté au type réel du fichier passé, si le fichier s'appelle piece.pdf mais que le contenu est du type JPEG, alors le fichier final s'appellera piece.jpg
• l'utilisation en commun avec le filtre rename_file permet d'utiliser des noms dynamiques pour les fichiers

Exemples¶

• {% zip "archive.zip" demande.pdf=form_var_export_demande piece-jointes/piece.pdf=form_var_bloc|getlist:"fichier" %}
  

  • créera un fichier zip nommé "archive.zip" contenant un fichier "demande.pdf" à sa racine et des fichiers "piece-1.pdf" (puis -2, -3, etc...) dans un sous-répertoire piece-jointes

• {% zip form_var_archive_name =form_var_export_demande|rename_file:form_var_export_demande_name %}

  • si form_var_export_demande_name est pré-rempli avec le gabarit "DEMANDE-{{ form_user_display_name|slugify|upper }}.pdf" et form_var_archive_name avec "DEMANDE-{{ form_number }}.pdf"
  • donnera un fichier .zip nommé "DEMANDE-7-1234.zip" contenant le fichier DEMANDE-JOHN-DOE.pdf