{"id":3523,"date":"2024-12-09T00:00:00","date_gmt":"2024-12-09T00:00:00","guid":{"rendered":"https:\/\/attributesuseraccess.com\/?post_type=docs&p=1033"},"modified":"2024-12-09T00:00:00","modified_gmt":"2024-12-09T00:00:00","slug":"common-installation-issues","status":"publish","type":"docs","link":"https:\/\/attributeswp.com\/docs\/common-installation-issues\/","title":{"rendered":"Common Installation Issues"},"content":{"rendered":"
\n
Version: 1.2.1<\/span>\nLast Updated: December 2025<\/span>\nDifficulty: Beginner<\/span>\nTime Required: 15 minutes<\/span><\/div>\n\n
\n\n

Overview<\/h2>\n\n

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.\n<\/p>\n\n

Issue 1: Plugin Won’t Activate<\/h2>\n\n

Symptoms<\/h3>\n\n
\nError message when clicking "Activate":\n\n<ul>\n<li>"Plugin could not be activated because it triggered a fatal error"<\/li><\/ul>\n\n<ul>\n<li>"The plugin does not have a valid header"<\/li><\/ul>\n\n<ul>\n<li>White screen after activation attempt<\/li><\/ul>\n<\/code><\/pre>\n\n
Solution 1: Check PHP Version<\/h3>\n\nVerify PHP version meets requirements:<\/strong>\n\n
Required: PHP 7.4 or higher\n<\/p>\n
Recommended: PHP 8.0+\n<\/p>\n\n
Check your PHP version:\n<\/p>\n
    \n
  • Go to Tools \u2192 Site Health \u2192 Info<\/li><\/ul>\n\n
      \n
    • Scroll to Server section<\/li><\/ul>\n\n
        \n
      • Check “PHP version”<\/li><\/ul>\n\nIf PHP version is too old:<\/strong>\n\n
        Contact your hosting provider:\n<\/p>\n
          \n
        • cPanel users: Select PHP version in MultiPHP Manager<\/li><\/ul>\n\n
            \n
          • Managed WordPress hosts: Request upgrade via support<\/li><\/ul>\n\n
              \n
            • VPS users: Update via command line or control panel<\/li><\/ul>\n\n
              Solution 2: Increase Memory Limit<\/h3>\n\nCheck current memory limit:<\/strong>\n\n
              \n\/\/ Add to wp-config.php before "That's all, stop editing!"\ndefine('WP_MEMORY_LIMIT', '256M');\ndefine('WP_MAX_MEMORY_LIMIT', '512M');\n<\/code><\/pre>\n\nVia .htaccess (Apache servers):<\/strong>\n\n
              \nphp_value memory_limit 256M\n<\/code><\/pre>\n\nVia php.ini:<\/strong>\n\n
              \nmemory_limit = 256M\n<\/code><\/pre>\n\n
              Solution 3: Check for Plugin Conflicts<\/h3>\n\nDeactivate other plugins temporarily:<\/strong>\n\n
                \n
              • Go to Plugins \u2192 Installed Plugins<\/li><\/ul>\n\n
                  \n
                • Deactivate all other plugins<\/li><\/ul>\n\n
                    \n
                  • Try activating Attributes User Access<\/li><\/ul>\n\n
                      \n
                    • If successful, reactivate other plugins one by one<\/li><\/ul>\n\n
                        \n
                      • Identify which plugin causes conflict<\/li><\/ul>\n\n
                        Issue 2: “File Upload Failed”<\/h2>\n\n
                        Symptoms<\/h3>\n\n
                        When uploading via Plugins \u2192 Add New \u2192 Upload Plugin:\n<\/p>\n
                          \n
                        • “The uploaded file exceeds the upload_max_filesize directive”<\/li><\/ul>\n\n
                            \n
                          • “The link you followed has expired”<\/li><\/ul>\n\n
                              \n
                            • Upload stops at certain percentage<\/li><\/ul>\n\n
                              Solution 1: Increase Upload Limits<\/h3>\n\nVia wp-config.php:<\/strong>\n\n
                              \n@ini_set('upload_max_size', '64M');\n@ini_set('post_max_size', '64M');\n@ini_set('max_execution_time', '300');\n<\/code><\/pre>\n\nVia .htaccess:<\/strong>\n\n
                              \nphp_value upload_max_filesize 64M\nphp_value post_max_size 64M\nphp_value max_execution_time 300\nphp_value max_input_time 300\n<\/code><\/pre>\n\nVia php.ini:<\/strong>\n\n
                              \nupload_max_filesize = 64M\npost_max_size = 64M\nmax_execution_time = 300\n<\/code><\/pre>\n\n
                              Solution 2: Use FTP Installation<\/h3>\n\nIf upload continues failing:<\/strong>\n\n
                                \n
                              • Download plugin ZIP from your account<\/li><\/ul>\n\n
                                  \n
                                • Unzip on your computer<\/li><\/ul>\n\n
                                    \n
                                  • Connect via FTP (FileZilla, WinSCP, etc.)<\/li><\/ul>\n\n
                                      \n
                                    • Upload folder to: \/wp-content\/plugins\/<\/li><\/ul>\n\n
                                        \n
                                      • Go to Plugins page in WordPress<\/li><\/ul>\n\n
                                          \n
                                        • Click “Activate”<\/li><\/ul>\n\n
                                          Issue 3: Missing Database Tables<\/h2>\n\n
                                          Symptoms<\/h3>\n\n
                                          Plugin activates but features don’t work:\n<\/p>\n
                                            \n
                                          • Settings won’t save<\/li><\/ul>\n\n
                                              \n
                                            • Custom login pages show errors<\/li><\/ul>\n\n
                                                \n
                                              • Audit logs empty despite activity<\/li><\/ul>\n\n
                                                Solution: Manually Create Tables<\/h3>\n\nDeactivate and reactivate plugin:<\/strong>\n\n
                                                  \n
                                                • Go to Plugins \u2192 Installed Plugins<\/li><\/ul>\n\n
                                                    \n
                                                  • Click “Deactivate” under Attributes User Access<\/li><\/ul>\n\n
                                                      \n
                                                    • Wait 5 seconds<\/li><\/ul>\n\n
                                                        \n
                                                      • Click “Activate”<\/li><\/ul>\n\n
                                                          \n
                                                        • This triggers database table creation<\/li><\/ul>\n\nIf still not working, check database permissions:<\/strong>\n\n
                                                          \n-- Your WordPress database user needs these permissions:\n\n<ul>\n<li>CREATE<\/li><\/ul>\n\n<ul>\n<li>ALTER<\/li><\/ul>\n\n<ul>\n<li>INSERT<\/li><\/ul>\n\n<ul>\n<li>UPDATE<\/li><\/ul>\n\n<ul>\n<li>SELECT<\/li><\/ul>\n\n<ul>\n<li>DELETE<\/li><\/ul>\n<\/code><\/pre>\n\n
                                                          Issue 4: License Activation Fails<\/h2>\n\n
                                                          Symptoms<\/h3>\n\n
                                                          License key won’t activate:\n<\/p>\n
                                                            \n
                                                          • “Invalid license key”<\/li><\/ul>\n\n
                                                              \n
                                                            • “License already in use”<\/li><\/ul>\n\n
                                                                \n
                                                              • “Unable to contact license server”<\/li><\/ul>\n\n
                                                                Solution 1: Verify License Key<\/h3>\n\n
                                                                \n
                                                                  \n
                                                                    \n
                                                                  • Check for typos (copy-paste license key)<\/li><\/ul>\n\n
                                                                      \n
                                                                    • Verify license hasn’t expired<\/li><\/ul>\n\n
                                                                        \n
                                                                      • Ensure using Pro key for Pro features<\/li><\/ul>\n\n
                                                                          \n
                                                                        • Confirm site URL matches license<\/li><\/ul>\n\n
                                                                            \n
                                                                          • Check license not already used on max sites<\/li><\/ul>\n\n<\/ul>\n<\/div>\n\n
                                                                            Solution 2: Check Firewall\/Security<\/h3>\n\nLicense server communication requirements:<\/strong>\n\n
                                                                            Outgoing HTTPS connections must be allowed to:\n<\/p>\n
                                                                              \n
                                                                            • license.attributesframework.com<\/li><\/ul>\n\n
                                                                                \n
                                                                              • Port 443 (HTTPS)<\/li><\/ul>\n\n
                                                                                Blocked by:\n<\/p>\n
                                                                                  \n
                                                                                • Overly restrictive firewalls<\/li><\/ul>\n\n
                                                                                    \n
                                                                                  • ModSecurity rules<\/li><\/ul>\n\n
                                                                                      \n
                                                                                    • Server-level security plugins<\/li><\/ul>\n\nTest connection:<\/strong>\n\n
                                                                                      \n\/\/ Add to wp-config.php temporarily\ndefine('WP_DEBUG', true);\ndefine('WP_DEBUG_LOG', true);\n\n\/\/ Attempt license activation\n\/\/ Check \/wp-content\/debug.log for connection errors\n<\/code><\/pre>\n\n
                                                                                      Solution 3: Deactivate Old Sites<\/h3>\n\nIf “License already in use”:<\/strong>\n\n
                                                                                        \n
                                                                                      • Log into your account dashboard<\/li><\/ul>\n\n
                                                                                          \n
                                                                                        • Go to Licenses section<\/li><\/ul>\n\n
                                                                                            \n
                                                                                          • View active sites using this license<\/li><\/ul>\n\n
                                                                                              \n
                                                                                            • Deactivate old\/staging sites<\/li><\/ul>\n\n
                                                                                                \n
                                                                                              • Try activating on new site<\/li><\/ul>\n\n
                                                                                                Issue 5: Plugin Files Corrupt<\/h2>\n\n
                                                                                                Symptoms<\/h3>\n\n
                                                                                                  \n
                                                                                                • Missing PHP files errors<\/li><\/ul>\n\n
                                                                                                    \n
                                                                                                  • “Call to undefined function” errors<\/li><\/ul>\n\n
                                                                                                      \n
                                                                                                    • “Class not found” errors<\/li><\/ul>\n\n
                                                                                                        \n
                                                                                                      • Incomplete plugin installation<\/li><\/ul>\n\n
                                                                                                        Solution: Fresh Installation<\/h3>\n\nComplete reinstallation:<\/strong>\n\n
                                                                                                          \n
                                                                                                        • Deactivate plugin (if possible)<\/li><\/ul>\n\n
                                                                                                            \n
                                                                                                          • Delete plugin via Plugins \u2192 Delete<\/li><\/ul>\n\n
                                                                                                              \n
                                                                                                            • Or delete via FTP: \/wp-content\/plugins\/attributes-user-access-pro\/<\/li><\/ul>\n\n
                                                                                                                \n
                                                                                                              • Download fresh copy from your account<\/li><\/ul>\n\n
                                                                                                                  \n
                                                                                                                • Upload and install new copy<\/li><\/ul>\n\n
                                                                                                                    \n
                                                                                                                  • Activate plugin<\/li><\/ul>\n\n
                                                                                                                      \n
                                                                                                                    • Re-enter license key<\/li><\/ul>\n\n
                                                                                                                      Settings will be preserved!<\/strong> Deleting plugin doesn’t delete settings from database. Your configuration will remain after reinstallation.\n<\/div>\n\n
                                                                                                                      Issue 6: “Cannot Modify Header” Error<\/h2>\n\n
                                                                                                                      Symptoms<\/h3>\n\n
                                                                                                                      Warning: Cannot modify header information – headers already sent by…\n<\/p>\n\n
                                                                                                                      Solution: Remove Extra Whitespace<\/h3>\n\nCheck these files for spaces before <?php: <\/strong>\n\n
                                                                                                                      Files to check:\n<\/p>\n
                                                                                                                        \n
                                                                                                                      • wp-config.php<\/li><\/ul>\n\n
                                                                                                                          \n
                                                                                                                        • functions.php (active theme)<\/li><\/ul>\n\n
                                                                                                                            \n
                                                                                                                          • Any custom plugin files<\/li><\/ul>\n\n
                                                                                                                            Problem:\n<\/p>\n  <?php ← Extra space before opening tag\n\n
                                                                                                                            Correct:\n\n<?php ← No space before opening tag\n\nAlso check for spaces after closing ?>:<\/strong>\n\n
                                                                                                                            Problem:\n<\/p>\n
                                                                                                                            ?>  \u2190 Extra space after closing tag\n<\/p>\n\n
                                                                                                                            Correct:\n<\/p>\n
                                                                                                                            ?>  \u2190 No space after closing tag\n<\/p>\n
                                                                                                                            \/\/ Or better: Remove closing ?> entirely (WordPress coding standard)\n<\/p>\n\n
                                                                                                                            Issue 7: Blank Admin Page After Activation<\/h2>\n\n
                                                                                                                            Symptoms<\/h3>\n\n
                                                                                                                              \n
                                                                                                                            • Plugin Settings page shows blank\/white screen<\/li><\/ul>\n\n
                                                                                                                                \n
                                                                                                                              • WordPress admin sidebar visible but content blank<\/li><\/ul>\n\n
                                                                                                                                  \n
                                                                                                                                • No error messages displayed<\/li><\/ul>\n\n
                                                                                                                                  Solution 1: Enable Error Display<\/h3>\n\nTemporarily show errors:<\/strong>\n\n
                                                                                                                                  \n\/\/ Add to wp-config.php\ndefine('WP_DEBUG', true);\ndefine('WP_DEBUG_DISPLAY', true);\n@ini_set('display_errors', 1);\n<\/code><\/pre>\n\nRefresh page and note error message, then contact support with details.<\/strong>\n\n
                                                                                                                                  Solution 2: Theme Compatibility<\/h3>\n\nTest with default theme:<\/strong>\n\n
                                                                                                                                    \n
                                                                                                                                  • Go to Appearance \u2192 Themes<\/li><\/ul>\n\n
                                                                                                                                      \n
                                                                                                                                    • Activate Twenty Twenty-Four (or latest default theme)<\/li><\/ul>\n\n
                                                                                                                                        \n
                                                                                                                                      • Try accessing plugin settings again<\/li><\/ul>\n\n
                                                                                                                                          \n
                                                                                                                                        • If works, your theme has compatibility issue<\/li><\/ul>\n\n
                                                                                                                                          Issue 8: Slow Installation Process<\/h2>\n\n
                                                                                                                                          Symptoms<\/h3>\n\n
                                                                                                                                            \n
                                                                                                                                          • Installation\/activation takes several minutes<\/li><\/ul>\n\n
                                                                                                                                              \n
                                                                                                                                            • Server timeout during activation<\/li><\/ul>\n\n
                                                                                                                                                \n
                                                                                                                                              • Process never completes<\/li><\/ul>\n\n
                                                                                                                                                Solution: Increase Execution Time<\/h3>\n\nVia wp-config.php:<\/strong>\n\n
                                                                                                                                                \nset_time_limit(300); \/\/ 5 minutes\n@ini_set('max_execution_time', '300');\n<\/code><\/pre>\n\nVia .htaccess:<\/strong>\n\n
                                                                                                                                                \nphp_value max_execution_time 300\n<\/code><\/pre>\n\nFor large sites (10,000+ users):<\/strong>\n\n
                                                                                                                                                Consider activation on staging site first to test\n<\/p>\n
                                                                                                                                                Temporarily disable other plugins during activation\n<\/p>\n
                                                                                                                                                Clear all caches before activation\n<\/p>\n\n
                                                                                                                                                Prevention Best Practices<\/h2>\n\n
                                                                                                                                                Backup Before Installing<\/strong>
                                                                                                                                                \n
                                                                                                                                                Always backup database and files before installing new plugins.\n<\/p>\n<\/div>\n\n
                                                                                                                                                Test on Staging First<\/strong>
                                                                                                                                                \n
                                                                                                                                                Install on staging site before production, especially for Pro features.\n<\/p>\n<\/div>\n\n
                                                                                                                                                Keep WordPress Updated<\/strong>
                                                                                                                                                \n
                                                                                                                                                Ensure WordPress core is latest version before installing plugins.\n<\/p>\n<\/div>\n\n
                                                                                                                                                Check System Requirements<\/strong>
                                                                                                                                                \n
                                                                                                                                                Verify PHP version, memory, and database permissions before installation.\n<\/p>\n<\/div>\n\n
                                                                                                                                                Getting Additional Help<\/h2>\n\n
                                                                                                                                                If issues persist after trying these solutions:<\/strong>\n
                                                                                                                                                  \n
                                                                                                                                                    \n
                                                                                                                                                  • Enable WP_DEBUG and check debug.log<\/li><\/ul>\n\n
                                                                                                                                                      \n
                                                                                                                                                    • Test with all other plugins deactivated<\/li><\/ul>\n\n
                                                                                                                                                        \n
                                                                                                                                                      • Try default WordPress theme<\/li><\/ul>\n\n
                                                                                                                                                          \n
                                                                                                                                                        • Contact support with: WordPress version, PHP version, error messages, debug.log contents<\/li><\/ul>\n\n<\/ul>\n<\/div>\n\n<\/div>\n<\/div>","protected":false},"excerpt":{"rendered":"
                                                                                                                                                          Troubleshoot common problems during plugin installation and activation.<\/p>","protected":false},"featured_media":0,"parent":0,"template":"","meta":{"_acf_changed":false,"_surecart_dashboard_logo_width":"180px","_surecart_dashboard_show_logo":true,"_surecart_dashboard_navigation_orders":true,"_surecart_dashboard_navigation_invoices":true,"_surecart_dashboard_navigation_subscriptions":true,"_surecart_dashboard_navigation_downloads":true,"_surecart_dashboard_navigation_billing":true,"_surecart_dashboard_navigation_account":true,"advanced_seo_description":"","jetpack_seo_html_title":"","jetpack_seo_noindex":false,"jetpack_post_was_ever_published":false,"footnotes":""},"chapter":[370],"class_list":["post-3523","docs","type-docs","status-publish","hentry","chapter-troubleshooting"],"acf":{"reading_time":"","difficulty":"beginner","plugin_version":"1.2.2","last_updated":null},"jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/attributeswp.com\/wp-json\/wp\/v2\/docs\/3523","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/attributeswp.com\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/attributeswp.com\/wp-json\/wp\/v2\/types\/docs"}],"version-history":[{"count":0,"href":"https:\/\/attributeswp.com\/wp-json\/wp\/v2\/docs\/3523\/revisions"}],"wp:attachment":[{"href":"https:\/\/attributeswp.com\/wp-json\/wp\/v2\/media?parent=3523"}],"wp:term":[{"taxonomy":"chapter","embeddable":true,"href":"https:\/\/attributeswp.com\/wp-json\/wp\/v2\/chapter?post=3523"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}