Introduction
This plugin extends the Folders Plugin to provide custom icons for folders. You can upload your own images, use predefined icons or use the combined build status of the jobs within a folder as icon.
Changelog
Release notes are recorded in GitHub Releases.
Version 2.x
This version requires Jenkins 2.357 and above in order to support the transition to Java 11.
-
Version 2.6 enables users to select and re-use a already existing
CustomFolderIcon
. Further an icon file will now be deleted automatically if the folder it used is being deleted - unless of course the file is still used by another folder. -
Version 2.5 introduces a new type of icon. The
EmojiFolderIcon
provides unicode emojis as icon. -
Version 2.3 introduces a new type of icon. The
IoniconFolderIcon
provides icons from ionicons-api-plugin. -
Version 2.0 introduces a new type of icon. The
BuildStatusFolderIcon
displays the combined build status of the jobs within a folder. -
Since 1.83 of the job-dsl-plugin the Custom Folder Icons Plugin can be used in Job DSL configurations.
Version 1.x
Legacy version for Jenkins versions before 2.357.
-
Since 2.1044 of the branch-api-plugin the Custom Folder Icons Plugin can be used for Multi-Branch or Organization Projects.
Configuration
Folder Configuration
There are multiple types of custom icons provided by this plugin.
Custom Folder Icon
Use your custom icon for a folder.
Select the Custom Folder Icon option and use Browse…
to choose a file.
You can crop the image to the desired result and upload it using the Apply
button.
The file name will be randomized during upload.
You can also select an image from the list of the already available icons.
The file will be deleted automatically if the folder it used is being deleted - unless of course the file is still used by another folder.
Job DSL
Configuration via job-dsl-plugin:
userContent('customFolderIcons/custom.png', streamFileFromWorkspace('custom.png'))
folder('custom') {
icon {
customFolderIcon {
foldericon('custom.png')
}
}
}
Build Status Folder Icon
See the combined build status of the jobs within a folder.
Select the Build Status Folder Icon option to use the combined build status of the jobs within a folder as icon.
Job DSL
Configuration via job-dsl-plugin:
folder('build-status') {
icon {
buildStatusFolderIcon()
}
}
Emoji Folder Icon
Use unicode emojis as icon.
Select the Emoji Folder Icon option and select any of the available emojis.
Job DSL
Configuration via job-dsl-plugin:
folder('emoji') {
icon {
emojiFolderIcon {
emoji('sloth')
}
}
}
Ionicon Folder Icon
Use Ionicons provided by ionicons-api-plugin as icon.
Select the Ionicon Folder Icon option and select any of the available icons.
Job DSL
Configuration via job-dsl-plugin:
folder('ionicon') {
icon {
ioniconFolderIcon {
ionicon('jenkins')
}
}
}