Custom Icon implementation using ionicons-api-plugin

.github/workflows/codecov.yml

@@ -9,7 +9,7 @@ on:
 jobs:
   coverage:
 
-    runs-on: [ubuntu-latest]
+    runs-on: [ ubuntu-latest ]
     name: Coverage on Ubuntu
 
     steps:

.github/workflows/codeql-analysis.yml

@@ -2,9 +2,9 @@ name: "Code Scanning - Action"
 
 on:
   push:
-    branches: [master]
+    branches: [ master ]
   pull_request:
-    branches: [master]
+    branches: [ master ]
 
 jobs:
   CodeQL-Build:
@@ -20,7 +20,7 @@ jobs:
         uses: github/codeql-action/init@v2
         # Override language selection by uncommenting this and choosing your languages
         with:
-           languages: java
+          languages: java
 
       # Autobuild attempts to build any compiled languages (C/C++, C#, or Java).
       # If this step fails, then you should remove it and run the build manually (see below).

.github/workflows/update-license-year.yml

@@ -3,7 +3,7 @@ name: Update Copyright Year
 on:
   schedule:
     - cron: "0 3 1 1 *" # 03:00 AM on January 1
-    
+
 jobs:
   license:
     runs-on: ubuntu-latest

.mvn/extensions.xml

@@ -1,7 +1,8 @@
-<extensions xmlns="http://maven.apache.org/EXTENSIONS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/EXTENSIONS/1.0.0 http://maven.apache.org/xsd/core-extensions-1.0.0.xsd">
-  <extension>
-    <groupId>io.jenkins.tools.incrementals</groupId>
-    <artifactId>git-changelist-maven-extension</artifactId>
-    <version>1.4</version>
-  </extension>
+<extensions xmlns="http://maven.apache.org/EXTENSIONS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://maven.apache.org/EXTENSIONS/1.0.0 http://maven.apache.org/xsd/core-extensions-1.0.0.xsd">
+    <extension>
+        <groupId>io.jenkins.tools.incrementals</groupId>
+        <artifactId>git-changelist-maven-extension</artifactId>
+        <version>1.4</version>
+    </extension>
 </extensions>

README.adoc

@@ -14,7 +14,7 @@ image:https://img.shields.io/github/release/jenkinsci/custom-folder-icon-plugin.
 [#introduction]
 == Introduction
 This plugin extends the link:https://github.com/jenkinsci/cloudbees-folder-plugin[Folders Plugin] to to provide custom icons for folders.
-You can upload your own images or use the combined build status of the jobs within a folder as icon.
+You can upload your own images, use predefined icons or use the combined build status of the jobs within a folder as icon.
 
 toc::[]
 
@@ -25,10 +25,13 @@ Release notes are recorded in https://github.com/jenkinsci/custom-folder-icon-pl
 === Version 2.x
 This version requires Jenkins 2.357 and above in order to support the transition to https://www.jenkins.io/blog/2022/06/28/require-java-11/[Java 11].
 
-Version 2.x introduces a new type of icon. The `BuildStatusFolderIcon` displays the combined build status of the jobs within a folder.
+* Version 2.3 introduces a new type of icon. The `IoniconFolderIcon` provides icons from https://github.com/jenkinsci/ionicons-api-plugin[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.
 
 === Version 1.x
-Since https://github.com/jenkinsci/branch-api-plugin/releases/tag/2.1044.v2c007e51b_87f[2.1044] of the https://github.com/jenkinsci/branch-api-plugin[branch-api-plugin] the Custom Folder Icons Plugin can be used for Multi-Branch or Organization Projects.
+Legacy version for Jenkins versions before 2.357.
+
+* Since https://github.com/jenkinsci/branch-api-plugin/releases/tag/2.1044.v2c007e51b_87f[2.1044] of the https://github.com/jenkinsci/branch-api-plugin[branch-api-plugin] the Custom Folder Icons Plugin can be used for Multi-Branch or Organization Projects.
 
 [#configuration]
 == Configuration
@@ -61,6 +64,14 @@ Select the Build Status Folder Icon option to use the combined build status of t
 
 image:images/build-status-folder-icon-configuration.png[]
 
+==== Ionicon Folder Icon
+Use https://ionic.io/ionicons[Ionicons] provided by https://github.com/jenkinsci/ionicons-api-plugin[ionicons-api-plugin] as icon.
+image:images/ionicon-folder-icon.png[]
+
+Select the Ionicon Folder Icon option and select any of the available icons.
+
+image:images/ionicon-folder-icon-configuration.png[]
+
 [#global-configuration]
 === Global Configuration
 Check for unused custom folder icon files and delete them.

pom.xml

@@ -1,91 +1,97 @@
 <?xml version="1.0" encoding="utf-8"?>
-<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
-	<modelVersion>4.0.0</modelVersion>
-	<parent>
-		<groupId>org.jenkins-ci.plugins</groupId>
-		<artifactId>plugin</artifactId>
-		<version>4.47</version>
-		<relativePath />
-	</parent>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+        <groupId>org.jenkins-ci.plugins</groupId>
+        <artifactId>plugin</artifactId>
+        <version>4.47</version>
+        <relativePath/>
+    </parent>
 
-	<groupId>io.jenkins.plugins</groupId>
-	<artifactId>custom-folder-icon</artifactId>
-	<version>${revision}${changelist}</version>
-	<packaging>hpi</packaging>
+    <groupId>io.jenkins.plugins</groupId>
+    <artifactId>custom-folder-icon</artifactId>
+    <version>${revision}${changelist}</version>
+    <packaging>hpi</packaging>
 
-	<name>Custom Folder Icon Plugin</name>
-	<description>Customize Jenkins Folder Icons</description>
+    <name>Custom Folder Icon Plugin</name>
+    <description>Customize Jenkins Folder Icons</description>
 
-	<licenses>
-		<license>
-			<name>MIT License</name>
-			<url>http://www.opensource.org/licenses/mit-license.php</url>
-			<distribution>repo</distribution>
-		</license>
-	</licenses>
+    <licenses>
+        <license>
+            <name>MIT License</name>
+            <url>https://www.opensource.org/licenses/mit-license.php</url>
+            <distribution>repo</distribution>
+        </license>
+    </licenses>
 
-	<developers>
-		<developer>
-			<id>strangelookingnerd</id>
-			<name>Daniel Krämer</name>
-			<email>daniel-kraemer@gmx.net</email>
-		</developer>
-	</developers>
+    <developers>
+        <developer>
+            <id>strangelookingnerd</id>
+            <name>Daniel Krämer</name>
+            <email>daniel-kraemer@gmx.net</email>
+        </developer>
+    </developers>
 
-	<scm>
-		<connection>scm:git:git://github.com/${gitHubRepo}.git</connection>
-		<developerConnection>scm:git:git@github.com:${gitHubRepo}.git</developerConnection>
-		<url>https://github.com/${gitHubRepo}</url>
-		<tag>${scmTag}</tag>
-	</scm>
+    <scm>
+        <connection>scm:git:git://github.com/${gitHubRepo}.git</connection>
+        <developerConnection>scm:git:git@github.com:${gitHubRepo}.git</developerConnection>
+        <url>https://github.com/${gitHubRepo}</url>
+        <tag>${scmTag}</tag>
+    </scm>
 
-	<properties>
-		<gitHubRepo>jenkinsci/custom-folder-icon-plugin</gitHubRepo>
-		<jenkins.version>2.359</jenkins.version>
-		<revision>2.3</revision>
-		<changelist>-SNAPSHOT</changelist>
-	</properties>
+    <properties>
+        <gitHubRepo>jenkinsci/custom-folder-icon-plugin</gitHubRepo>
+        <jenkins.version>2.361.1</jenkins.version>
+        <revision>2.3</revision>
+        <changelist>-SNAPSHOT</changelist>
+    </properties>
 
-	<dependencies>
-		<dependency>
-			<groupId>org.jenkins-ci.plugins</groupId>
-			<artifactId>cloudbees-folder</artifactId>
-			<version>6.758.vfd75d09eea_a_1</version>
-		</dependency>
-		<dependency>
-			<groupId>org.jenkins-ci.plugins</groupId>
-			<artifactId>branch-api</artifactId>
-			<version>2.1046.v0ca_37783ecc5</version>
-			<scope>test</scope>
-		</dependency>
-		<dependency>
-			<groupId>org.mockito</groupId>
-			<artifactId>mockito-core</artifactId>
-			<scope>test</scope>
-		</dependency>
-		<dependency>
-			<groupId>org.mockito</groupId>
-			<artifactId>mockito-inline</artifactId>
-			<scope>test</scope>
-		</dependency>
-		<dependency>
-			<groupId>org.apache.httpcomponents</groupId>
-			<artifactId>httpmime</artifactId>
-			<version>4.5.13</version>
-			<scope>test</scope>
-		</dependency>
-	</dependencies>
+    <dependencies>
+        <dependency>
+            <groupId>org.jenkins-ci.plugins</groupId>
+            <artifactId>cloudbees-folder</artifactId>
+            <version>6.758.vfd75d09eea_a_1</version>
+        </dependency>
+        <dependency>
+            <groupId>io.jenkins.plugins</groupId>
+            <artifactId>ionicons-api</artifactId>
+            <version>28.va_f3a_84439e5f</version>
+        </dependency>
+        <dependency>
+            <groupId>org.jenkins-ci.plugins</groupId>
+            <artifactId>branch-api</artifactId>
+            <version>2.1046.v0ca_37783ecc5</version>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.mockito</groupId>
+            <artifactId>mockito-core</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.mockito</groupId>
+            <artifactId>mockito-inline</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.httpcomponents</groupId>
+            <artifactId>httpmime</artifactId>
+            <version>4.5.13</version>
+            <scope>test</scope>
+        </dependency>
+    </dependencies>
 
-	<repositories>
-		<repository>
-			<id>repo.jenkins-ci.org</id>
-			<url>https://repo.jenkins-ci.org/public/</url>
-		</repository>
-	</repositories>
-	<pluginRepositories>
-		<pluginRepository>
-			<id>repo.jenkins-ci.org</id>
-			<url>https://repo.jenkins-ci.org/public/</url>
-		</pluginRepository>
-	</pluginRepositories>
+    <repositories>
+        <repository>
+            <id>repo.jenkins-ci.org</id>
+            <url>https://repo.jenkins-ci.org/public/</url>
+        </repository>
+    </repositories>
+    <pluginRepositories>
+        <pluginRepository>
+            <id>repo.jenkins-ci.org</id>
+            <url>https://repo.jenkins-ci.org/public/</url>
+        </pluginRepository>
+    </pluginRepositories>
 </project>