Plugin Management Commands
The following commands are used for managing plugins within your Winter installation.
Download and install a plugin for Winter
php artisan plugin:install <plugin code>
plugin:install command downloads and installs the plugin by its plugin code in the format AuthorName.PluginName. You can retrieve the plugin code through the Winter marketplace.
Note that your installation should be bound to a project in order to use this command. You can create projects on the Winter website, in the Account / Projects section.
NOTE: If you have already have the plugin files locally either through Composer or manually uploading them, you can just run
winter:upto run the plugin's pending migrations to "install" it. This command is mostly meant for installing plugins sourced from the Winter CMS Marketplace.
List installed plugins
php artisan plugin:list
plugin:list command will generate a table of installed plugins in your Winter installation, including the version installed, whether the plugin is enabled or disabled and if updates are frozen for the plugin or not.
Each plugin is listed by its plugin code, allowing you to use the code for other plugin commands listed here.
Refresh a plugin
php artisan plugin:refresh <plugin code>
plugin:refresh command allows you to rollback a plugin, destroying its database records and tables, and re-run all updates on the plugin. This is a destructive action. You will be prompted to confirm the action before proceeding.
This command is made available mainly for plugin development.
Rollback a plugin
php artisan plugin:rollback <plugin code> [version]
plugin:rollback command allows you to rollback a plugin, optionally to a specified version. It can be useful for rolling back a plugin which has introduced an error in your Winter installation, rolling it back to a version that worked previously. This is a destructive action. You will be prompted to confirm the action before proceeding.
version argument is optional - if it is not specified, the plugin is rolled back completely.
Enable a plugin
php artisan plugin:enable <plugin code>
plugin:enable command allows you to enable a previously disabled plugin. The plugin will be able to function in your Winter installation once more.
Disable a plugin
php artisan plugin:disable <plugin code>
plugin:disable command allows you to disable a previously enabled plugin. The plugin will no longer function in your Winter installation. If the plugin disabled is a requirement of another plugin installed, that plugin will also be disabled.
Remove a plugin
php artisan plugin:remove <plugin code>
plugin:remove command allows you to remove a plugin installed on your Winter CMS installation. This will remove both the files for the plugin, and the database records and tables. This is a destructive action. You will be prompted to confirm the action before proceeding.