Component: com_sppagebuilder — Media Manager Type: Bug Severity: Medium (workflow disruption) Environment: Joomla 6, SP Page Builder (latest), PHP 8.x

Summary

AVIF image files uploaded via the SP Page Builder Media Manager appear in the "All Items" view but are not displayed when browsing folders. This makes it very difficult to locate AVIF files that have been organized into folders.

Steps to reproduce

1. Open the SP Page Builder editor and launch the Media Manager.
2. Upload an .avif image (upload succeeds — AVIF is in the accepted formats list).
3. Confirm the file appears under All Items.
4. Navigate to the folder the file was uploaded into via the Folders tree.
5. Observe: the AVIF file is not listed, even though it exists on disk in that folder.

Expected behavior

AVIF files should appear in folder browsing view, consistent with the "All Items" view and with the fact that AVIF is an accepted upload format.

Actual behavior

AVIF files are filtered out of the folder view and cannot be found when browsing by folder.

Root cause

The Media Manager has two separate data paths:

• "All Items" reads from the #__spmedia database table (getItems()). AVIF rows are inserted on upload, so they appear here.
• Folder browsing scans the filesystem with Joomla\CMS\Filesystem\Folder::files() and a regex extension filter. That filter does not include .avif, so AVIF files are filtered out.

The upload code in three locations correctly lists AVIF as an accepted image format:

• administrator/components/com_sppagebuilder/editor/traits/Media.php (uploadMedia(), line ~187)
• components/com_sppagebuilder/controllers/media.php (upload_media(), line ~360)
• components/com_sppagebuilder/helpers/ajax.php (line ~795)

But the folder-browsing getFolders() methods do not include .avif in their Folder::files() filter:

• administrator/components/com_sppagebuilder/models/media.php (line ~378):

  $items = Folder::files($directory, '.png|.jpg|.jpeg|.gif|.svg|.pdf|.webp', false, true);

• components/com_sppagebuilder/models/media.php (line ~372):

  $items = Folder::files($directory, '.png|.jpg|.jpeg|.gif|.svg|.pdf|.webp|.srt|.vtt', false, true);

Suggested fix

Add .avif to the filter regex in both getFolders() methods:

• administrator/components/com_sppagebuilder/models/media.php:

  $items = Folder::files($directory, '.png|.jpg|.jpeg|.gif|.svg|.pdf|.webp|.avif', false, true);

• components/com_sppagebuilder/models/media.php:

  $items = Folder::files($directory, '.png|.jpg|.jpeg|.gif|.svg|.pdf|.webp|.avif|.srt|.vtt', false, true);

Additional observations

1. Other accepted formats are also missing from the folder filter

The folder filter is missing every video, audio, and most attachment extensions that are accepted during upload:

• Video: mp4, mov, wmv, avi, mpg, ogv, 3gp, 3g2
• Audio: mp3, m4a, ogg, wav
• Attachment: doc, docx, key, ppt, pptx, pps, ppsx, odt, xls, xlsx, zip, json

Only pdf, srt, and vtt from the attachment list are present (and only in the frontend model). For consistency, the folder filter should include every extension that the upload code accepts. Otherwise users will hit the same "uploaded but invisible in folder view" problem for any of these types.

2. AVIF thumbnails are not generated during upload

Independently of the folder-view bug, AVIF thumbnail generation is explicitly skipped in all three upload code paths via an else if ($ext !== 'avif') guard around the SppagebuilderHelperImage thumbnail-creation block. As a result, AVIF rows in #__spmedia have an empty thumb column and empty media_attr. Even after the folder-view fix is applied, AVIF items may render without a proper thumbnail in the grid.

We understand this is likely because SppagebuilderHelperImage relies on GD, and GD AVIF support (IMG_AVIF / imageavif()) is not universally available. Possible improvements:

• Detect AVIF support at runtime via function_exists('imageavif') and gd_info(), and only skip thumbnail generation when support is absent.
• Fall back to Imagick when GD lacks AVIF support (Imagick generally supports AVIF via libheif).
• At minimum, set thumb to the original src for AVIF files so the grid shows the full-size image as its own thumbnail (as is already done for SVG and for small images), instead of leaving thumb empty.

Workaround applied locally

We have patched both getFolders() methods on our site to add .avif to the filter regex. This patch must be re-applied after every SP Page Builder update until the fix is released upstream.