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

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

*/ ?>

1. Default : définit l'icône à utiliser par défaut pour les nouvelles classes d'objet
2. ClassMap : entre-crochets est signifié l'identifiant de la classe d'objet
3. Après le signe égal : le chemin relatif de l'icône par rapport au répertoire share/icons/crystal-admin/16x16_indexed/
4. mesIcones/ : ce répertoire n'existant pas par défaut il faut le créer sous share/icons/crystal-admin/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