Skip to content

wp plugin install --ignore-requirements doesn't ignore WordPress version requirements. #557

Description

@justlevine

Bug Report

Describe the current, buggy behavior

When running wp plugin install <plugin> --ignore-requirements the minimum WP version is not ignored, and the plugin fails to install.

Describe how other contributors can replicate this bug

Using woocommerce as an example. (As of writing the minimum WP version is v7.0)"

  1. Install an "unsupported" version of wordpress
    • with wp-env: WP_ENV_CORE="https://wordpress.org/wordpress-6.9.zip" npm run wp-env start -- --update
    • normal wpcli install: wp core update --version=6.9
  2. Run the command
    wp plugin install woocommerce --ignore-requirements

Output:

justl@66866806f723:/var/www/html$ wp plugin install woocommerce --ignore-requirements
Installing WooCommerce (11.1.2)
Downloading installation package from https://downloads.wordpress.org/plugin/woocommerce.11.1.2.zip...
Using cached file '/home/justl/.wp-cli/cache/plugin/woocommerce-11.1.2.zip'...
Unpacking the package...
Installing the plugin...
Warning: The package could not be installed. "Your WordPress version is 6.9, however the uploaded plugin requires 7.0."
Plugin installation failed.
Warning: The 'woocommerce' plugin could not be found.
Error: No plugins installed.

Describe what you would expect as the correct outcome

Per the docs, plugin should be installed, even though the minimum WordPress version is not met.

Let us know what environment you are running this on

justl@66866806f723:/var/www/html$ wp cli info
OS:     Linux 6.6.87.2-microsoft-standard-WSL2 #1 SMP PREEMPT_DYNAMIC Thu Jun  5 18:30:46 UTC 2025 x86_64
Shell:
PHP binary:     /usr/local/bin/php
PHP version:    8.3.35
php.ini used:   /usr/local/etc/php/php.ini
MySQL binary:   /usr/bin/mariadb
MySQL version:  mariadb from 11.8.8-MariaDB, client 15.2 for Linux (x86_64) using readline 5.1
SQL modes:
WP-CLI root dir:        phar://wp-cli.phar/vendor/wp-cli/wp-cli
WP-CLI vendor dir:      phar://wp-cli.phar/vendor
WP_CLI phar path:       phar:///usr/local/bin/wp
WP-CLI packages dir:
WP-CLI cache dir:       /home/justl/.wp-cli/cache
WP-CLI global config:
WP-CLI project config:  /var/www/html/wp-cli.yml
WP-CLI version: 2.12.0

Provide additional context/Screenshots

Add any other context about the problem here.

If applicable, add screenshots to help explain (you can just drag&drop images into the Github issue).

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions