[BUG]: JCB Packager: Icon linked to a ComponentCustomAdminMenu is not packaged with the Custom Admin Menu #1271

New Issue

Closed

opened 2025-12-03 14:22:05 +00:00 by Lemuel · 0 comments

Lemuel commented

2025-12-03 14:22:05 +00:00

Owner

What Happened?

When building and packaging a Joomla component using JCB that includes a custom admin menu with an icon linked from Joomla's /images folder, the selected icon is not included in the generated package.

As a result, when the packaged component is initialized on another Joomla system, the custom admin menu item is created but the icon is missing, even though it was correctly linked and displayed on the source system before packaging.

The packaging engine does not detect, copy, or embed externally linked image files that are referenced by custom admin menu items.

Steps to reproduce the Bug

In JCB, create or edit a component.
Add a Custom Admin Menu item.
Configure its icon by selecting an image from Joomla's /images directory.
Build the component using the JCB packaging engine.
Initialize the generated package on a different Joomla system.
Observe that the menu item exists, but the icon is missing.

Which Joomla version are you compiling in?

v5.4.1

Which PHP version are you compiling in?

v8.3

Which Joomla versions are you targeting?

v5.4.1

Which PHP version are you targeting?

v8.3

Which Web server is JCB running on?

Apache Latest

Which Relational Database is JCB running on?

MariaDB Latest

Which OS is JCB running on?

Ubuntu 24.04 LTS

Which JCB version are you using?

v5.1.4-alpha6

Where in JCB did this issue occur?

Joomla Components(admin_views)

On which browsers did you encounter the issue?

Firefox

Additional Comments

We are actively working on addressing this issue.

A fix is already in progress and will be included in the next JCB release, ensuring that externally linked icons (e.g. from the /images directory) are correctly detected and shipped during component packaging.

### What Happened? When building and packaging a Joomla component using JCB that includes a **custom admin menu with an icon linked from Joomla's `/images` folder**, the selected icon is not included in the generated package. As a result, when the packaged component is initialized on another Joomla system, the custom admin menu item is created but **the icon is missing**, even though it was correctly linked and displayed on the source system before packaging. The packaging engine does not detect, copy, or embed externally linked image files that are referenced by custom admin menu items. ### Steps to reproduce the Bug 1. In JCB, create or edit a component. 2. Add a **Custom Admin Menu** item. 3. Configure its icon by selecting an image from Joomla's `/images` directory. 4. Build the component using the JCB packaging engine. 5. Initialize the generated package on a different Joomla system. 6. Observe that the menu item exists, but the **icon is missing**. ### Which Joomla version are you compiling in? v5.4.1 ### Which PHP version are you compiling in? v8.3 ### Which Joomla versions are you targeting? v5.4.1 ### Which PHP version are you targeting? v8.3 ### Which Web server is JCB running on? Apache Latest ### Which Relational Database is JCB running on? MariaDB Latest ### Which OS is JCB running on? Ubuntu 24.04 LTS ### Which JCB version are you using? v5.1.4-alpha6 ### Where in JCB did this issue occur? Joomla Components(admin_views) ### On which browsers did you encounter the issue? Firefox ### Additional Comments We are actively working on addressing this issue. A fix is already in progress and will be included in the **next JCB release**, ensuring that externally linked icons (e.g. from the `/images` directory) are correctly detected and shipped during component packaging.