Date de publication: le mercredi 15 octobre 2008 à 10h06
Dernière modification: par Pascal BOYER le vendredi 2 octobre 2009 à 17h51
« Article précédent: Longueur du champ «Valeur par défaut» de certains datatypes
» Article suivant: Afficher les vignettes
Icônes des classe d'objet
Lorsque l'on crée, à partir de l'interface d'administration de eZ Publish (onglet Administration puis lien Classes dans le menu gauche), une nouvelle classe d'objet, celle-ci se voit affecter une icône par défaut.
Cette icône par défaut sera, d'une part, automatiquement affectée à toutes les nouvelles classes d'objet et, d'autre part, affichée dans le menu Contenus de l'interface d'administration à gauche du nom de chaque instance de ces nouvelles classes.
Comment choisir les icônes devant être affectées à chacune des nouvelles classes créées ?
Le fichier icon.ini
Le fichier de configuration des icônes liées aux classes d'objet est:
share/icons/crystal-admin/icon.ini
:
Il est nécessaire de créer une surcharge icon.ini.append.php de ce fichier que vous placerez dans le répertoire de surcharge globale settings/override/
Pour affecter une nouvelle icône à une nouvelle classe d'objet, il faut renseigner le tableau ClassMap[] de la section [ClassIcons] de ce fichier de surcharge:
<?php /* #ini charset="utf-8"? [ClassIcons] Default=mesIcones/empty.png ClassMap[mon_article]=mimetypes/document.png ClassMap[mes_dossiers]=filesystems/article_actualite.png ClassMap[mes_images]=mesIcones/images.png */ ?>
- Default : définit l'icône à utiliser par défaut pour les nouvelles classes d'objet
- ClassMap : entre-crochets est signifié l'identifiant de la classe d'objet
- Après le signe égal : le chemin relatif de l'icône par rapport au répertoire share/icons/crystal-admin/16x16_indexed/
- mesIcones/ : ce répertoire n'existant pas par défaut il faut le créer sous share/icons/crystal-admin/16x16_indexed/
:
Le menu Contenus de l'interface d'administration utilise les icônes de taille small (voir le tableau Sizes[] de la section [IconSettings] du fichier icon.ini). Les icônes doivent donc être placées dans des sous-répertoires du répertoire 16x16_indexed.
Créer son propre répertoire d'icône
Pour palier à la remarque ci-dessus, il est possible de définir un répertoire spécifique dans lequel l'interface d'administration ira chercher les icônes à afficher.
Pour ce faire, ajouter au répertoire du siteaccess d'administration le fichier de surcharge icon.ini.append.php contenant ceci:
<?php /* #?ini charset="utf-8"? [IconSettings] Theme=crystal-admin <= Nom du répertoire général Size=normal Sizes[normal]=24x24 <= Nom du sous-répertoire du répertoire général [ClassIcons] Default=mimetypes/empty.png ClassMap[ma_classe_1]=filesystems/album.png ClassMap[ma_classe_2]=filesystems/artiste.png ClassMap[ma_classe_3]=mesIcones/cdrw.png ClassMap[ma_classe_4]=filesystems/cam24x24.png */ ?>
Il faudra ensuite créer un répertoire nommé 24x24 dans share/icons/crystal-admin/ puis, sous ce nouveau répertoire, les deux suivants:
- filesystems
- mesIcones
Par défaut, la configuration proposée ci-dessus n'aura aucune effet lorsque vous afficherez la liste des classes (onglet Administration puis lien Classes dans le menu gauche). Dans ce contexte, le système utilise en effet la taille small des icones. Or, les icones utilisées pour cette taille sont placées par défaut dans le répertoire share/icons/crystal-admin/16x16_indexed/. Ce qu'il faut retenir, c'est que les répertoires d'icônes associés aux différentes tailles utilisées par le système sont définis dans le fichier share/icons/crystal-admin/ icon.ini par les 5 lignes ci-dessous:
17 Sizes[] 18 Sizes[normal]=32x32 19 Sizes[small]=16x16_indexed 20 Sizes[ghost]=16x16_ghost 21 Sizes[original]=16x16_original
Partant, il devient nécessaire d'ajouter, par exemple, cette ligne à la configuration proposée:
Sizes[normal]=24x24 Sizes[small]=24x24 <== CETTE LIGNE
De la sorte, les mêmes icônes seront utilisées pour les tailles small et normal, le système allant les rechercher dans le même sous-répertoire 24x24.
Les icônes du menu Contenus
Pour modifier la taille des icônes du menu contenus il faut modifier le paramètre ClassIconsSize de la section [TreeMenu] du fichier de surcharge contentstructuremenu.ini.append.php du siteaccess d'administration.
Par défaut, la valeur small de ce paramètre affiche des icônes de 16x16 pixels placées dans le répertoire:
share/icons/crystal-admin/16x16_indexed/filesystems/
La configuration suivante:
[TreeMenu] ClassIconsSize=normal
...permet d'afficher des icônes de 32x32 pixels placées dans le répertoire:
share/icons/crystal-admin/32x32/filesystems/
Taille 24x24
Pour afficher des icônes de 24x24 pixels dans le menu Contenus il faut modifier dans le fichier de surcharge icon.ini.append.php du siteaccess d'administration le paramètre Sizes[normal] de la section [IconSettings].
Ainsi:
[TreeMenu] Theme=crystal-admin Size=normal Sizes[normal]=24x24
...affichera des icônes placées dans le répertoire:
share/icons/crystal-admin/24x24/filesystems/
Bien sûr, le répertoire 24x24 n'existant pas par défaut, il faut le créer.
Commentaires