t2oh4e / K10rDeployment

K10rDeployment - Deployment helper plugin for Shopware 5

K10rDeployment adds some helpful console commands for automatic deployments to Shopware 5.

Usage

Install with composer

• Change to your root installation of Shopware
• Run command composer require k10r/deployment
• Make sure composer dependencies are installed during your deployment
• Activate the plugin during your deployment using the Shopware command line interface (php bin/console sw:plugin:reinstall K10rDeployment)

Zip/Git installation

• Download the ZIP or clone this repository into your engine/Shopware/Plugins/Local/Core/ folder.
• Activate the plugin during your deployment using the Shopware command line interface (php bin/console sw:plugin:reinstall K10rDeployment)
• You can now use any of the commands listed below

Commands

Compile Theme

Compiles the theme for all shops.

• Usage: php bin/console k10r:theme:compile

Deactivate a Plugin

Deactivates a given plugin.

• Usage: php bin/console k10r:plugin:deactivate <pluginName>

Install, Update and Activate a Plugin

Installs a plugin and updates it, if necessary. This command does not fail, if the plugin is already installed (the default sw:plugin:install command fails).

• Usage: php bin/console k10r:plugin:install [--activate] <pluginName>

Use the optional --activate option to activate the plugin after the installation.

Update Store Settings

Updates the settings of a subshop

• Usage/Example: php bin/console k10r:store:update [--store 1] [--name <NewStoreName] [--host new.example.com] [--path /staging] [--title "DEV! Shop"] [--theme MyAwesomeTheme]

Parameters

• store: Store ID of settings to be set, if not set, default-store will be used
• name : Sets the name of a store
• host : Sets the hostname of a store
• path : Sets the path of the store relativ to the hostname (e.g. new.example.com/staging)
• title: Sets the title of the store
• theme: Sets the theme of the store, based on the given template name

Update Theme Options

• Usage/Example: php bin/console k10r:theme:update --theme MyAweSomeTheme [--shop 1] --setting "text-color" --value "#FF0000"

Parameters

• theme : Name of the theme for settings to be set
• shop : Store ID of settings to be set, if not set, default-store will be used
• setting: Name of the setting to be set
• value : Value to be set

Check if a shopware update is necessary

Verifies if an update is needed for the application to be on a requested version. Return code 0 means an update is needed.

• Usage: php bin/console k10r:update:needed <targetVersion>

Update Configuration

• Usage/Example: php bin/console k10r:config:set [--shop 1] "noaccountdisable" "true"

Parameters

• shop : Store ID of settings to be set, if not set, default-store will be used

Arguments

• key: Name of the configuration element to be set
• value : Value to be set

License

MIT licensed, see LICENSE.md