Skip to main content

Installation Guide

This guide walks you through downloading and installing the XBuilder Popup extension on your Joomla website.

Downloading the Extension​

Purchase and Download​

  1. Purchase XBuilder Popup from https://joomlax.com/xbuilder-popup.html
  2. After purchase, you'll receive a download link in your email or you can also download it from the store.
  3. Download the package file: XBuilderPopup_UNZIP.zip

Package Contents​

After unzipping XBuilderPopup_UNZIP.zip, you'll find: Package Files

FileDescription
pkg_xbuilder.zipMain installation package (use this for installation)
ReadMe.txtVersion information and release notes
Important

Do not extract pkg_xbuilder.zip. Upload this file directly to Joomla.

Installing the Package​

Package Files

  1. Log in to your Joomla administrator panel
  2. Navigate to System → Install → Extensions
  3. Click on the Upload Package File tab
  4. Either:
    • Drag and drop pkg_xbuilder.zip onto the upload area, or
    • Click Or browse for file and select pkg_xbuilder.zip
  5. Click Upload & Install

Method 2: Install from Folder​

If you have FTP access:

  1. Extract pkg_xbuilder.zip to your local computer
  2. Upload the extracted folder to /tmp on your server via FTP
  3. In Joomla admin, go to System → Install → Extensions
  4. Click the Install from Folder tab
  5. Enter the path: /tmp/pkg_xbuilder
  6. Click Install

What Gets Installed​

The package automatically installs both required components:

Component: com_xbuilder​

  • Location: administrator/components/com_xbuilder
  • Media files: media/com_xbuilder
  • Purpose: Popup builder and management interface

Module: mod_xbuilder_popup​

  • Location: modules/mod_xbuilder_popup
  • Purpose: Frontend popup display

Verifying Installation​

After installation, verify both components are properly installed:

Check Extensions Manager​

  1. Navigate to Extensions → Manage → Manage
  2. Search for "xbuilder"
  3. You should see:
    • XBuilder (Component) - Enabled
    • XBuilder Popup (Module) - Enabled

Package Files

Check Component Access​

  1. Go to Components menu
  2. You should see XBuilder in the list
  3. Click XBuilder → Popups
  4. The popup list should load (initially empty)

Check Module Availability​

  1. Navigate to Content → Site Modules
  2. Click New
  3. Search for "XBuilder"
  4. XBuilder Popup should appear in the module list

Installation Success​

A successful installation shows:

Thank you for installing XBuilder Popup.

Create and manage popups with a powerful visual builder interface.

For support and queries Click Here

For other Joomla! extensions please visit: https://www.joomlax.com/

Post-Installation Steps​

After successful installation:

  1. Create Your First Popup Popup Library
    • Go to Components → XBuilder → Popups
    • Click New to open the builder, Once you open it the Popup Library will open. You can either add a blank one or choose any from the list of 250+ existing Popups
    • Complete the guided tour

Component 2. Set Up the Module

  • Go to Content → Site Modules
  • Create a new XBuilder Popup module
  • Select your popup and assign to pages

Troubleshooting Installation​

Upload Size Limit​

If upload fails due to file size:

  1. Check your PHP settings:

    • upload_max_filesize (should be at least 10M)
    • post_max_size (should be larger than upload_max_filesize)

  2. Use the "Install from Folder" method instead

Permission Errors​

If you see permission errors:

  1. Ensure Joomla directories are writable:
    • /administrator/components
    • /modules
    • /media
  2. Check folder permissions (typically 755 for directories, 644 for files)

PHP Version Error​

If installation fails with PHP error:

  • XBuilder requires PHP 8.0.0 or higher
  • Check your PHP version in System → System Information

Joomla Version Error​

If installation fails with Joomla version error:

  • XBuilder requires Joomla 4.0.0 or higher
  • Works with Joomla 4.x, 5.x, and 6.x

Next Steps​