← previous / Installation Methods

Installation Methods

Choose the installation method that best fits your deployment workflow. All methods securely connect your WordPress site to the Wp Admin management platform for centralized monitoring, updates, and optimization.

✓ Latest Version: 3.8.2
đŸ“Ļ

WordPress DashboardRecommended for most users

  • Download the Plugin

    Navigate to the Wp Admin client portal and download the latest plugin zip file from your account dashboard.

  • Upload & Activate

    Go to Plugins → Add New → Upload Plugin. Select the zip file, install, and click Activate.

  • Connect Your Site

    Enter your unique Site ID and API Token provided in the Wp Admin dashboard. Click Connect to establish the secure management link.

    // Settings → Wp Admin → Connection Site ID: site_wp_8x92k1 API Token: tok_live_9a7b3c...

  • Verify Status

    Return to the plugin settings page. You should see a green "Connected & Monitoring" status indicator.

ℹī¸
This method requires WordPress admin access. The plugin will not modify your theme or existing plugins.
📡

FTP / SFTP UploadFor manual or restricted environments

  • Prepare Plugin Files

    Extract the downloaded zip file. You should see a folder named wp-admin-manager.

  • Upload via FTP

    Connect to your server via FTP/SFTP and navigate to /wp-content/plugins/. Upload the extracted folder.

    cd /wp-content/plugins/ put -r wp-admin-manager/

  • Activate via Dashboard

    Log into your WordPress admin panel, go to Plugins, locate Wp Admin Manager, and activate it.

  • Complete Setup

    Follow the on-screen wizard to paste your credentials and configure management preferences.

⚠ī¸
Ensure file permissions are set to 644 for files and 755 for directories to prevent security vulnerabilities.
đŸ’ģ

WP-CLI InstallationFor developers & CI/CD pipelines

  • Download Plugin

    Run the installation command directly in your server terminal with WP-CLI access.

    wp plugin install wp-admin-manager --activate wp option update wpadmin_site_id "site_wp_8x92k1" wp option update wpadmin_api_token "tok_live_9a7b3c..."

  • Verify Connection

    Test the management handshake and retrieve the current status.

    wp wpadmin status # Expected: ✓ Connected | Monitoring Active | Uptime: 99.99%
🚀
WP-CLI deployment is fully compatible with GitHub Actions, GitLab CI, and automated provisioning scripts.
🔗

Auto-Provisioning (API)For agencies & hosting providers

  • Generate Provisioning Key

    In your Wp Admin dashboard, navigate to Settings → API → Provisioning and generate a new server key.

  • Trigger Webhook

    Send a POST request to your WordPress site to auto-install and configure the management agent.

    curl -X POST https://yoursite.com/wp-json/wpadmin/v1/provision \\ -H "Authorization: Bearer prov_key_x7k9m2" \\ -H "Content-Type: application/json" \\ -d '{"auto_activate": true, "env": "production"}'

  • Automatic Registration

    The site will automatically appear in your Wp Admin dashboard under Managed Sites within 60 seconds.

Common Issues & Solutions

Connection fails with 403 error

Ensure your server allows outbound HTTPS connections to api.wpadmin.com. Check firewall/cloudflare rules.

Plugin shows "Inactive" after install

Verify PHP version >= 7.4 and memory limit >= 128M. Increase WP_MEMORY_LIMIT if needed.

WP-CLI returns command not found

Install WP-CLI via curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar and configure your PATH.

Dashboard not syncing data

Clear your site's object cache and verify the API token hasn't expired. Re-authenticate if necessary.