Deutsche Version

Back to overview

Installation

Requirements

Installation

Via Shopware Store (recommended)

1. Purchase the plugin in the Shopware Store.
2. In the Shopware Admin under Extensions > My Extensions, install and activate the plugin Empty Category Messages.
3. Clear the cache.

Via Composer

1. Add the private repository

{"repositories": [{"type": "composer","url": "https://packeton.markus-michalski.net"}]}

The repository credentials are provided after the license purchase.

2. Install the plugin

composer require mmd/sw67-empty-category

3. Activate the plugin

bin/console plugin:refresh
bin/console plugin:install --activate MmdEmptyCategory
bin/console cache:clear

Via ZIP upload

1. Upload the ZIP file under Extensions > My Extensions.
2. Install and activate the plugin.
3. Clear the cache.

Manual

1. Extract the plugin folder to custom/plugins/MmdEmptyCategory.
2. Run the commands:

bin/console plugin:refresh
bin/console plugin:install --activate MmdEmptyCategory
bin/console cache:clear

What happens during installation

The plugin creates a custom field set with the technical name mmd_empty_category and assigns it to the category entity. In the Admin the set is called Empty Category, and its fields appear in the Custom Fields section of every category. The plugin has no settings page of its own under Extensions > My Extensions. Setup happens per category, see Configuration.

The plugin's styles are part of the storefront theme. After installation and activation, Shopware recompiles the theme. If the styles are missing, see Troubleshooting.

Update

On update the plugin only adds custom fields that are still missing from the existing set. Existing field definitions and the content of your categories stay unchanged. Clear the cache after the update.

Uninstallation

When uninstalling, you choose in the Admin whether the plugin data is kept.

The uninstall code does not touch the texts and images you stored on categories. The plugin sets up no cron jobs and no database tables of its own.