jcontent-list ~ liste des articles d'une catégorie

Ce simple shortcode permet d'insérer une liste des articles d'une catégorie.

Avant la version 1.7, elle était connue sous le nom de article_category. Ce nom peut toujours être utilisé.

🆙 jcontent_list (article_category) : liste des articles d'une catégorie

Cliquer pour lire la documentation

syntaxe : {up jcontent-list=id-catégorie(s)}
Une action très pratique pour lister les articles de la catégorie en cours, il suffit de taper {up jcontent-list}
@author: LOMART @version: UP-0.9 @license: GNU/GPLv3 @tags: Joomla
  • jcontent_list (article_category): ID de la catégorie ou vide pour celle de l'article actuel
  • maxi: Nombre maxi d'article dans la liste
  • no-published (no_published) = 1: Liste aussi les articles non publiés
  • author: filtre sur auteur: liste des id ou article, current
  • sort-by = title: tri: title, ordering, created, modified, publish_up, id, hits
  • sort-order = asc: ordre de tri : asc, desc

Style du bloc principal

  • id: identifiant
  • main-class: classe(s) pour bloc principal (obsoléte)
  • main-style: classes et styles inline pour bloc principal
  • class: idem main-class. Conservé pour compatibilité descendante
  • style: idem main-style. Conservé pour compatibilité descendante

Titre : balise et style

  • title (titre): titre HTML si article trouvé.
  • title-tag = h3: niveau du titre
  • title-style: classes et styles inline pour le titre
  • title-class: classe(s) pour le titre (obsoléte)

Style de la liste

  • list-style: classes et styles inline pour la liste
  • list-class: classe(s) pour la liste (obsoléte)

Style CSS

  • css-head (base-css): code CSS dans le head

Cette action, conservée pour compatibilité descendante, n'évoluera plus. Il est conseillé d'utiliser jcontent_by_categories, aussi appelé jnews 😊

Version simple

{up jcontent_list}

Ce simple shortcode sans argument affiche tous les articles de la catégorie de l'article courant. Dans notre cas, ce sont toutes les démonstrations d'actions.

Shortcode avec paramètres

{up jcontent_list | maxi=5 
  | sort_by=modified | sort_order=desc 
  | style=border:tan solid 1px 
  | title=Les 5 derniers articles modifiés 
  | title-style=margin:5px 30px;border-bottom:tan 1px solid;notoc
  | list-style=list-style-type:lower-roman 
}

Le shortcode ci-dessus permet d'afficher les 5 derniers articles modifiés avec un style de liste en chiffres romains.
Le titre, indiqué dans le shortcode, sera affiché uniquement si la liste contient des éléments.
J'ai ajouté la classe notoc dans title-style* pour éviter sont ajout dans le sommaire de cet article.
* Ce n'est pas une erreur. UP est très tolérant, il admet une classe dans une option style et vice-versa !

Filtre par auteur(s)

La version 1.4 permet un filtrage sur les auteurs des articles. Il suffit d'ajouter le paramètre author

Tous les articles des auteurs d'id 80 et 82.

{up article-category | author=80,82 }

Tous les articles de l'auteur de l'article courant

{up article-category | author=article }

Tous les articles de l'auteur connecté

{up article-category | author=current }

Test du shortcode dans un module

Les lignes ci-dessous sont affichées par {loadposition demo-up-module}.
Le module à cette position est un module personnalisé qui contient le shortcode

{up jcontent_list=10,12 | maxi=5 | sort_by=created | sort_order=desc | list-style=list-style-type:square;t-vert}
Les 5 dernières actions des catégories documentation et références

En dehors du fait d'être utilisée dans un module, met en avant la possibilité d'indiquer la ou les catégories des articles à afficher.

Les options comparées

La table ci-dessous est un comparatif des options proposées par les différentes actions Jxxx
A: jcontent-in-content, AL: jcontent-list, AC: jcontent-by-categorie (jnews), AS: jcontent-by-subcat, AT: jcontent-by-tags, CT: jcategories-by-tags, CM: jcontent-metadata
Si vous avez appelé ce tableau à partir de la démo d'une action, la colonne la concernant est sur fond jaune.

Option A AL AC AS AT CT CM Description
principale ID(s) catégorie(s) séparé avec virgule, vide pour celui de l'article actuel ou 0 pour tout les IDs
maxi nombre maxi d'articles dans la liste. non précisé (par défaut) = tous
exclude 0 pour exclure l'article en cours
current toutes les catégories seront sélectionnées sauf celles indiquées dans l'option principale
no-published liste aussi les articles non publiés. Vrai par défaut
content-plugin prise en compte des plugins de contenu pour mots-clé content et intro. Peut échouer en cas d'appels récursifs
sort-by ordre de tri: title, ordering,created,modified,publish_up (par défaut),id,hits
sort-order ordre de tri : asc, desc (par défaut)
author filtre sur auteur: aucun (par défaut) OU id1,id2 OU article auteur de l'article en cours OU current utilisateur connecté.
template modèle de mise en page. Si vide le modèle est le contenu
main-tag balise pour le bloc englobant tous les articles. div par défaut, 0 pour aucun
main-style classes et styles inline pour bloc principal (inactif si main-tag=0)
main-class classe(s) pour bloc principal (inactif si main-tag=0)
item-tag balise pour le bloc d'un article. div par défaut, 0 pour aucun.
item-style classes et styles inline pour un article (inactif si art-tag=0)
item-class classe(s) pour un article (obsoléte) (inactif si art-tag=0)
date-format format pour les dates. '%e %B %Y' par défaut. (1)
date-locale localisation pour les dates au format 'fr_FR'. Celui du client par défaut.
featured-html code HTML pour article en vedette. Défaut: ⭐ ⭐
new-days 30 par défaut. nombre de jours depuis sa création pour considérer un article comme nouveau
new-html Code HTML pour le badge NEW. nouveau par défaut
image-src image utilisée si aucune image n'est trouvée dans l'article. Défaut: '//lorempixel.com/300/300'
image-alt texte alternatif si aucune image n'est trouvé dans l'article
tags-list-separator séparateur entre les mots-cles
tags-list-prefix texte avant les autres clés éventuelles si tag {tag-list}
tags-list-style classe ou style pour les autres mots-clés
no-content-html texte si aucun contenu
css-head code CSS dans le head
spécifique jcontent-list (ex article-category)
title titre HTML si article trouvé.
title-tag niveau du titre
title-style classes et styles inline pour le titre
title-class classe(s) pour le titre
list-style classes et styles inline pour la liste
list-class classe(s) pour la liste
class idem main-class (conservé pour compatibilité descendante)
style idem main-style (conservé pour compatibilité descendante)
spécifique jcontent-by-subcat
cat-level 0 a 99 - niveau maxi des sous-categories explorées
cat-tag Balise pour les lignes catégories. LI pour passer en mode list arborescente
cat-class classes et styles inline pour les catégories
cat-style classes et styles inline pour les catégories
cat-template modèle pour les lignes de categories
cat-root-view affiche l'unique categorie racine. si root=jamais, si plusieurs=toujours
cat-separator pour separer l'arborescence des categories
spécifique jcontent-metadata
meta-title-min alerte coloré si le titre contient moins de lettres
meta-title-max alerte coloré si le titre contient plus de lettres
meta-desc-min alerte coloré si la description contient moins de lettres
meta-desc-max alerte coloré si la description contient plus de lettres

(1) - Le format d'affichage est défini par l'option date-format. Sa valeur par défaut est : %e %B %Y qui affiche la date sous la forme 1 mai 2019.
Il s'agit de la codification PHP pour la fonction strftime. Les codes usuels sont %y année sur 2 chiffres, %Y année sur 4 chiffres, %m mois sur 2 chiffres, %b nom mois abrégé en 3 lettres, %B nom mois complet, %e jour (1-31), %d jour sur 2 chiffres (01-31), %A nom jour complet, %a nom jour abrégé, %H heure (00-23), %M minutes (00-59)

Les mots-clés

Cette action n'utilise pas le système des mots-clés

Pour info, cette page utilise 9 action(s) :
upactionslist (1) icon (1) tabslide (1) toc (1) jcontent_list (2) addcsshead (1) jcontent_in_content (1) jcontent-info (1)
Détails