feat(menu): add icon support

Author: szaleq

config/acf/group_5f280ab299565.json

@@ -0,0 +1,52 @@
+{
+    "key": "group_5f280ab299565",
+    "title": "Menu",
+    "fields": [
+        {
+            "key": "field_5f280ac5af076",
+            "label": "Icon",
+            "name": "icon",
+            "aria-label": "",
+            "type": "image",
+            "instructions": "",
+            "required": 0,
+            "conditional_logic": 0,
+            "wrapper": {
+                "width": "",
+                "class": "",
+                "id": ""
+            },
+            "return_format": "id",
+            "library": "all",
+            "min_width": "",
+            "min_height": "",
+            "min_size": "",
+            "max_width": "",
+            "max_height": "",
+            "max_size": "",
+            "mime_types": "svg",
+            "allow_in_bindings": 0,
+            "preview_size": "medium"
+        }
+    ],
+    "location": [
+        [
+            {
+                "param": "nav_menu_item",
+                "operator": "==",
+                "value": "all"
+            }
+        ]
+    ],
+    "menu_order": 0,
+    "position": "normal",
+    "style": "default",
+    "label_placement": "left",
+    "instruction_placement": "label",
+    "hide_on_screen": "",
+    "active": true,
+    "description": "",
+    "show_in_rest": 0,
+    "inner_blocks": 0,
+    "modified": 1750950886
+}

config/app.php

@@ -53,6 +53,7 @@
         BlockSpacing\BlockSpacingHooks::class,
 
         // Menu
+        Menu\MenuHooks::class,
         Menu\MenuRegistrar::class,
 
         // Post Type

src/classes/Common/Menu/MenuHooks.php

@@ -0,0 +1,55 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DoWStarterTheme\Common\Menu;
+
+use KepnerTregoe\Common\Contracts\Hookable;
+use KepnerTregoe\Common\Helpers\SVG;
+use KepnerTregoe\Deps\Illuminate\Support\Collection;
+use WP_Post;
+
+/**
+ * Menu class
+ */
+class MenuHooks implements Hookable
+{
+   /**
+     * Class constructor.
+     *
+     * @param SVG $svg SVG helper instance.
+     */
+    public function __construct(
+        private SVG $svg,
+    ) {
+    }
+
+    /**
+	 * Adds icons to menu items.
+	 *
+	 * @filter wp_nav_menu_objects
+	 *
+	 * @param WP_Post[]            $items Menu items.
+	 * @param array<string, mixed> $args  object of wp_nav_menu() arguments.
+	 * @return WP_Post[] customized menu items with icons.
+	 */
+	public function addIcons(array $items) {
+        return Collection::make($items)
+            ->map(function (WP_Post $item) {
+                $icon = get_field('icon', $item);
+
+                if (!is_numeric($icon)) {
+                    return $item;
+                }
+
+                $item->title = sprintf(
+                    '%s%s',
+                    $this->svg->getAttachment($icon),
+                    $item->title
+                );
+
+                return $item;
+            })
+            ->all();
+	}
+}