A la recherche du texte d'aide perdu

[lomart]

Bonjour,

Sous Joomla 4, la description des options n'est plus affichée dans les paramètres des extensions. A part "Alias" qui prend une place folle dans l'édition d'un article, plus une petite bulle d'aide pour préciser le rôle d'une option.
On m'a dit au Joomladay que cela était paramétrable avec la dernière version, mais où ?
Merci à qui saura me répondre

[woluweb]

qui a dit ça ?

[lomart]

qui a dit ça ?

C'est pas toi. J'ai un doute, mais son prénom débute peut-être par un Y

[tataye]

il y a un bouton afficher masquer l'aide, ce ne serait pas cela ?

[abmag]

plus une petite bulle d'aide pour préciser le rôle d'une option

Si l'option est présente (heureusement) ne serait-il pas judicieux, pour une version toute neuve, avec une interface trés modifiée dans sons aspect et sa structure, de l'activer par défaut? Surtout dans ses premières versions "grand public".
Qu'en pensez-vous ?

[lomart]

il y a un bouton afficher masquer l'aide, ce ne serait pas cela ?

Merci Serge,

Oui, cela peut être cela. Sur un site frais importé de J3.10, le bouton se nomme "Toggle inline help".
Il n'est disponible que dans la configuration et encore pas pour tous les champs.
Dans les paramètres d'un menu, d'un article, d'un module ou plugin, je n'en vois pas trace
L'aide est bien là en display:none, mais sans le bouton pour l'afficher

J'ai vérifié sur un site tout neuf en J4.1.3, c'est pareil.
A quoi cela sert-il d'avoir des textes d'aide cachés sur la page ?

abmag

Si l'option est présente (heureusement) ne serait-il pas judicieux, pour une version toute neuve, avec une interface trés modifiée dans sons aspect et sa structure, de l'activer par défaut? Surtout dans ses premières versions "grand public".
Qu'en pensez-vous ?

Mille fois oui

[lomart]

Je viens de passer 2 sites en J 4.1.4 et miracle les aides sont revenues
et le bouton a son texte en français
Que du bonheur

[pmleconte]

Bonjour,

L'affichage ou non de l'aide est gérée par media\system\js\inlinehelp.js (ou inlinehelp.min.js si on n'est pas en debug).

Pour les modules/composants/plugins, cela suppose de l'insérer dans les appels de librairie, ainsi que d'ajouter le fameux bouton.

Par défaut en Joomla 4.1.4, l'aide est affichée et, sur certains de mes composants, cela prend pas mal de place.

Un peu de travail pour ce long weekend ?

Pascal

[pmleconte]

Pour les développeurs, l'ajout du bouton "afficher/masquer l'aide" dans l'administration d'un composant est simple.

Il suffit d'ajouter dans le fichier <form>.xml de l'administration de votre composant (juste sous la balise <form> les lignes :

<config>         
<inlinehelp button="show"/>     
</config>

Puis, dans le fichier administrator/<votre composant>/src/View/<votre page>/HtlmView.php, dans la fonction addToolBar() la ligne :

ToolbarHelper::inlinehelp();

Un exemple d'implémentation est visible dans administrator/components/com_config/src/View/Application/HtmlView.php et administrator/components/com_config/forms/application.xml.

Pascal

[lomart]

Merci Pascal,

Toujours au courant du petit détail. Rien ne t'échappe ...

Pour les développeurs, l'ajout du bouton "afficher/masquer l'aide" dans l'administration d'un composant est simple.

Si simple que la majorité des modules et plugins du core Joomla ne l'utilise pas

Avec la 4.1.4, les textes d'aide sont réapparus. Cela me va bien et je passerais ce long week-end sur un autre sujet

[pmleconte]

Pour les modules/plugins, apparemment, il y a eu un choix de ne pas le faire : voir https://github.com/joomla/joomla-cms/pull/37819

Pourtant, l'implémentation est simple à faire comme pour les composants puisque com_plugins et com_modules sont eux-mêmes des composants, donc, les lignes décrites plus haut s'y appliquent. Je vais faire un PR dans ce sens dès que j'ai un peu de temps.

D'ailleurs, au niveau du PR 37819, il est dit que le bouton existe pour com_content, or, j'ai constaté que ce n'est pas fait.....

Pascal

[lefabdu51]

bonjour,
et le contenu qui doit etre affiché, on le met ou?

[tataye]

Merci Pascal,


Si simple que la majorité des modules et plugins du core Joomla ne l'utilise pas

En fait il y a des endroits ou cela apparait, d'autres ou il n'y a pas d'aide, d'autres ou les aides sont là en permanence, d'autres ou c'est un autre système.
Cohérence...

[pmleconte]

bonjour,
et le contenu qui doit etre affiché, on le met ou?

voir https://user-images.githubuserconten...ce2fe5d857.png

C'est le texte sous les edits.

Le débat sur github concernait la taille de la description qui, par moments, augmente le nombre d'informations affichées de façon significative.

D'où la suppression des descriptions dans les fichiers xml par les développeurs....

Cependant, les noms de certains paramètres ne sont pas vraiment parlant et un peu d'aide serait utile.

Pascal

[pmleconte]

En fait il y a des endroits ou cela apparait, d'autres ou il n'y a pas d'aide, d'autres ou les aides sont là en permanence, d'autres ou c'est un autre système.
Cohérence...

Il y a 2 systèmes : l'aide en ligne (qui s'affiche dans une popup) et l'affichage des descriptions (sous les champs à renseigner).

Pour "l'aide en ligne", au niveau des modules, par exemple dans mod_banners.xml, on a une ligne

<help key="Site_Modules:_Banners" />

S'il a cette ligne, le bouton "?aide" est affiché. Sinon, il est caché.

Les descriptions seront désormais affichés de base (version 4.1.5) si le bouton "afficher/cacher l'aide" est absent voir https://github.com/joomla/joomla-cms/pull/37849

Pascal