Une action pour afficher des informations et éléments de l'article en cours. Cela peut paraitre bizarre d'afficher l'article qui est déjà affiché, mais cela peut être utile pour le présenter autrement ou à un autre emplacement.
{up jcontent-info=nom_info}syntaxe 2 :
{up jcontent_info}<b>une info :</b> ##nom_info##{/up jcontent_info}syntaxe 3 :
{up jcontent_info | template=[b]une info :[/b] ##nom_info##}Les mots-clés :
##id## ##title## ##subtitle##
##image## ##image-src## ##image-alt## ##image-legend##
##image-full## ##image-full-src## ##image-full-alt## ##image-full-legend##
##date-crea## ##crea_by## ##date-modif## ##modif_by##
##url-a## ##url-b## ##url-c##
##date-publish## ##date-unpublish##
##note## ##cat## ##catid## ##breadcrumbs##
##featured## ##hits## ##tags## ##tags-link## ##author##
##CF_id_or_name## : valeur brute du custom field
- jcontent_info: le nom d'un élément ou rien
Modèle de présentation
- template (item-template) = ##content##: modèle de mise en page. Si vide le modèle est le contenu. BBCode accepté
balise & style du bloc principal
- tag = _div: balise pour le bloc d'un article. _div = div si class ou style, sinon rien. = 0=jamais
- id: identifiant
- style: classes et styles inline pour un article
- class: classe(s) pour un article (obsoléte)
Format pour les mots-clés
- date-format = %e %B %Y: format pour les dates
- date-locale: localisation pour les dates. Par défaut, celle du navigateur client.
- featured-html = [b class="t-gris"]★[/b], [b class="t-jauneFonce"]★[/b]: présentation mise en vedette
- tags-list-prefix: texte avant les autres eventuels tags
- tags-list-style = badge;margin-right:4px: classe ou style affecte a une balise span par mot-cle
- tags-list-separator: separateur entre mots-cles
- path-separator = »: caractère ou bbcode pour séparer les items menus ou les catégories
- path-current-class = b: style de l'élement terminal d'un chemin
- path-parent-class = fs90: style des élements parents
- path-order = asc: asc: élément terminal à la fin, desc : au début
- path-link = 1: affiche les liens sur les éléments.
Style CSS
- css-head (base-css): code CSS dans le head
- Version 2.5
- ajout mot-clé ##cat-id## , ##navpath## et ##catpath##
- utilisation dans modules
- Version 2.6
- ajout mot-clé ##cat-id## , ##navpath## et ##catpath##
- utilisation dans modules
- Version 2.9
- ajout ##tags-link## pour récupérer les tags avec un lien vers la liste des articles avec le tag (Merci Deny)
- ajout motclé ##upnb## : nbre actions UP dans la page et ##uplist## : nbre par actions
- Version 3.1
- Prise en charge étendue des mots-clés pour les customFields
Un exemple simple
L'article a été modifié le {up jcontent_info=date-modif}Ce shortcode affiche ceci : L'article a été modifié le 11 octobre 2023
Il suffit d'indiquer l'unique info demandée comme argument principal
Un peu plus compliqué
{up jcontent_info | class=bd-blue p1 | date-format=%A %e %B %Y}
L'article a été créé le ##date-crea## par ##author##
{/up jcontent_info}
{up jcontent_info | class=bd-red p1 | date-format=%A %e %B %Y
| template=L'article a été créé le ##date-crea## par ##author##}Les 2 shortcodes ci-dessus produisent le même résultat, la seule différence est le modèle de mise en page (template) est indiqué comme :
- contenu entre les shortcodes pour le premier
- option template dans le 2e cas
Ces shortcodes permettent de passer des options comme une classe ou un format pour les dates
Breadcrumbs et fil d'Ariane
Suite à une demande sur le forum de Joomla.fr, j'ai ajouté la possibilité d'afficher le fil d'Ariane ou breadcrumbs (navpath), mais aussi les catégories parentes (catpath)
Il est difficile d'en faire la démonstration, car cet article est dans une catégorie de premier niveau.
5 options permettent de modifier le comportement
- path-separator
Un contenu HTML (BBCode) permet de définir le caractère, l'image ou une balise HTML pour séparer les différents éléments du chemin navpath ou catpath.
Par défaut, c'est le caractère ».
[br] permet de mettre chaque élément sur une ligne.[img src="/media/system/images/arrow.png"]ou{up icon=media/system/images/arrow.png}pour utiliser une image- path-current-class,path-parent-class
Ces 2 options permettent d'habiller l'item courant et celui des ascendants.
Pour mémoire, UP accepte des classes CSS et des styles à condition qu'ils soient séparés par des points-virgules.
path-current-class=t-darkRed;border-bottom:1px var(--darkRed) dottedest valide pour afficher un texte rouge et en gras avec un souligné rouge pointillé.
- path-order
Par défaut, l'élément courant est affiché en dernier (asc). desc permet d'inverser l'ordre
- path-link
Par défaut, un lien vers le blog de la catégorie est ajouté à tous les éléments du chemin ou le menu.
Si votre site ne dispose pas de ce type de blog, 2 possibilités :
- ne pas le proposer avec l'option path-link=0
- ajouter un blog de catégorie dans un menu invisible
Quelques exemples :
Actions{up jcontent_info=catpath}La catégorie (et celles des parents si elles existaient !) en utilisant les valeurs par défaut des options
La catégorie de cet article est : Actions
{up jcontent_info
| path-current-class=t-darkRed;b;border-bottom:1px var(--darkRed) dotted
| path-separator=[br]
| path-order=desc
| path-link=0 }
La catégorie de cet article est : ##catpath##
{/up jcontent_info}Idem en personnalisant les options pour avoir chaque catégorie sur une ligne. La principale, texte rouge gras et souligné, est en haut
Démo actions
{up jcontent_info
| path-separator={up icon=media/system/images/arrow.png}}
##navpath##
{/up jcontent_info}Mêm si la structure du site ne permet pas de voir le séparateur, un exemple de fil d'Ariane (breadcrumbs) en utilisant l'image par défaut de Joomla.
Les mots-clés
Pour mettre en forme le texte retourné par l'action, il faut utiliser les mots clés ci-dessous.
Pour les utiliser comme argument de template, il faut l'entourer de ## (exemple ##id##)
| mot-clé | description |
|---|---|
| id | identifiant de l'article en cours |
| title | le titre de l'article |
| subtitle | le sous-titre (partie du titre après le tilde) |
| image | l'image d'introduction sous la forme <img src="/image-src" alt="image-alt">Vous pouvez aussi construire votre balise avec image-src et image-alt [img src="##image-src##" alt="##image-alt##" style="width:100%"]. Attention, en l'absence d'image, le code (vide) sera généré" |
| image-legend | la légende pour l'image d'introduction" |
| image-full | l'image de l'article complet sous la forme <img src="/image-full-src" alt="image-full-alt">Vous pouvez aussi construire votre balise avec image-full-src et image-full-alt [img src="##image-full-src##" alt="##image-full-alt##" style="width:100%"]. Attention, en l'absence d'image, le code (vide) sera généré" |
| image-full-legend | la légende pour l'image de l'article complet |
| url-a url-b url-c |
les liens A, B et C sous la forme d'une URL Texte du lien A |
| crea created_by |
la date de création et l'auteur de l'article |
| date-modif modif_by |
la date de la dernière modification et son auteur |
| date-publish date-unpublish |
la date de publication et celle de dépublication |
| note | la note de l'article |
| cat | la catégorie de l'article |
| featured | l'article est-il en vedette ? vous pouvez définir le texte ou symbole affiché avec l'option featured-html qui contient le texte pour les 2 états séparé par une virgule. exemple : normal , en vedette |
| hits | le nombre d'affichages de l'article |
| tags | les tags. Voir les options : tags-list-prefix, tags-list-style et tags-list-separator |
Ci-dessous, comme démonstration, toutes les informations sur cet article :
- id : 249
- title : jcontent-info
- subtitle:
- image :
- image-src :
- image-alt : <- créé à partir du nom de l'image
- image-legend :
- image-full :
- image-full-src : images/up-lego.png
- image-full-alt : UP logo LEGO
- image-full-legend : Universal Plugin
- crée le 25 May 2021 par lomart
- modifié le 11 October 2023 par lomart
- Publié le : 25 May 2021 et dépublié le 6 October 2024
- URL A : ##url-a##
- URL B : ##url-b##
- URL C : ##url-c##
- note : Affiche les informations de l'article courant
- catégorie : Actions
- en vedette : ★
- hits : 1019
- tags : Joomla!
upactionslist (1) readmore (1) csv2def (2) tabslide (1) toc (1) jcontent_info (8) flexauto (1) icon (1) csv2table (1) jcontent-info (1)