Skip to content

cwp plugins

shipped 1.0.0
cwp plugins [flags]

cwp plugins groups the commands below and takes no action of its own; run it alone and it prints its help.

SubcommandWhat it does
cwp plugins snapshotWrite plugins.yml from what is installed (read-only against the site)
cwp plugins applyInstall, activate and deactivate to match plugins.yml

What it does

Keeps the record of which plugins and themes a working copy of this site needs, so a fresh clone is not an empty docroot.

snapshot writes plugins.yml from what is installed. apply installs what is missing and activates or deactivates to match — “reproducible” means the same plugins on, not merely present.

Three things are deliberately absent from the file:

  • anything under tracked — your site plugin is deployed, not installed, and listing it would invite apply to fetch a wordpress.org plugin sharing the slug;
  • must-use plugins, two of which cwp generates itself;
  • drop-ins, which are placed by hosting.

Omitting the environment means the local site.

What it does not do

It fetches no premium plugins, stores no licence keys and updates nothing.

It is not cwp fetch. fetch copies the plugin files down so a fresh checkout renders; plugins records and reproduces which plugins should be installed and active. One is transport, the other is intent.