Common Installation Issues

Overview

This guide addresses the most common installation problems users encounter when installing Attributes User Access, including plugin activation failures, server requirement issues, and file permission errors.

Issue 1: Plugin Won’t Activate

Symptoms

Error message when clicking "Activate":

<ul>
<li>"Plugin could not be activated because it triggered a fatal error"</li></ul>

<ul>
<li>"The plugin does not have a valid header"</li></ul>

<ul>
<li>White screen after activation attempt</li></ul>

Solution 1: Check PHP Version

Verify PHP version meets requirements:

Required: PHP 7.4 or higher

Recommended: PHP 8.0+

Check your PHP version:

• Go to Tools → Site Health → Info

• Scroll to Server section

• Check “PHP version”

If PHP version is too old:

Contact your hosting provider:

• cPanel users: Select PHP version in MultiPHP Manager

• Managed WordPress hosts: Request upgrade via support

• VPS users: Update via command line or control panel

Solution 2: Increase Memory Limit

Check current memory limit:

// Add to wp-config.php before "That's all, stop editing!"
define('WP_MEMORY_LIMIT', '256M');
define('WP_MAX_MEMORY_LIMIT', '512M');

Via .htaccess (Apache servers):

php_value memory_limit 256M

Via php.ini:

memory_limit = 256M

Solution 3: Check for Plugin Conflicts

Deactivate other plugins temporarily:

• Go to Plugins → Installed Plugins

• Deactivate all other plugins

• Try activating Attributes User Access

• If successful, reactivate other plugins one by one

• Identify which plugin causes conflict

Issue 2: “File Upload Failed”

Symptoms

When uploading via Plugins → Add New → Upload Plugin:

• “The uploaded file exceeds the upload_max_filesize directive”

• “The link you followed has expired”

• Upload stops at certain percentage

Solution 1: Increase Upload Limits

Via wp-config.php:

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

Via .htaccess:

php_value upload_max_filesize 64M
php_value post_max_size 64M
php_value max_execution_time 300
php_value max_input_time 300

Via php.ini:

upload_max_filesize = 64M
post_max_size = 64M
max_execution_time = 300

Solution 2: Use FTP Installation

If upload continues failing:

• Download plugin ZIP from your account

• Unzip on your computer

• Connect via FTP (FileZilla, WinSCP, etc.)

• Upload folder to: /wp-content/plugins/

• Go to Plugins page in WordPress

• Click “Activate”

Issue 3: Missing Database Tables

Symptoms

Plugin activates but features don’t work:

• Settings won’t save

• Custom login pages show errors

• Audit logs empty despite activity

Solution: Manually Create Tables

Deactivate and reactivate plugin:

• Go to Plugins → Installed Plugins

• Click “Deactivate” under Attributes User Access

• Wait 5 seconds

• Click “Activate”

• This triggers database table creation

If still not working, check database permissions:

-- Your WordPress database user needs these permissions:

<ul>
<li>CREATE</li></ul>

<ul>
<li>ALTER</li></ul>

<ul>
<li>INSERT</li></ul>

<ul>
<li>UPDATE</li></ul>

<ul>
<li>SELECT</li></ul>

<ul>
<li>DELETE</li></ul>

Issue 4: License Activation Fails

Symptoms

License key won’t activate:

• “Invalid license key”

• “License already in use”

• “Unable to contact license server”

Solution 1: Verify License Key

Solution 2: Check Firewall/Security

License server communication requirements:

Outgoing HTTPS connections must be allowed to:

• license.attributesframework.com

• Port 443 (HTTPS)

Blocked by:

• Overly restrictive firewalls

• ModSecurity rules

• Server-level security plugins

Test connection:

// Add to wp-config.php temporarily
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);

// Attempt license activation
// Check /wp-content/debug.log for connection errors

Solution 3: Deactivate Old Sites

If “License already in use”:

• Log into your account dashboard

• Go to Licenses section

• View active sites using this license

• Deactivate old/staging sites

• Try activating on new site

Issue 5: Plugin Files Corrupt

Symptoms

• Missing PHP files errors

• “Call to undefined function” errors

• “Class not found” errors

• Incomplete plugin installation

Solution: Fresh Installation

Complete reinstallation:

• Deactivate plugin (if possible)

• Delete plugin via Plugins → Delete

• Or delete via FTP: /wp-content/plugins/attributes-user-access-pro/

• Download fresh copy from your account

• Upload and install new copy

• Activate plugin

• Re-enter license key

Issue 6: “Cannot Modify Header” Error

Symptoms

Warning: Cannot modify header information – headers already sent by…

Solution: Remove Extra Whitespace

Check these files for spaces before <?php:

Files to check:

• wp-config.php

• functions.php (active theme)

• Any custom plugin files

Problem:

<?php ← Extra space before opening tag

Correct: <?php ← No space before opening tag Also check for spaces after closing ?>:

Problem:

?> ← Extra space after closing tag

Correct:

?> ← No space after closing tag

// Or better: Remove closing ?> entirely (WordPress coding standard)

Issue 7: Blank Admin Page After Activation

Symptoms

• Plugin Settings page shows blank/white screen

• WordPress admin sidebar visible but content blank

• No error messages displayed

Solution 1: Enable Error Display

Temporarily show errors:

// Add to wp-config.php
define('WP_DEBUG', true);
define('WP_DEBUG_DISPLAY', true);
@ini_set('display_errors', 1);

Refresh page and note error message, then contact support with details.

Solution 2: Theme Compatibility

Test with default theme:

• Go to Appearance → Themes

• Activate Twenty Twenty-Four (or latest default theme)

• Try accessing plugin settings again

• If works, your theme has compatibility issue

Issue 8: Slow Installation Process

Symptoms

• Installation/activation takes several minutes

• Server timeout during activation

• Process never completes

Solution: Increase Execution Time

Via wp-config.php:

set_time_limit(300); // 5 minutes
@ini_set('max_execution_time', '300');

Via .htaccess:

php_value max_execution_time 300

For large sites (10,000+ users):

Consider activation on staging site first to test

Temporarily disable other plugins during activation

Clear all caches before activation

Prevention Best Practices

Getting Additional Help