Génére un lien avec une icône et permet de forcer le téléchargement d'un fichier sous un nom plus agréable que celui du 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}- 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, ...
style et options secondaires
- id: Identifiant
- 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 des actions 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=images/actions-demo/file/UP-Memo-actions.pdf | download }Télécharger l'aide mémoire des actions 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=images/actions-demo/file/UP-Memo-actions.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 des actions 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=images/actions-demo/file/UP-Memo-actions.pdf | target}Ouvrir l'aide mémoire des actions 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-2/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
{up file=images/photos-2/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-2/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-2/Kenya-Cheetah-Masai-Mara.jpg
| icon=images/photos-2/Kenya-Cheetah-Masai-Mara-mini.jpg
| target | download}
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
upactionslist (1) addcsshead (1) file (9) jcontent-info (1)
Crédit image : bigcatfacts.net/cheetah