Installation Guide

This guide walks you through installing and activating BuddyX Pro on your WordPress site.

Before You Begin

Pre-Installation Checklist

WordPress 6.5 or higher installed
PHP 8.0 or higher on your server
MySQL 5.7+ or MariaDB 10.3+
At least 128MB PHP memory limit (256MB recommended)
Valid BuddyX Pro license key
Backup of your current site (recommended)

Download the Theme

Log in to your WBCom Designs account
Navigate to Downloads
Find BuddyX Pro and click Download
Save the .zip file to your computer

Installation Methods

Method 1: WordPress Admin Upload (Recommended)

Log in to your WordPress admin dashboard
Navigate to Appearance > Themes
Click Add New at the top of the page
Click Upload Theme
Click Choose File and select the buddyx-pro.zip file
Click Install Now
Wait for the installation to complete
Click Activate to enable the theme

Method 2: FTP Upload

Use this method if the upload fails due to server limitations:

Extract the buddyx-pro.zip file on your computer
Connect to your server via FTP client (FileZilla, Cyberduck, etc.)
Navigate to /wp-content/themes/
Upload the extracted buddyx-pro folder
Go to Appearance > Themes in WordPress admin
Find BuddyX Pro and click Activate

Method 3: cPanel File Manager

Log in to your hosting cPanel
Open File Manager
Navigate to public_html/wp-content/themes/
Click Upload and select the buddyx-pro.zip file
After upload, right-click the zip file and select Extract
Go to WordPress admin > Appearance > Themes
Activate BuddyX Pro

Post-Installation Setup

Step 1: Install recommended plugins

After activating BuddyX Pro, you may see a notice about recommended plugins:

Click the notification or go to Appearance > Install Plugins.
Select the plugins you need:
- BuddyPress or BuddyBoss Platform - For community features (member profiles, activity, groups, messaging).
- WooCommerce - If you want a shop, paid memberships, or the WP Sell Services bundled plugin.
- Bundled BuddyX Pro plugins (Jetonomy, MediaVerse, WB Gamification, WP Career Board, WP Sell Services) - install on demand from the BuddyX Pro Plugins notice on your dashboard. See Bundled Plugins for the full reference.
Click Install and then Activate.

5.1.0 note: the legacy Kirki Customizer Framework plugin is no longer required. BuddyX Pro 5.1.0 ships a first-party customizer framework in-theme. If Kirki is still active from a 5.0.x install, you can safely deactivate it on upgrade.

Step 2: Set up demo content (optional)

BuddyX Pro 5.1.0 ships with built-in pattern-driven demo pages - no third-party importer plugin required.

On the dashboard, find the Set up demo site admin notice.
Click the button. Seven pages get created (Home, About, Services, Pricing, Journal, FAQ, Contact), each composed of theme-shipped block patterns.
A primary navigation menu wiring those pages is also created.

See Demo Content (Starter Pages) for the full reference, including how the fresh-install Customizer auto-preview path differs from the existing-site admin button. The legacy Starter Templates / One-Click Demo Import flow from 5.0.x is no longer required.

Step 3: Configure Basic Settings

Go to Appearance > Customize
Set your Site Identity (logo, site title, tagline)
Configure Header options (layout, menu position)
Set your Colors in the Skin panel
Click Publish to save changes

Step 4: Set Up Menus

Navigate to Appearance > Menus
Create a new menu or edit existing
Add pages, categories, or custom links
Assign to menu locations:
- Primary Menu - Main navigation
- Footer Menu - Footer links
- Topbar Menu - Top bar links (if enabled)
Save your menu

Step 5: Configure Widgets

Go to Appearance > Widgets
Add widgets to available sidebar areas:
- Primary Sidebar
- BuddyPress Sidebars (if BuddyPress active)
- Footer Widget Areas
Configure widget settings as needed

Updating the Theme

Automatic Updates

BuddyX Pro supports automatic updates through WordPress:

Go to Appearance > Themes
If an update is available, you’ll see a notification
Click Update Now
Wait for the update to complete

Manual Update

If automatic updates don’t work:

Download the latest version from your account
Deactivate the current BuddyX Pro theme
Delete the old theme folder via FTP
Upload and install the new version
Reactivate the theme

Important: Your customizer settings are stored in the database and will be preserved during updates.

Troubleshooting Installation

Upload Failed: File Size Limit

Problem: The theme file is too large to upload.

Solutions:

Increase PHP upload limits in php.ini:

upload_max_filesize = 64M
post_max_size = 64M

Use FTP upload method instead
Contact your hosting provider to increase limits

Theme Is Missing stylesheet

Problem: “The theme is missing the style.css stylesheet” error.

Solutions:

Ensure you’re uploading the correct zip file (not the download wrapper)
The zip should contain the buddyx-pro folder directly
Try extracting and re-zipping with only the theme folder

White Screen After Activation

Problem: Site shows blank white screen after theme activation.

Solutions:

Increase PHP memory limit:
```
define('WP_MEMORY_LIMIT', '256M');
```

Enable WordPress debug mode to see errors:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);

Check for plugin conflicts by deactivating all plugins

Customizer Not Loading

Problem: Customizer shows loading spinner indefinitely.

Solutions:

Clear browser cache
Try a different browser
Deactivate caching plugins temporarily
Check for JavaScript errors in browser console

Child Theme Installation

For customizations that survive theme updates:

Download the BuddyX Pro child theme from your account
Install via Appearance > Themes > Add New > Upload Theme
Activate the child theme instead of the parent theme
Make customizations in the child theme files

See Creating a Child Theme for detailed instructions.

Next Steps

After successful installation:

Got a question? We’re a friendly team - happy to help.

Visit our Documentation Portal
Email us at support@wbcomdesigns.com