Varying Vagrant Vagrants logo Varying Vagrant Vagrants

WP-CLI is the command-line interface for WordPress. You can update plugins, configure multisite installations and much more, without using a web browser.

With this tool is possible to manage the websites installed, like changing the password of the users or export the database. This tool is used inside VVV from the default provisioners and internals and is very powerful.

VVV includes the nightly version of WP-CLI, but if you want to contribute to WP CLI development, you can install the `wpcli-dev utility.

Examples

wp db import ~/db-export.sql # VVV automatically generated database bbackups on halt
wp search-replace http://olddomain.com https://newdomain.com --export=newdb.sql --all-tables # Generate a dump with the url replaced
wp media regenerate # Regenerate all the thumbnails and the various images
wp post generate --count=10 # Create posts with dummy content

Contribute to WP-CLI

VVV include an utility to install the official dev environment with all the various repo from https://github.com/wp-cli/wp-cli-dev/. To use this new instance replace wp with wp-dev.

Right now to use this, SSH into the virtual machine using vagrant ssh.

From the WP-CLI dev folder it is possible to run the unit tests of the various commands:

Unit test

composer behat # all the unit tests of a command
composer behat -- ./features/yourtest.feature # for a specific test

WP-CLI has exhaustive documentation on about how to contribute.

We recommend adding a new git remote to the repository, so that you can push changes to GitHub for pull requests.

Resources

There are already a lot of guides about WP CLI: