jcontent-metadata ~ contrôle des metadonnées

Cette action est un outil pour le webmaster.

Elle permet de repérer rapidement les pages non indexées, avec un titre trop court ou trop long, sans description, ...

Utilisation

Cette action est une variante de l'action jcontent-by-categories, je vais donc me contenter de fournir un exemple d'utilisation.

La table ci-dessus affiche des informations sur les cinq derniers articles de ce site. Il est possible de rechercher un texte et de trier toutes les colonnes (même les dates !).

• La colonne meta-title contient le nombre de caractères de la balise title dans le head de la page suivi de la taille maximale. Il correspond à la longueur du titre majoré selon la configuration du site du nom du site. Une taille orange signifie que le nombre de caractères est inférieur à l'option meta-title-min ou supérieur à meta-title-max
• La colonne meta-desc contient le nombre de caractères de la balise description dans le head de la page. La couleur orange dépend des valeurs de meta-desc-min et meta-desc-max
  Son utilité est discutable selon webrankinfo. Personnellement, je n'en mets pas.
• La colonne meta-key affiche le contenu du champ "Publication/Mots clés" de l'article. Elle me semble totalement inutile, mais comme Joomla la conserve ...
• Les colonnes index et follow tiennent compte de la configuration générale du site, de celle de la catégorie et enfin de l'article.
  Pour faciliter la lecture les valeurs restrictives sont en rouge.
• les colonnes date publication et épinglé correspondent aux dates dans l'onglet publication de l'article. Elles sont en rouge si la date début est postérieure à la date actuelle ou si la date de fin est échue.

Voici les 3 shortcodes utilisés dans l'ordre d'interprétation :

• jcontent_metadata récupère les données dans la BD de joomla
• csv2table transforme les données reçues au format CSV en tableau HTML
• table-sort apporte les fonction de recherche et de tri au tableau

{up table-sort
| col-type=a-n-n-a-a-d-d-a-a-a-d-d-d-d
| pagination=20}
{up csv2table
| header=Lien;meta[br]title;meta[br]desc;meta[br]key;cat;création; modif;accès;index;follow;début[br]publication;fin[br]publication;Epinglé[br]début;Epinglé[br]fin
| col=15-c5-c5-c5-c-c-c-c-c-c-c-c-c-c | style=display:block;overflow-x:scroll;
}
{up jcontent_metadata=0
| maxi=5 | main-tag=0 | item-tag=0 | sort-by=id
| template=##id## - ##title-link## ; ##meta-title##; ##meta-desc## ; ##meta-keys## ; ##cat## ; ##date-crea## ; ##date-modif## ; ##nivaccess## ; ##meta-index## ; ##meta-follow## ; ##date-publish## ;  ##date-publish-end## ; ##date-featured## ; ##date-featured-end##
}
{/up csv2table}
{/up table-sort}

Quelques précisions sur les options utilisées :

2 - col-type contient le type de données des colonnes pour le tri. Depuis la version 3.1 de UP, le tri par date est possible.

3 - bien qu'inutile dans notre cas, pagination facilite la lecture des longues listes

5 - header définit les titres du tableau. Depuis la version 3.1 de UP, le BBCode est autorisé

6 - col est utile pour définir la largeur relative et la justification des colonnes et style pour ajouter un ascenseur sur les petits écrans

8 - l'argument 0  pour l'action jcontent-metadata permet de prendre en compte tous les articles. On peut aussi indiquer les ID des catégories séparées par des virgules ou vide pour celle de l'article actuel 

9 - diverses options pour définir la clé de tri pour la récupération des données (sort-by), le nombre maxi d'articles. main-tag et item-tag à zéro pour éviter des balises HTML sur la liste CSV retournée

10 - les mots clés pour les données à récupérer. Remarquez le traditionnel point-virgule pour séparer les colonnes du format CSV. La liste complète des mots-clés est disponible dans le bandeau bleu de la documentation en début de cette démo ou dans le tableau des mots-clés

Les options

Les mots-clés

La table ci-dessous est un comparatif des mots-clés utilisés 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.

Mot-clé	A	AL	AC	AS	AT	CT	CM	Description
##id##								ID de l'article
##title##								titre de l'article sans lien vers l'article
##title-link##								titre de l'article avec lien vers l'article
##subtitle##								sous-titre (partie du titre après le tilde) (1)
##maintitle##								titre (partie du titre avant le tilde) (1)
##link##								à utiliser comme argument de l'attribut href d'une balise a.
##intro##								texte d'introduction de l'article au format HTML. (2)
##intro-text##								texte d'introduction de l'article au format texte sans aucune balise HTML. (2)
##intro-text,100##								variante qui permet de limiter le nombre de caractères affichés (100 dans cet exemple). (2)
##content##								Le contenu si existant. (2)
##image##								image d'introduction de l'article ou à défaut la première image trouvée dans le texte d'introduction.
##image-link##								image avec lien vers l'article
##image-src##								variante du mot-clé précédent qui permet un plus grand contrôle sur le résultat. (4)
##image-alt##								idem
##date-crea##								date de création (4)
##date-modif##								date de modification (4)
##date-publish##								date de publication de l'article (4)
##date-publish-end##								date de fin de publication de l'article (4)
##date-featured##								date de mise en vedette de l'article (4)
##date-featured-end##								date de fin de mise en vedette de l'article (4)
##author##								nom de l'auteur de l'article
##note##								note sur l'article
##cat##								nom de la catégorie
##cat-link##								lien vers la catégorie
##new##								badge nouveau si l'article est récent. Voir les options ‘new-jours’ et ‘new-html’
##featured##								si article en vedette
##count##								nombre d'article dans la catégorie
##hits##								le nombre de vues de l'article
##tags-list##								liste des mots-clés
##uplist##								liste des actions dans l'article
##upnb##								nombre d'actions dans l'article
##CF##								CustomField. Remplacer CF par son nom ou son ID. Voir modèle avec %label%, %value% et %rawvalue%
##nivaccess##								niveau d'accès requis
##meta-index##								index ou no-index
##meta-follow##								index ou no-index
##meta-title##								longueur de la meta  title avec alerte colorée
##meta-desc##								longueur de la meta description avec alerte colorée
##meta-key##								liste des meta keywords
spécifique jcontent-by-subcat
##catpath##								chemin des catégories parentes
Recherche dans les champs JSON
##champ.key##								champ (attribs, metadata, images ou urls) suivi d'un point et de la clé

(1) - il s'agit d'une astuce que j'utilise pour décomposer le titre d'un article en titre et sous-titre en les séparant par le caractère tilde (~). En dehors de la possibilité de styler différemment les 2 parties, un titre plus long est meilleur pour le référencement.
Concrétement, si le tag {subtitle} est présent dans votre template et que le titre contient un tilde, il sera scindé en {titre] et {subtitle}. Dans le cas contraire, le {subtitle} sera vide et {title}: contiendra la totalité du titre de l'article.

(2) - A la différence de Joomla, si l'introtext n'existe pas, il n'est pas remplacé par le contenu. Et vice-versa. Si le besoin existe, on peut créer un mot-clé "article,X" qui insère les X premiers caractères en supprimant les shortcodes UP.

(3) - Exemple de template: <img src="/{image-src}" alt="{image-alt}" class="img-sepia left" width="100px">.
⚠ si l'article ne contient pas d'image, le reste du code sera quand même inséré.

(4) - 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)

Attention : ne pas utiliser les mots-clés dans votre contenu

Si cela est impossible, remplacez l'accolade ouvrante par son code {, soit pour id : {id}.
Une autre méthode est de mettre en gras une partie : {<b>id</b>}.

Si vous l'utilisez avec une action csv2table, pour éviter le conflit avec le séparateur point-virgule, changer le séparateur utilisé ou mettre le contenu de la cellule entre guillemets. "{id}" ou {<b>id</b>}