Cette action a été créée pour générer le dossier technique d'un site.
Elle liste sous forme condensée et paramétrable les extensions installées.
{up jextensions-list=prefset ou type(s)}
MOTS-CLES:
##id## ##client## ##type## ##name-link## ##name## ##author## ##version## ##note## ##folder## ##state##
- jextensions_list = component,module,plugin: nom d'un prefset ou un des types suivants : component,module,plugin
- type-exclude: 1= tous les types sauf ceux passés en paramètre principal
- client: 0=site, 1=admin, 2=tous
- minimal-id = 10000: pour exclure les composants du core Joomla 3.0
- author-exclude = Joomla! Project: pour exclure les composants du core Joomla 4.0
- actif-only: 1 pour lister les extensions dépubliées
- sort = type,folder,name: tri
Modèle de présentation
- template (item-template) = ##state####name##[small] ##client## ##type## ##folder## ##version## (id:##id##) ##author## [/small] ##note##: modèle de mise en page. keywords+bbcode
Balise et style du bloc principal
- main-tag (block) = ul: Balise pour bloc principal
- style: classes et styles
- id: identifiant
Balise pour les lignes
- item-tag = li: Balise pour blocs lignes
Format pour les mots-clés
- model-folder = %s: présentation pour ##folder##
- model-version = vers:%s: présentation pour ##version##
- model-note = [i class="t-blue"]%s[/i]: présentation pour ##note##
- state-list = [b style="color:red"]✕ [/b]: liste de choix : inactif, actif 🔴
Style CSS
- css-head (base-css): style ajouté dans le HEAD de la page
- Version 2.7
- ajout option 'author-exclude' pour J4
{up jextensions-list}
Sans autre précision, ce shortcode va afficher toutes les extensions en frontend.
Mais comme la majorité des composants sont vus comme backend, je vous conseille de procéder en 2 étapes.
<h4 class="notoc">Les composants</h4>
{up jextensions-list=component
| client=2
| template=##name## <small>##version## (id:##id##) ##author## </small> ##note##
| sort=name}
<h4 class="notoc">Les modules et plugins</h4>
{up jextensions-list=module,plugin
| client=0
| template=<small>##type####folder##</small> ##name## <small>##version## (id:##id##) ##author## </small> ##note##
| sort=type,folder,name | debug}
Dans la pratique, utilisez les jeux d'options que vous trouverez dans custom/prefs.ini.dist
. Supprimez le ".dist" final pour l'utiliser. Ce qui nous donne :
<h4 class="notoc">Les composants</h4>
{up jextensions-list=composant}
<h4 class="notoc">Les modules côté site</h4>
{up jextensions-list=module-site}
<h4 class="notoc">Les plugins</h4>
{up jextensions-list=plugin}
Personnellement, je préfère séparer les modules et les plugins. Voici le résultat pour les extensions utilisées sur ce site :
Les composants
- CG Isotope vers:4.2.1 (id:10102) ConseilGouz Pour la page DEMO. Filtrage dynamique des actions
- FlexiContactPlus vers:19.03.02 (id:10088) Les Arbres Design Formulaire de contact
- JCE vers:2.9.52 (id:10116) Ryan Demmer Editeur wysiwyg
- JMP Import Export vers:1.0.0 (id:10238) JoomHelper
Les modules côté site
- GTranslate vers:4.0.3 (id:10109) Edvard Ananyan Traduction dynamique du site
- lmcustom_menu vers:2.0 (id:10236) LOMART
- lmcustom vers:2.7.4 (id:10008) lomart Module personnalisé. Accepte PHP, JS, CSS, ...
- switcheditor vers:2.2.4 (id:10284) ConseilGouz
Les plugins
- editors-xtd lmprism vers:3.0 (id:10010) Lomart Affichage de code avec coloration syntaxique et neutralisation des caractéres ambigüs
- system Admin Order vers:1.3 (id:10026) Lomart Permet de définir et de mémoriser l'ordre de tri des tables
- system scssCompiler vers:2.7 (id:10029) LOMART Compilateur SCSS multi-cible
- content UP vers:5.0.2 (id:10098) LOMART Universal Plugin
- content xbAutoSave vers:3.0.0 (id:10126) Roger C-O Permet la sauvegarde par Ctrl+S avec TinyMCE
- editors-xtd upbtn vers:2 (id:10127) lomart
- system CACHECLEANER vers:8.3.4 (id:10246) Regular Labs (Peter van Westen)
- system REGULARLABS vers:23.4.18579 (id:10255) Regular Labs (Peter van Westen)
- editors-xtd chatgpt vers:1.0.2 (id:10278) Rick Spaan - R2H
En isolant, les extensions "ajoutées", on repère rapidement celles qui ne servent plus.
Le fichier "note"
Vous avez dû remarquer le texte bleu en italique à la fin de la description d'une extension.
Il provient du fichier custom/info.ini qui contient une liste de noms d'extensions comme dans cet exemple :
Akeeba="Sauvegarde du site"
BACKUPONUPDATE = 0 ; non significatif
Le nom de l'extension est celui que cette action affiche. En effet, pour faciliter la lecture, les parties non utiles du nom sont supprimées.
La valeur après le signe égal peut être :
- la description de celle-ci
- 0 pour ne pas la reprendre dans les listes. Très utile pour épurer la liste des modules et plugins 'techniques'
Pour mémoire, dans un fichier INI, les textes après un point-virgule sont des commentaires.
Pour débuter, je vous conseille de renommer le fichier custom/extensions-notes.ini.dist
qui contient la description des extensions courantes.
Les options
- jextensions-list
- Peut contenir le nom du jeu d'options (prefset) ou le(s) type(s) d'extensions.
- type
- 'component,module,plugin' par défaut, les extensions à récupérer. vide = tous
- type_exclude
- 0 par défaut, 1 récupère tous les types sauf ceux passés en paramétre principal
- client
- 0 par défaut, 0=site, 1=admin, 2=tous
- minimal-id
- 10000 par defaut pour exclure les composants de base de Joomla
- actif-only
- 0 par défaut. 1 pour afficher uniquement les extensions actives.
- sort
- 'type,folder,name' par défaut. Il s'agit de l'ordre de tri. Les noms des champs sont les mêmes que les mots-clés pour le template
- main-tag
- main-style
- ul par défaut sans classe, ni style.
- item-tag
- item-style
- li par défaut sans classe, ni style.
- template
[span class="##state##"]##name##[/span][small] ##client## ##type####folder## ##version## (id:##id##) ##author## [/small] ##note##
modèle de mise en page
Les mots-clés :
##name## : le nom de l'extension 'nettoyé'. les parties non significatives sont supprimées
##version## : version de l'extension. voir option model-version
##author## : auteur
##id## : id de l'extension
##client## : site ou admin
##type## : le type de l'extension
##folder## : le dossier d'un plugin. voir option model-folder
##state## : 0=désactivé, 1=activé. voir option state-list pour une présentation visuelle
##note## : la note définie dans le fichier custom/info.ini. voir option model-note- model-folder
- /%s
/%s
modèle utilisé pour afficher le dossier d'un plugin - model-version
vers:%s
modèle utilisé pour afficher la version de l'extension- model-note
[i class="t-bleu"]%s[/i]
si une note existe, elle sera insérée en suivant ce modèle- state-list
- 't-rouge' par défaut, c'est la liste de valeurs pour state. ce pourrait être : non,oui
- css-head
- permet de styler le résultat
Cette action peut vous rendre de grands services pour réaliser une assistance et un suivi de votre site. Consulter : Créer le dossier technique du site
upactionslist (1) readmore (1) csv2def (2) tabslide (1) toc (1) jextensions-list (3) icon (1) modal (1) jcontent-info (1)