Installation

This guide covers all installation methods for CommandWise, from the simplest one-click installation to advanced deployment scenarios.

Quick Install (WordPress Admin)

The fastest way to install CommandWise:

Steps:

1. Log into WordPress admin
2. Go to Plugins → Add New
3. Search for "CommandWise"
4. Click Install Now
5. Click Activate

Time required: Under 30 seconds

Recommended Method

This is the easiest and recommended installation method for most users. WordPress handles all the file management automatically.

Manual Installation

For users who prefer manual control or are installing from a ZIP file:

Upload via WordPress Admin

1. Download the CommandWise ZIP file
2. Navigate to Plugins → Add New → Upload Plugin
3. Click Choose File and select command-wise.zip
4. Click Install Now
5. Click Activate Plugin

Upload via FTP/SFTP

For server-level access:

1. Download and extract command-wise.zip
2. Connect to your server via FTP/SFTP
3. Upload the command-wise folder to /wp-content/plugins/
4. Navigate to Plugins in WordPress admin
5. Find CommandWise and click Activate

WP-CLI Installation

For developers and those managing multiple sites:

# Install latest version
wp plugin install command-wise --activate

# Install specific version
wp plugin install command-wise --version=1.0.0 --activate

# Install on multiple sites (multisite)
wp plugin install command-wise --activate --network

Automation

WP-CLI is perfect for deployment scripts and managing multiple WordPress installations.

Composer Installation

For WordPress sites managed with Composer:

{
    "require": {
        "wpackagist-plugin/command-wise": "^1.0"
    }
}

Then run:

composer install

Activate via WordPress admin or WP-CLI:

wp plugin activate command-wise

Multisite Installation

CommandWise works great on WordPress Multisite:

Network Activation

To enable CommandWise on all sites in your network:

1. Navigate to Network Admin → Plugins
2. Find CommandWise
3. Click Network Activate

Individual Site Activation

To enable on specific sites only:

1. Navigate to Network Admin → Plugins
2. Find CommandWise and click Activate (not Network Activate)
3. Go to individual site's Plugins page
4. Activate CommandWise on desired sites

Requirements Check

Before installation, verify your environment:

Requirement	Minimum	Recommended
WordPress	6.0	Latest
PHP	7.4	8.0+
MySQL	5.6	5.7+
Browser	Modern	Latest

Browser Support:

• Chrome 90+
• Firefox 88+
• Safari 14+
• Edge 90+

Checking Your Environment

Check PHP Version:

php -v

Check WordPress Version:

• Dashboard → Updates
• Or via WP-CLI: wp core version

Check MySQL Version:

mysql --version

Post-Installation

Verify Installation

After activation:

1. ✅ Look for CommandWise icon in admin bar
2. ✅ Press Cmd/Ctrl + K to open command palette
3. ✅ Search should show your admin menu items

First Configuration

CommandWise works out of the box with sensible defaults:

• Keyboard Shortcut: Cmd + K (Mac) or Ctrl + K (Windows/Linux)
• Theme: Auto-matches WordPress admin colors
• Menu Items: Automatically detects all admin pages

No configuration needed to start using CommandWise!

Updating

Automatic Updates

WordPress notifies you when updates are available:

1. Go to Dashboard → Updates
2. Find CommandWise in the plugin list
3. Click Update Now

Manual Update

To manually update:

1. Deactivate (but don't delete) the current version
2. Delete the old plugin files
3. Install the new version using any installation method
4. Activate the plugin

Backup First

Always backup your site before updating plugins, especially on production sites.

WP-CLI Update

# Update CommandWise
wp plugin update command-wise

# Update all plugins
wp plugin update --all

Uninstallation

Standard Removal

To completely remove CommandWise:

1. Navigate to Plugins
2. Deactivate CommandWise
3. Click Delete
4. Confirm deletion

All plugin files and database entries will be removed.

WP-CLI Removal

# Deactivate and uninstall
wp plugin deactivate command-wise
wp plugin uninstall command-wise

Troubleshooting Installation

Installation Fails

Error: "Could not create directory"

• Cause: Insufficient file permissions
• Solution: Check that WordPress can write to /wp-content/plugins/
• Fix: Set proper permissions: chmod 755 /wp-content/plugins/

Error: "Plugin requires PHP 7.4+"

• Cause: Server running older PHP version
• Solution: Upgrade PHP through your hosting control panel
• Contact: Your hosting provider for PHP upgrade assistance

Activation Issues

White Screen After Activation

• Cause: PHP error or plugin conflict
• Solution:
  1. Access server via FTP
  2. Rename /wp-content/plugins/command-wise/ to disable it
  3. Check error logs
  4. Contact support with error details

Plugin Not Visible

• Cause: Extraction/upload issue
• Solution: Ensure the plugin folder is at /wp-content/plugins/command-wise/
• Check: Files should be in command-wise/, not command-wise/command-wise/

Permission Issues

If you see permission errors:

# Set correct ownership (replace user:group)
chown -R www-data:www-data /wp-content/plugins/command-wise/

# Set correct permissions
chmod -R 755 /wp-content/plugins/command-wise/

Network/Hosting Specific

WordPress.com

CommandWise is available for WordPress.com Business and eCommerce plans that support plugin installation.

Managed WordPress Hosts

CommandWise works with all major managed WordPress hosts:

• WP Engine
• Kinsta
• Flywheel
• Cloudways
• SiteGround
• Bluehost

No special configuration needed.

Local Development

CommandWise works great with local development tools:

• Local by Flywheel: Install normally
• XAMPP: Install normally
• Docker/Docker Compose: Mount or copy plugin folder
• WP-CLI: Use wp plugin install as shown above

Next Steps

Successfully installed? Great! Here's what to do next:

• Getting Started Guide - Learn the basics
• Features Overview - See what CommandWise can do
• Keyboard Shortcuts - Master the shortcuts

Ready to start using CommandWise? Continue to Getting Started →