Skip to main content

Joomla Integration

XBuilder integrates with Joomla's media system, allowing you to upload, organize, and manage images directly within the popup builder.

Image Management​

XBuilder provides built-in image management integrated with Joomla's media system.

Image Library Features​

FeatureDescription
UploadUpload images directly from the builder
BrowseNavigate Joomla's images folder structure
FoldersCreate and organize folders
DeleteRemove unused images
SearchFind images by name

Supported Image Formats​

FormatExtension
JPEG.jpg, .jpeg
PNG.png
GIF.gif
WebP.webp
SVG.svg
BMP.bmp

Uploading Images​

  1. Add an Image element to your popup
  2. Click the image selector
  3. Click Upload button
  4. Select image(s) from your computer
  5. Images upload to /images folder

Organizing Images​

Create folders to organize your popup images:

  1. Open the image browser
  2. Click New Folder
  3. Enter folder name
  4. Images can be uploaded to specific folders

Recommended folder structure:

/images/
  /popups/
    /newsletters/
    /promotions/
    /announcements/

Image Paths​

Images are stored in Joomla's standard images folder:

/images/[your-folders]/image.jpg

Paths are relative to Joomla root, ensuring portability across environments.

Media Manager Integration​

XBuilder uses Joomla's media capabilities:

Supported Media​

  • Images — Full support with preview
  • Documents — Link to PDFs, documents
  • Videos — Use Video element for video media

Media Permissions​

Image operations respect Joomla ACL:

ActionRequired Permission
UploadCreate media
DeleteDelete media
BrowseAccess media

Configure in System → Global Configuration → Media.

Troubleshooting Integration​

Images Not Loading​

  1. Verify image exists at specified path
  2. Check file permissions
  3. Ensure image format is supported
  4. Clear browser cache

Next Steps​