# Installation

## Requirements

- Shopware **6.6** or **6.7**
- Permission to install plugins in the administration (or assistance from your agency)
- Afterbuy **User Token** and **Partner Token** (Afterbuy account → show access data)

## Installing the plugin

### ZIP upload in the administration

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 NetzkollektivAfterbuy
bin/console cache:clear
```

## After installation

1. Open the **Afterbuy** plugin settings.
2. Enter **User Token** and **Partner Token** and verify them with the test button.
3. Enable the **interface**.
4. Configure transfer and order status options — see {doc}`usage`.
5. Ensure the **message queue** / scheduled tasks are running.

**Note:** On installation, existing orders are tagged `afterbuy-processed` so only new orders are exported.

If you run a **persistent** message consumer (`messenger:consume`), restart it after install/update so new handlers and tasks are loaded.

## Uninstallation

Standard Shopware plugin rules apply. Tags and comment entries on orders remain unless cleaned up separately.