Uninstallation Guide

If you need to remove XBuilder from your Joomla site, follow this guide to ensure a clean uninstallation.

Before Uninstalling

Backup Your Popups

If you want to preserve your popup designs:

1. Export Popups

   • Open each popup in the builder
   • Use Export to save JSON configuration
   • Store exported files safely

2. Database Backup

   • Create a database backup
   • Popup data is in #__xbuilder_popups table

Document Module Settings

Note your module configurations:

• Menu assignments
• Access levels
• Module positions

Disable Modules First

1. Go to Content → Site Modules
2. Find all XBuilder Popup modules
3. Either:
   • Set status to Unpublished, or
   • Delete the modules

tip

Unpublishing first lets you re-enable if needed before full uninstallation.

Uninstallation Methods

Method 1: Uninstall Package (Recommended)

This removes both the component and module:

1. Go to System → Manage → Extensions
2. Search for "xbuilder"
3. Find the Package - XBuilder entry
4. Check the checkbox
5. Click Uninstall in the toolbar
6. Confirm the uninstallation

Method 2: Uninstall Components Separately

If the package doesn't appear:

1. Go to System → Manage → Extensions
2. Search for "xbuilder"
3. First, uninstall Module - XBuilder Popup
   • Check the checkbox
   • Click Uninstall
4. Then, uninstall Component - XBuilder
   • Check the checkbox
   • Click Uninstall

Order Matters

Uninstall the module before the component to avoid orphaned module instances.

Method 3: Manual Uninstallation

If standard methods fail:

1. Remove Files via FTP

   Delete: /administrator/components/com_xbuilder
   Delete: /components/com_xbuilder (if exists)
   Delete: /modules/mod_xbuilder_popup
   Delete: /media/com_xbuilder

2. Clean Database

   • Remove entries from #__extensions table
   • Remove #__xbuilder_* tables
   • Remove from #__menu table
   • Remove from #__assets table

3. Clear Cache

   • Delete Joomla cache files

Manual Uninstallation

Only use manual uninstallation as a last resort. Incorrect database modifications can break your site.

What Gets Removed

Files Removed

Location	Contents
/administrator/components/com_xbuilder	Admin component files
/components/com_xbuilder	Site component files
/modules/mod_xbuilder_popup	Module files
/media/com_xbuilder	JavaScript, CSS, assets

Database Tables Removed

Table	Contents
#__xbuilder_popups	Your popup configurations
Other XBuilder tables	Extension data

Registry Entries Removed

• Extension registration in #__extensions
• Menu items in #__menu
• Asset permissions in #__assets

What's NOT Removed

Preserved Data

Item	Location	Notes
Uploaded images	/images/ folder	Shared media stays
Module positions	Template config	Position definitions stay
Template overrides	/templates/*/html/	If any were created

Manual Cleanup (Optional)

After uninstallation, you may want to:

1. Remove popup images

   • Delete /images/popups/ or similar folders
   • Only if no longer needed

2. Clean media folder

   • Remove images uploaded via XBuilder
   • Check /images/ for XBuilder-specific folders

Reinstallation

If you uninstalled by mistake:

1. Reinstall the package

   • Use the same pkg_xbuilder.zip
   • Install via Extensions Manager

2. Restore data

   • Import exported popup JSON files
   • Or restore database from backup

3. Reconfigure modules

   • Create new module instances
   • Apply saved configurations

Troubleshooting Uninstallation

Uninstall Fails

If uninstallation fails:

1. Check error messages
2. Verify file permissions
3. Check database permissions
4. Try uninstalling components separately

Leftover Menu Items

If XBuilder still appears in Components menu:

1. Go to Menus → Administrator Menu
2. Search for "XBuilder"
3. Delete any remaining menu items

Leftover Database Tables

To check for leftover tables:

1. Access your database (phpMyAdmin)
2. Search for tables starting with #__xbuilder
3. Drop these tables if uninstallation is complete

DROP TABLE IF EXISTS `#__xbuilder_popups`;
-- Replace #__ with your actual table prefix

Extension Still Listed

If extension appears in manager after uninstall:

1. Go to System → Manage → Extensions
2. Find the orphaned entry
3. Delete directly (if uninstall fails)

Complete Cleanup Checklist

Use this checklist for complete removal:

• Exported popup configurations (if needed)
• Created full backup
• Unpublished/deleted all modules
• Uninstalled package via Extension Manager
• Verified no error messages
• Checked Components menu (XBuilder removed)
• Checked Site Modules (no XBuilder modules)
• Cleared Joomla cache
• Cleaned up uploaded images (optional)

Getting Help

If you encounter issues:

1. Check Joomla error logs
2. Search support forums
3. Contact support with:
   • Joomla version
   • PHP version
   • Error messages
   • Steps you've tried

Temporary Disable Alternative

If you're unsure about full uninstallation:

Disable Component

1. Go to System → Manage → Extensions
2. Find XBuilder component
3. Click to Disable (not uninstall)

Disable Module

1. Go to Content → Site Modules
2. Unpublish all XBuilder modules

This keeps the extension installed but inactive.

Next Steps

If you're uninstalling due to issues:

• Check Troubleshooting first
• Contact support for assistance

If switching to another solution:

• Export your popup designs first
• Document your configurations