Managing Icons

Managing Icons

Sitecore Icons

  • Visual aid to help Content Authors quickly differentiate items in the Content Tree
    • Primarily, to differentiate item types based on their templates 
    • Secondarily, to differentiate specific individual items
  • Located in <Website Root Folder>\sitecore\shell\Themes\Standard
  • Relative icon paths are relative to the /sitecore/shell/Themes/Standard directory

Additional Icons

  • A set of Vista style icons is provided when you install Sitecore
    • Located in the same folder location as the standard Sitecore icon sets
    • Contained in files with V2 in the file name
  • Additional icons can be found at FAMFAMFAM Link to external site
    • Creative Commons Attribution License applies
    • Free to use and/or modify icons
    • Include a link back to their page in your credits

Icon Overlays

  • Add the overlay query string parameter to specify the overlay icon
    • The icon dimension should be 32x32
    • The icon overlay dimension should be 16x16
  • Example: Applications/32x32/warning.png?overlay=Applications/16x16/help.png
  • Icon overlays are not displayed in the Sitecore Content Tree
    • The icon specified by the overlay query string parameter is displayed

Removing Icons from the Sitecore Icon Library

  • Unzip the file for the icon category of the icon to be removed
  • Delete the unwanted icon files(s)
  • Zip the icon category folder, unless the web.config setting "UseZippedIcons" is set to false
    • Create a nested category folder hierarchy before zipping
    • The zip file requires the category name, such as Applications
    • The top level folder inside the zip file requires the category name
    • Example: Zip /Applications/Applications/16x16, etc., not /Applications/16x16, etc.

Adding Icons to the Sitecore Icon Library

  • Unzip the icon directory where you want to add the icon
  • Create an icon with a transparent background or use a square image
  • Add your icon to the subfolders under the appropriate icon category folder
    • 16x16
    • 24x24
    • 32x32
    • 48x48
    • 128x128
  • Zip the icon category folder, unless the web.config setting "UseZippedIcons" is set to false
    • Create a nested category folder hierarchy before zipping
    • The zip file requires the category name, such as Applications
    • The top level folder inside the zip file requires the category name
    • Example: Zip /Applications/Applications/16x16, etc., not /Applications/16x16, etc.

Guidelines for Adding Icons to Sitecore

  • Add icons to the standard Sitecore categories instead of creating new categories
  • Add 16x16 and 32x32 sized icons to the appropriate folders for each icon to be added
    • Sitecore displays the 32x32 version of icons in the icon browser window in the Content Editor
    • Sitecore displays the 16x16 version of an icon in the Content Tree
    • Sitecore displays the path of the icon as 32x32 in the icon field in the Appearance section of the Standard Fields
    • The icon will not render in the Content Tree if the 32x32 image is missing or if the image in the 32x32 folder is not 32x32
    • There is no requirement that the 16x16 and 32x32 images for the icon must be the same, but it makes sense to do this
-

Sources