UP logo LEGO
Universal Plugin

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.

🆙 jcontent_info : Affiche des informations sur l'article courant

Cliquer pour lire la documentation

syntaxe 1 : {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
@author: LOMART @version: UP-2.5 @license: GNU/GPLv3 @tags: Joomla
  • 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"]&#x2605;[/b], [b class="t-jauneFonce"]&#x2605;[/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

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é

L'article a été créé le Tuesday 25 May 2021 par lomart
{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}
L'article a été créé le Tuesday 25 May 2021 par lomart
{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) dotted

est 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 : UP logo LEGO
    • 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 27 May 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 : 959
  • tags : Joomla!
Pour info, cette page utilise 18 action(s) :
upactionslist (1) readmore (1) csv2def (2) tabslide (1) toc (1) jcontent_info (8) flexauto (1) icon (1) csv2table (1) jcontent-info (1)