Installation Guide

Installation Guide

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

Before You Begin

Pre-Installation Checklist

  • WordPress 6.0 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

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

Installation Methods

Method 1: WordPress Admin Upload (Recommended)

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

Method 2: FTP Upload

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

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

Method 3: cPanel File Manager

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

Post-Installation Setup

Step 1: Install Required Plugins

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

  1. Click the notification or go to Appearance > Install Plugins
  2. Select the plugins you need:
  3. Click Install and then Activate

Step 2: Import Demo Content (Optional)

To quickly set up your site with pre-designed content:

  1. Install and activate the Starter Templates plugin
  2. Navigate to Starter Templates in the admin menu
  3. Browse available demos for BuddyX Pro
  4. Click Import on your preferred demo
  5. Select import options (content, widgets, customizer settings)
  6. Complete the import process

Step 3: Configure Basic Settings

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

Step 4: Set Up Menus

  1. Navigate to Appearance > Menus
  2. Create a new menu or edit existing
  3. Add pages, categories, or custom links
  4. Assign to menu locations:
  5. Save your menu

Step 5: Configure Widgets

  1. Go to Appearance > Widgets
  2. Add widgets to available sidebar areas:
  3. Configure widget settings as needed

Updating the Theme

Automatic Updates

BuddyX Pro supports automatic updates through WordPress:

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

Manual Update

If automatic updates don’t work:

  1. Download the latest version from your account
  2. Deactivate the current BuddyX Pro theme
  3. Delete the old theme folder via FTP
  4. Upload and install the new version
  5. 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:

  1. Increase PHP upload limits in php.ini:
  2. Use FTP upload method instead
  3. Contact your hosting provider to increase limits

Theme Is Missing stylesheet

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

Solutions:

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

White Screen After Activation

Problem: Site shows blank white screen after theme activation.

Solutions:

  1. Increase PHP memory limit:
  2. Enable WordPress debug mode to see errors:
  3. Check for plugin conflicts by deactivating all plugins

Customizer Not Loading

Problem: Customizer shows loading spinner indefinitely.

Solutions:

  1. Clear browser cache
  2. Try a different browser
  3. Deactivate caching plugins temporarily
  4. Check for JavaScript errors in browser console

Child Theme Installation

For customizations that survive theme updates:

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

See Creating a Child Theme for detailed instructions.

Next Steps

After successful installation:

Need Help?

Last updated: January 31, 2026