Kernkraft

Custom Icons in Sitecore 9

Geschrieben von Anna Bründel veröffentlich am in der Kategorie Sitecore

Wie bereits im Beitrag von Bastian herausgestellt, ist die Wahl von Icons essentiell beim Arbeiten mit Sitecore als Redakteur. Doch was tun, wenn die Icons, die Sitecore out of the box liefert nicht reichen?

Wie können wir Devs dem Editor dennoch das Leben erleichtern? Man kann in Sitecore eigene Icons hinzufügen!

Custom Icons erstellen

Zunächst erstellen wir die png-Files, die als Icons verwendet werden in den verschiedenen notwendigen Größen. Diese packen wir dann in einen zip-Ordner und legen diesen entsprechend in Sitecore ab unter

/sitecore/shell/Themes/Standard

.

 

ZIP Ordner für Sitecore Custom Icons

 

 

Die Bilder sollten im Idealfall in den folgenden Größen vorliegen: 

ZIP Ordner mit Bildgrößen für Sitecore Custom Icons

 

Icons einbinden

Um die Icons einbinden zu können und in unserem Fall die neue Kategorie „MyCustomIcons“ im Icon-Auswahlfenster anzeigen zu können, muss die Datei Set Icon.xml überschrieben werden. 
Dafür kopieren wir die Datei zunächst aus
/sitecore/shell/Applications/Content Manager/Dialogs/Set Icon
nach
/sitecore/shell/Override
 

Set Icon XML für Sitecore Custom Icons

 

Im nächsten Schritt passen wir die XML-Datei für unsere Zwecke an. 

Um unsere definierte Kategorie „MyCustomIcons“ zu rendern, müssen wir ein ListItem und die dazugehörige Scrollbox hinzufügen: 

 

ListItem in XML für Sitecore Custom Icons

 

XML bearbeiten für Custom Icons für Sitecore

 

Set Icon - Der Code

Wir haben eine Klasse SetCustomIconForm.cs definiert, die von der Sitecore Klasse SetIconForrm erbt. Leider ist die Funktion zum Rendern der Custom Icons privat, sodass wir diese Funktion und alle anderen damit zusammenhängenden aus dem Sitecore Original kopieren mussten. 

Um aber direkt sehen zu können, was wir verändert haben, abstrahierten wir den Aufruf der Funktion und erweiterten ihn um unsere Kategorie „MyCustomIcons“. 

 

MyCustomIcons

 

Code Beside hinterlegen

Der letzte Schritt bevor der Editor die Custom Icons verwenden kann besteht darin, unsere erstellte Klasse als CodeBeside in der Set Icon-Datei zu hinterlegen: 

 

Sitecore Custom Icons Code Beside

 

Und nun können wir die Icons in Sitecore verwenden: 

myCustom Icons in Sitecore wiederfinden

 

Beispiel eines Custom Icons für Sitecore 9

 

Das war's, mehr muss nicht getan werden. 

Viel Spaß mit den Custom Icons für eure Redakteure!