Back to DigiFusion

Troubleshooting Update and Installation Issues

WordPress theme installation and updates can sometimes encounter issues due to various factors including server limitations, file permissions, or plugin conflicts. This guide addresses the most common problems and their solutions for DigiFusion theme.

Installation Issues

Theme Upload Fails

If the theme upload fails through the WordPress admin interface, this is typically due to file size limitations or server restrictions.

Solution 1: Manual Installation via FTP

  1. Download the DigiFusion theme ZIP file
  2. Extract the ZIP file to reveal the digifusion folder
  3. Connect to your website via FTP using an FTP client like FileZilla
  4. Navigate to /wp-content/themes/ directory
  5. Upload the extracted digifusion folder to this location
  6. Go to Appearance > Themes in WordPress admin
  7. Activate the DigiFusion theme

Solution 2: Increase Upload Limits

Add the following code to your theme’s functions.php file or create a custom plugin:

@ini_set('upload_max_size', '64M');
@ini_set('post_max_size', '64M');
@ini_set('max_execution_time', 300);

“Destination folder already exists” Error

This error occurs when trying to install a theme with the same folder name.

Solution:

  1. Go to Appearance > Themes
  2. Delete the existing DigiFusion theme if present
  3. Reinstall the new version
  4. Alternatively, rename the existing theme folder via FTP before installation

Update Issues

Update Notification Not Appearing

If you’re not seeing update notifications for DigiFusion Pro or the theme itself, check the following:

For DigiFusion Pro Plugin:

  1. Ensure your license is active in DigiFusion > Updates
  2. Verify your website has internet connectivity
  3. Check if any security plugins are blocking update checks

For Free Theme:

Updates for the free version come through the WordPress.org repository and should appear automatically in Dashboard > Updates.

Update Fails to Complete

If the update process starts but doesn’t complete:

Solution 1: Clear Update Cache

Add this code to your wp-config.php file temporarily:

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

Then check the debug log at /wp-content/debug.log for specific error messages.

Solution 2: Manual Update

  1. Download the latest version of DigiFusion
  2. Deactivate the current theme (switch to a default WordPress theme temporarily)
  3. Delete the old DigiFusion theme folder via FTP
  4. Upload the new version
  5. Reactivate DigiFusion theme

License Key Issues (Pro Version)

If you’re experiencing issues with license validation:

  1. Deactivate the license in DigiFusion > Updates
  2. Wait 5 minutes
  3. Re-enter your license key
  4. Click “Activate License”

If the issue persists, contact support with your license key and website URL.

Plugin Conflicts

Theme Breaks After Plugin Installation

Some plugins can conflict with theme functionality, causing layout issues or broken features.

Identifying Conflicts:

  1. Deactivate all plugins
  2. Check if the issue is resolved
  3. Reactivate plugins one by one to identify the problematic plugin
  4. Look for plugins that modify theme files or add custom CSS/JS

Common Conflicting Plugin Types:

  • Page builders (if not compatible)
  • SEO plugins with theme modification features
  • Caching plugins with aggressive optimization
  • Security plugins blocking theme resources

Elementor Integration Issues

If you’re using DigiFusion Pro with Elementor and experiencing issues:

  1. Update Elementor to the latest version
  2. Go to Elementor > Tools > Regenerate CSS
  3. Clear any caching plugins
  4. Check if Elementor Pro features are properly licensed

File Permission Issues

Cannot Write Files Error

This error typically occurs during installation or when the theme tries to create files.

Solution:

Set the correct file permissions via FTP:

  • Folders: 755 or 750
  • Files: 644 or 640

Common directories that need write permissions:

  • /wp-content/themes/
  • /wp-content/uploads/
  • /wp-content/cache/ (if using caching)

WordPress File Editor Restrictions

If you cannot edit theme files through WordPress admin:

  1. Check if DISALLOW_FILE_EDIT is set to true in wp-config.php
  2. If yes, change it to false or remove the line entirely:
define('DISALLOW_FILE_EDIT', false);

Memory and Performance Issues

Fatal Error: Memory Limit Exceeded

This error occurs when WordPress doesn’t have enough memory allocated.

Solution 1: Increase PHP Memory Limit

Add to wp-config.php:

ini_set('memory_limit', '256M');

Solution 2: Contact Hosting Provider

If the above doesn’t work, contact your hosting provider to increase the PHP memory limit server-wide.

White Screen After Installation

A white screen typically indicates a fatal PHP error.

Debugging Steps:

  1. Enable WordPress debugging by adding to wp-config.php:
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
  1. Check the error log at /wp-content/debug.log
  2. Switch to a default theme to see if the issue persists
  3. Ensure your server meets WordPress requirements (PHP 7.4+)

Server Compatibility

Minimum Requirements Check

Ensure your server meets these requirements:

  • PHP version 7.4 or higher
  • WordPress 6.0 or higher
  • MySQL 5.6 or MariaDB 10.1 or higher
  • HTTPS support recommended

PHP Version Conflicts

If you’re experiencing issues after installation:

  1. Check your current PHP version in Tools > Site Health
  2. Update to PHP 8.0 or higher if possible
  3. Ensure all required PHP extensions are enabled:
    • gd (for image processing)
    • mbstring (for text processing)
    • xml (for WordPress core functions)

Database Issues

Missing Database Tables

If certain features aren’t working properly:

  1. Deactivate and reactivate the DigiFusion Pro plugin
  2. Go to DigiFusion > Dashboard and check for any error messages
  3. If issues persist, try repairing the database through Tools > Site Health

Character Encoding Problems

For sites with special characters or non-English content:

  1. Ensure your database uses utf8mb4 collation
  2. Add to wp-config.php:
define('DB_CHARSET', 'utf8mb4');
define('DB_COLLATE', 'utf8mb4_unicode_ci');

By following these troubleshooting steps, most installation and update issues with DigiFusion can be resolved. Each solution addresses specific scenarios, so try the most relevant one based on your situation.

Back to DigiFusion