# Installation

## Requirements

- Shopware **6.6** or **6.7**
- Permission to install plugins in the administration (or assistance from your agency)

## Installing the plugin

### Via the Shopware Store (recommended)

The easiest way to obtain and install the extension:

1. Open the product page at NETZKOLLEKTIV: [Manual product sorting for Shopware 6](https://netzkollektiv.com/extension-store/manuelle-produktsortierung-shopware-extension)
2. There you will find licensing details and the **Buy in Shopware Store** link to the official [Shopware Store](https://store.shopware.com/).
3. Purchase the extension (including a free trial period if offered) and add it to your shop.
4. In the administration: **Settings → System → Plugins → My extensions** — **install** and **activate** the extension.
5. Clear the cache if the shop does not do so automatically.

The extension can also be used without direct Shopware Store access; see the [product page](https://netzkollektiv.com/extension-store/manuelle-produktsortierung-shopware-extension) for details.

### ZIP upload in the administration

If you received the extension as a ZIP file (e.g. from your agency):

1. Go to **Settings → System → Plugins → My extensions**
2. **Upload** the plugin ZIP
3. **Install** and **activate** the plugin
4. Clear the cache if the shop does not do so automatically

### Via command line (optional)

If your agency has already placed the plugin under `custom/plugins/`:

```bash
bin/console plugin:refresh
bin/console plugin:install --activate NetzkollektivManualProductSort
bin/console cache:clear
```

## After installation

1. Open a **category** and go to the **Product Sorting** tab.
2. Configure sorting in the shop — see {doc}`usage` → *Storefront sorting*.

On first installation, the **Recommendation** sorting option is created (German admin label: *Empfehlung*). Assign it to your sales channels in the shop settings.

## Uninstallation

Standard Shopware plugin rules apply. Saved sort positions remain in the database unless your agency removes them separately.