From bfefa0efd38f60972751cfc046749ccb2361bc51 Mon Sep 17 00:00:00 2001
From: Dimitrios Pantazis <dpanta94@gmail.com>
Date: Thu, 22 May 2025 13:58:55 +0300
Subject: [PATCH 1/4] Allow filtering of group path

---
 src/Assets/Config.php | 22 +++++++++++++++++-----
 1 file changed, 17 insertions(+), 5 deletions(-)

diff --git a/src/Assets/Config.php b/src/Assets/Config.php
index d1260d7..37c54c8 100644
--- a/src/Assets/Config.php
+++ b/src/Assets/Config.php
@@ -96,11 +96,23 @@ public static function is_group_path_using_asset_directory_prefix( string $group
 	 * @return void
 	 */
 	public static function add_group_path( string $group_path_slug, string $root, string $relative, bool $is_using_asset_directory_prefix = false ): void {
-		static::$group_paths[ $group_path_slug ] = [
-			'root'     => self::normalize_path( $root ),
-			'relative' => trailingslashit( $relative ),
-			'prefix'   => $is_using_asset_directory_prefix,
-		];
+		/**
+		 * Allows for the group path to be filtered.
+		 *
+		 * @since 1.4.3
+		 *
+		 * @param array  $group_path The group path data.
+		 * @param string $group_path_slug The slug of the group path.
+		 */
+		static::$group_paths[ $group_path_slug ] = apply_filters(
+			'stellarwp/assets/group_path',
+			[
+				'root'     => self::normalize_path( $root ),
+				'relative' => trailingslashit( $relative ),
+				'prefix'   => $is_using_asset_directory_prefix,
+			],
+			$group_path_slug
+		);
 	}
 
 	/**

From 0193371ad098f932a91f5e660543a86cd9ed2c9a Mon Sep 17 00:00:00 2001
From: Dimitrios Pantazis <dpanta94@gmail.com>
Date: Thu, 22 May 2025 14:00:40 +0300
Subject: [PATCH 2/4] Version bump

---
 assets.php            | 2 +-
 src/Assets/Config.php | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/assets.php b/assets.php
index 9f44b40..38ac71f 100644
--- a/assets.php
+++ b/assets.php
@@ -2,7 +2,7 @@
 /**
  * Plugin Name: Assets
  * Description: Asset library with a plugin bootstrap file for automated testing.
- * Version: 1.4.8
+ * Version: 1.4.9
  * Author: StellarWP
  * Author URI: https://stellarwp.com
  */
diff --git a/src/Assets/Config.php b/src/Assets/Config.php
index 37c54c8..3402c0e 100644
--- a/src/Assets/Config.php
+++ b/src/Assets/Config.php
@@ -99,7 +99,7 @@ public static function add_group_path( string $group_path_slug, string $root, st
 		/**
 		 * Allows for the group path to be filtered.
 		 *
-		 * @since 1.4.3
+		 * @since 1.4.9
 		 *
 		 * @param array  $group_path The group path data.
 		 * @param string $group_path_slug The slug of the group path.

From 0bea79bf58608241067ab8342f5046632b74aaa1 Mon Sep 17 00:00:00 2001
From: Dimitrios Pantazis <dpanta94@gmail.com>
Date: Thu, 22 May 2025 14:17:51 +0300
Subject: [PATCH 3/4] align comment correctly

---
 src/Assets/Config.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Assets/Config.php b/src/Assets/Config.php
index 3402c0e..21a2b34 100644
--- a/src/Assets/Config.php
+++ b/src/Assets/Config.php
@@ -101,7 +101,7 @@ public static function add_group_path( string $group_path_slug, string $root, st
 		 *
 		 * @since 1.4.9
 		 *
-		 * @param array  $group_path The group path data.
+		 * @param array  $group_path      The group path data.
 		 * @param string $group_path_slug The slug of the group path.
 		 */
 		static::$group_paths[ $group_path_slug ] = apply_filters(

From c65ccba4fa3918e72fd09b4939318f7802946c39 Mon Sep 17 00:00:00 2001
From: Dimitrios Pantazis <dpanta94@gmail.com>
Date: Thu, 22 May 2025 15:10:06 +0300
Subject: [PATCH 4/4] explanation message for the added filter

---
 src/Assets/Config.php | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/Assets/Config.php b/src/Assets/Config.php
index 21a2b34..6279f90 100644
--- a/src/Assets/Config.php
+++ b/src/Assets/Config.php
@@ -99,6 +99,11 @@ public static function add_group_path( string $group_path_slug, string $root, st
 		/**
 		 * Allows for the group path to be filtered.
 		 *
+		 * This filters allows plugins/themes using the library to modify the root path
+		 * to follow symlinks. The library itself can't handle this on its own,
+		 * because it's not possible to be aware of where the library is placed relative
+		 * to the actual WordPress plugins or themes directories.
+		 *
 		 * @since 1.4.9
 		 *
 		 * @param array  $group_path      The group path data.