Aujourd'hui, je vous propose un petit plugin que j'ai dû développer dans mon cadre professionnel.
La problématique
Avec Joomla, vous avez la possibilité de déclarer des champs répétables. Ce type de champ permet pour un seul type de données, de déclarer plusieurs valeurs. Pour les programmeurs, nous pourrions comparer cela à des tableaux.
Afin de comprendre, je vous donne un exemple. Si nous déclarons un champ prix, nous pouvons spécifier selon les conditions de l'utilisateur par exemple différents prix spécifiques. Exemple pour les enfants 20 francs, pour les adultes 30 francs, (ah mince nous sommes passés en euros ...)
Ce n'est pas grave, vous avez compris le principe point mais mon problème était le suivant : comment afficher de manière claire et propre dans un tableau HTML l'ensemble des données que je déclare dans ce type de champs répétable de Joomla. En effet, même si l'on peut utiliser le mot-clef "field" dans un articlle pour afficher un champs à valeur unique, en procédant de la sorte avec un champs répétable, l'affichage n'est pas clair.
Un petit plugin
Pour pouvoir résorber mon problème, j'ai écrit un petit plugin que je vous propose, qui a comme but de recenser pour un champ donné l'ensemble des valeurs de ce type, de les récupérer sous la forme Json (cela ne dépend pas de moi mais ce sont les API de Joomla qui renvoient dans ce formalisme spécifique) et, une fois ces valeurs récupérées, le plugin les présente sous la forme d'une table HTML. Voilà, le principe est très simple, je n'ai pas spécifié dans les paramètres du plugin, car cela pourrait poser problème selon l'ensemble des types de valeur que l'on souhaite afficher, mais j'ai véritablement adapté mon plugin à mon besoin.
Je suis bien conscient que dans mon cadre de mon développement, le html retourné est propre à mon besoin, il n'y a pas de spécifications et surtout pas de généralités possibles avec mon plugin, mais vous pouvez bien entendu adapter le code HTML afin de retourner pour pouvoir afficher ce dont vous avez besoin.
showrepetable.php
<?php
defined('_JEXEC') or die('Access deny');
class plgContentShowRepetable extends JPlugin //Concatener à "plg" le nom du groupe (ici Content) puis le nom du plugin ( que l'on trouve ds le XML ligne extension) : plg<Plugin Group><Plugin name>
{
function onContentPrepare($content, $article, $params, $limit){
$document = JFactory::getDocument()->addStyleSheet("plugins/content/showrepetable/style.css");
//Acces aux custom fields
JLoader::register('FieldsHelper', JPATH_ADMINISTRATOR . '/components/com_fields/helpers/fields.php');
$customFields = FieldsHelper::getFields('com_users.user', JFactory::getUser(), true);
$a = FieldsHelper::getFields('com_content.article', $article);
$T_NNO = array();
$T_EMAT8 = array();
$T_DESC = array();
$c = array();
$i=0;
$chaine = '<div class="references-du-materiel">';
foreach($a as $unElement)
{
if ($unElement->name == 'r-emat8') //r-emat8 eest le code du champs
{
//echo($unElement->value); //-> C'est un json
$T_EMAT8 = json_decode($unElement->value,true);
$chaine .= '<table border="1" class="table-EMAT8">';
$chaine .= '<tr><td colspan="2" class="titre-tableau-EMAT8">EMAT 8</td></tr>';
foreach($T_EMAT8 as $uneLigne)
{
$chaine .= "<tr><td>".$uneLigne["Description"]."</td><td>".$uneLigne["Emat8"]."</td></tr>";
}
$chaine .= "</table>";
}
if ($unElement->name == 'r-nno') //r-nno est le code du champs
{
$T_NNO = json_decode($unElement->value,true);
$chaine .= '<table border="1" class="table-NNO">';
$chaine .= '<tr><td colspan="2" class="titre-tableau-NNO">NNO</td></tr>';
foreach($T_NNO as $uneLigne)
{
$chaine .= "<tr><td>".$uneLigne["Description"]."</td><td>".$uneLigne["NNO"]."</td></tr>";
}
$chaine .= "</table>";
}
$i++;
}
$chaine .= '</div>';
$article->text = preg_replace('/{showreferences}/s', $chaine, $article->text);
}
}showrepetable.xml
<?xml version="1.0" encoding="utf-8"?>
<extension version="3.1" type="plugin" group="Content">
<name>Show Repetables</name>
<author>Sebastien LHUILLIER</author>
<creationDate>Janvier 2023</creationDate>
<copyright>Sébastien LHUILLIER</copyright>
<license>GNU General Public License version 2 or later; see LICENSE.txt</license>
<authorEmail>Cette adresse e-mail est protégée contre les robots spammeurs. Vous devez activer le JavaScript pour la visualiser.</authorEmail>
<authorUrl>www.sebastien-lhuillier.com</authorUrl>
<version>1.0</version>
<description>Affiche proprement un champs de type repetable</description>
<files>
<filename plugin="showrepetable">showrepetable.php</filename>
<filename>showrepetable.xml</filename>
</files>
</extension>