Pour éviter d'oublier d'argumenter les images de l'onglet "images et liens"
Cette action a été créée pour répondre à une demande sur le forum lomart.fr
Personnellement, je n'écris jamais un article à partir d'une page blanche. J'aime bien avoir mes repères et passages obligés. Cette action en fait partie.
{up jcontent-image} // première image du contenu de l'articlesyntaxe 2 :
{up jcontent-image=chemin_vers_image}syntaxe 3 :
{up jcontent-image=dossier} // première image du dossier
*- jcontent_image: chemin vers l'image pour intro et fulltext
Options pour image d'introduction
- intro-size = 250px: coté du carré en px. 0=pas d'image
- intro-alt: contenu attribut alt. 0=aucun, vide=nom du fichier humanisé
- intro-caption: légende. 0=aucun, vide=nom du fichier humanisé
- intro-class: classe(s) pour l'image. si débute par +, on ajoute aux classes existantes
Options pour image de l'article
- full-size = 500px: coté du carré en px. 0=pas d'image
- full-alt: contenu attribut alt. 0=aucun, vide=nom du fichier humanisé
- full-caption: légende. 0=aucun, vide=nom du fichier humanisé
- full-class: classe(s) pour l'image. si débute par +, on ajoute aux classes existantes
Paramètres
- subfolder-thumbs: nom du sous-dossier pour la vignette. vide=images/upthumbs pour toutes les vignettes
- id = identifiant interne: interne. inutilisé
Le principe
Il est impossible de faire une démo de cette action, je dois donc me contenter de vous expliquer son utilisation.
L'action est exécutée à l'affichage de l'article. Les modules ne sont pas concernés.
Si les champs images ne sont pas vides :
- on vérifie que le(s) fichier(s) existe(nt) toujours, sinon on passe à l'étape suivante.
Si les champs images de l'article sont vides ou non valides :
- Pour un shortcode vide
{up jcontent-image}, on utilise la première image dans le code de l'article. - Pour un shortcode non vide
-
{up jcontent-image=images/img1.jpg | intro-alt=texte}, on utilise l'image indiquée -
{up jcontent-image=images/photo | intro-alt=texte}, on utilise la première image du dossier
-
Si les images ne conviennent plus :
- on doit les supprimer manuellement dans dans l'onglet "images et liens" OU supprimer le fichier
- on adapte le shortcode au nouveau choix
Les options
- jcontent-image
- l'option principale peut contenir :
- vide = on utilise la première image trouvée dans l'article.
Attention : si les images sont ajoutées par une autre action de UP, le shortcode jcontent-image doit être avant celle-ci
Astuce : pour ne pas ajouter un shortcode jcontent-image dans tous les articles, utilisez le champ "Code à insérer AVANT contenu" du plugin LM-ArtPlug - le chemin vers un dossier : on utilise la première image dans l'ordre alphabétique de ce dossier
- le chemin vers un fichier image : on utilse cette image
Les types d'images acceptées sont : jpg, jpeg, png, webp
L'image retenue aura une taille supérieure ou égale à celle demandée par l'option full-size.
Si la plus grande image est inférieure à full-size, mais supérieure à intro-size, on ajoute uniquement l'image d'introduction. - vide = on utilise la première image trouvée dans l'article.
- intro-size
- full-size
- le côté du carré dans lequel inscrire l'image d'introduction et celle de l'article. L'unité est obligatoirement en pixels.
Une valeur de zéro indique que l'on ne veut pas d'image.
- intro-alt
- full-alt
- intro-caption
- full-caption
- le texte pour la balise alt et le libellé des images.
Ces options peuvent contenir :
- 0 = aucun texte
- vide = une version humanisée du nom du fichier
- un texte = le texte à utiliser
- intro-class
- full-class
- la ou les classes pour l'image.
Si le premier caractère est le signe
+, les classes seront ajoutées à celles qui existent déjà - subfolder-thumbs
- Permet de définir l'emplacement des vignettes
- vide : les vignettes sont enregistrées dans le dossier
images/upthumbs
le nom des fichiers a la forme :id_article-nom_image-intro_ou_full.ext - le nom du sous-dossier qui sera créé dans le dossier de l'image.
le nom des fichiers a la forme :nom_image-intro_ou_full.ext
- vide : les vignettes sont enregistrées dans le dossier
grid (1) span (1) upactionslist (1) csv2def (1) jcontent-info (1)