Installation Guide – Manual ZIP Upload Method

Version: 1.0.1 (Pro)Last Updated: November 2025Difficulty: BeginnerTime Required: 10 minutes

Overview

Use this method to install the Pro version of Attributes User Access, or if you have a downloaded ZIP file of the Core version. This method requires no FTP access – everything is done through your WordPress admin panel.

Pro Version Note: This is the primary installation method for Attributes User Access Pro. The Pro version is not available in the WordPress Plugin Directory.

Prerequisites

Before you begin, ensure you have:

    • Downloaded the plugin ZIP file
    • WordPress administrator access
    • Internet connection (for license activation)
    • For Pro: Your license key ready

Where to Download

Core (Free) Version:

Pro (Enterprise) Version:

  • Navigate to My Account > Downloads
  • Click Download next to Attributes User Access Pro
  • Save the ZIP file to your computer
Important: Do not unzip the file! WordPress requires the compressed ZIP file for upload.

Step-by-Step Installation Process

Step 1: Access Plugin Upload Page

  • Log in to WordPress admin

– Navigate to yourdomain.com/wp-admin

– Enter your credentials

  • Navigate to Plugins page

– Click Plugins in the left sidebar

– Click Add New at the top

  • Click Upload Plugin

– Look for the Upload Plugin button at the top of the page

– Click it to reveal the upload form

[Screenshot: Add Plugins page with Upload Plugin button highlighted]

Step 2: Upload the ZIP File

  • Click Choose File

– A file browser dialog will open

– Navigate to where you saved the ZIP file

  • Select the plugin ZIP file

Core: attributes-user-access.zip

Pro: attributes-user-access-pro-beta.zip (or similar)

– Click Open or Select

  • Verify the file selection

– You should see the filename next to the Choose File button

– Ensure the complete filename is visible

  • Click Install Now

– The upload process will begin

– A progress indicator will show

[Screenshot: Plugin upload form with file selected]

Step 3: Wait for Upload and Installation

What happens during upload:

    • File uploads to your server (time varies based on connection speed)
    • WordPress extracts the ZIP file
    • Files are placed in /wp-content/plugins/
    • WordPress verifies the plugin structure
Upload Times:

  • Fast connection (50+ Mbps): 5-15 seconds
  • Medium connection (10-50 Mbps): 15-60 seconds
  • Slow connection (< 10 Mbps): 1-3 minutes

Don’t do this during upload:

  • ❌ Close the browser window
  • ❌ Navigate to another page
  • ❌ Refresh the page
  • ❌ Click back button

Upload Complete: You’ll see “Plugin installed successfully” when finished.

Step 4: Activate the Plugin

  • Click Activate Plugin

– Button appears after successful installation

– Located on the success confirmation page

  • Wait for activation

– Takes just a few seconds

– You’ll be redirected to the Plugins page

  • For Pro Version: License activation required

– After activation, you’ll need to enter your license key

– See Pro License Activation section below

[Screenshot: Plugin installation success page with Activate button]

Pro License Activation

After installing the Pro version, you must activate your license to unlock premium features.

Step 1: Obtain Your License Key

  • Check your purchase confirmation email

– Subject line: “Attributes User Access Pro – Purchase Confirmation”

– License key is in the email body

  • Or retrieve from your account

– Log in to attributeswp.com

– Go to My Account > Licenses

– Copy your license key

License Key Format: License keys are typically 32-character alphanumeric strings (e.g., abc123de-4567-89fg-hi01-jklm23456789)

Step 2: Navigate to License Settings

  • In WordPress admin, go to:

Settings (left sidebar)

Attributes Access

License (tab)

  • You’ll see the License Management page

– Status: “Inactive” (red)

– License key input field

– Activate License button

[Screenshot: License Management page with inactive status]

Step 3: Enter and Activate License

  • Paste your license key

– Click in the “License Key” field

– Paste the complete key (Ctrl+V or Cmd+V)

– Ensure no extra spaces before or after

  • Click Activate License

– Button processes the activation

– Takes 2-5 seconds to connect to license server

  • Verify activation success

– Status changes to “Active” (green)

– Expiration date displayed

– Site count shows (e.g., “1 of 3 sites used”)

License Activated! All Pro features are now unlocked and ready to use.

License Information Displayed

After activation, you’ll see:

Status Active (green indicator)
License Type Single Site / 3-Site / 10-Site / Unlimited
Expires Date when license renewal is due
Sites Used Number of activations / Total allowed

Verification Checklist

After installation and activation, verify:

Core Version Checks

    • Plugin appears in Plugins list as activated
    • “Attributes Access” menu item visible in admin sidebar
    • Settings page loads without errors
    • Can create a test login page with shortcode

Pro Version Checks

    • License shows “Active” status in green
    • Security tab visible in settings
    • License tab shows activation details
    • Email templates available
    • IP Management accessible
    • Audit Log page available

Troubleshooting Common Issues

Issue: “The uploaded file exceeds the upload_max_filesize directive”

Cause: Server upload limit is too small for the plugin ZIP file

Solutions:

  • Increase upload limit in php.ini:

upload_max_filesize = 64M
post_max_size = 64M
  • Or add to .htaccess:

php_value upload_max_filesize 64M
php_value post_max_size 64M
  • Or contact hosting support:

– Ask them to increase upload limits

– Most hosts can do this quickly

  • Alternative: Use FTP method

– See FTP Installation Method

Issue: “Destination folder already exists”

Cause: A previous installation attempt left files behind

Solutions:

  • Delete the existing folder:

– Go to Plugins > Installed Plugins

– Find any Attributes User Access entries

– Click Delete to remove completely

  • Or use FTP to remove:

– Connect via FTP

– Navigate to /wp-content/plugins/

- Delete attributes-user-access` folder

– Try upload again

Issue: “Pro requires Core plugin”

Symptoms: Error message after activating Pro version

Cause: Pro version is an extension and requires the Core plugin

Solution:

  • Install Core version first:

– Use WordPress Plugin Directory method

– Or manually upload Core version ZIP

– Activate Core version

  • Then install and activate Pro:

– Upload Pro ZIP file

– Activate Pro plugin

– Both will work together

How It Works: The Core plugin provides the base functionality, while Pro adds enterprise features. Both must be active to use Pro features.

Issue: License Activation Fails

Symptoms:

  • “Invalid License Key” error
  • “Connection Error” message
  • License stays inactive

Solutions:

For “Invalid License Key”:

  • Double-check for typos
  • Ensure no spaces before/after key
  • Copy key again from email
  • Contact support if key is definitely correct

For “Connection Error”:

  • Check server has cURL enabled
  • Verify firewall allows outbound connections
  • Check server can reach attributeswp.com
  • Contact hosting support for server issues

For “Maximum Activations Reached”:

  • Log in to attributeswp.com
  • Go to My Account > Licenses
  • Deactivate license on old/unused sites
  • Try activation again

What’s Next?

Now that the plugin is installed and activated:

Immediate Actions

  1. Run Initial Setup Wizard
  2. Configure Basic Settings
      • Set login/logout redirects
      • Enable/disable features you need
      • Test the configuration
  3. Explore Features
      • Create a custom login page
      • Set up role-based redirection
      • Pro: Configure security features