JoomlaDay FR
➠ file : Force le téléchargement d'un fichier DEMO
Propose un lien sur un fichier.
Le fichier peut etre affiché (si prise en charge par navigateur client)
ou le téléchargement peut-etre forcé avec changement de nom optionnel
Une icône représentative est affichée devant le lien
syntaxe {up file=nomfichier.ext | download | icon |target }
texte du lien
{/up file}
author LOMART date 2017-12-04 version 1.0 license GNU/GPLv3
  • file: chemin et nom du fichier à télécharger
  • download: vide ou nom du fichier récupéré par le client
  • icon=32: chemin et nom de l'icone devant le lien ou taille de l'icone selon extension du fichier (16 ou 32)
  • target: argument ou _blank si option sans argument
  • rel: nofollow, noreferrer, ...
  • class: classe(s) pour la balise a
  • style: style inline pour la balise a

    A l'origine, cette action a été créée pour proposer une solution simple pour forcer le téléchargement d'un fichier PDF.

    Télécharger l'aide mémoire programmation de UP

    Si vous cliquez sur le lien ci-dessus, le fichier sera téléchargé grace à l'option download dans le shortcode ci-dessous:

    {up file=files/doc/memo-programmation.pdf | download }Télécharger l'aide mémoire programmation de UP{/up file}
    Télécharger le fichier sous un autre nom

    Le nom du fichier doit respecter les contraintes d'un serveur Linux (pas d'espace, ni caractères accentués).

    Mais un nom plus agréable peut être spécifié comme argument de l'option download. C'est sous ce nom que sera téléchargé le fichier sur le poste de l'internaute.

    {up file=files/doc/memo-programmation.pdf | download=Un nom plus agréable}Télécharger le fichier sous un autre nom{/up file}

    Ouvrir le fichier

    Ouvrir l'aide mémoire programmation de UP dans un nouvel onglet

    Si vous cliquez sur le lien ci-dessus, le fichier sera ouvert (download non spécifié) dans un nouvel onglet grace à l'option target. Par défaut target contient "_blank", mais il est possible d'indiquer une valeur autorisée. Si target n'est pas spécifié, le fichier sera ouvert dans la fenêtre en cours.

    {up file=files/doc/memo-programmation.pdf | target}Ouvrir l'aide mémoire programmation de UP dans un nouvel onglet{/up file}

    Les icônes

    Par défaut, une icône de 32px représentative du type de fichier est affichée devant le contenu indiqué entre les shortcodes.

    Ouvrir une photo de guépards dans une nouvelle fenêtre
    {up file=images/photos/Kenya-Cheetah-Masai-Mara.jpg | target}Ouvrir une photo de guépards dans une nouvelle fenêtre{/up file}

    Les types de fichier pris en charge sont : doc,exe,jpg,pdf,png,txt,xls,zip. Une icône générique "download" est utilisée pour les autres types de fichier.

    Pour ne pas afficher d'icône, il faut mettre l'option icon=0

    Télécharger une photo de guépards
    {up file=images/photos/Kenya-Cheetah-Masai-Mara.jpg | download | icon=0}Télécharger une photo de guépards{/up file}

    La taille de l'icône est par défaut de 32pixels. icon=16 affiche l'icône en 16 pixels

    Télécharger une photo de guépards
    {up file=images/photos/Kenya-Cheetah-Masai-Mara.jpg | download | icon=16}Télécharger une photo de guépards{/up file}

    Vous pouvez également spécifier l'icone à utiliser en indiquant le nom du fichier image avec son chemin

    des guépards
    {up file=images/photos/Kenya-Cheetah-Masai-Mara.jpg 
    | icon=images/photos/Kenya-Cheetah-Masai-Mara-mini.jpg 
    | target}
       des guépards
    {/up file}

    Autres options

    rel
    ajouter des attributs rel: alternate, author, bookmark, external, help, license, next, nofollow, noreferrer, noopener, prev, search, tag
    class
    ajoute les classes indiquées à la balise a. Exemple: class=btn btn-primary texte
    style
    ajoute les styles à la balise a. Exemple: style=border:1px solid red;padding:12px 6px texte