# 2. Installation

## Installing the Plugin

### Via the Shopware Store (recommended)

1. Purchase the plugin from the Shopware Store.
2. Log in to your Shopware admin.
3. Go to **Extensions → My Extensions**.
4. Find **Advanced Wishlists** and click **Install**.
5. Activate the plugin using the toggle in its row.
6. Clear the cache under **Settings → System → Caches & Indexes → Clear cache**.

### Manual installation via ZIP

1. Download the plugin ZIP file.
2. Go to **Extensions → My Extensions**.
3. Click **Upload extension** and select the ZIP file.
4. Install and activate the plugin as described above.
5. Clear the cache.
6. If storefront assets are not built automatically, run **bin/console theme:compile**.

## First Steps After Activation

Core features are available immediately after activation:

* The heart icon appears on product cards and product detail pages.
* Logged-in customers find their wishlist overview under **My Account → My Wishlists**.
* Merchants find the admin overview under **Customers → Wishlists**.

Review and adjust the plugin settings to fit your shop (see [Configuration](https://docs.momocode.de/en/shopware-6/advanced-wishlists/3.-configuration)).

## Notes

### Relationship to Shopware's Native Wishlist

The plugin operates independently alongside Shopware's native wishlist and does not disable it automatically. If you want to use only the plugin, disable the native feature under **Settings → Shop → Cart → Enable wishlist**.

### Scheduled Task Worker

For automatic price-drop notifications, the Shopware Scheduled Task Worker must be running:

```bash
bin/console messenger:consume scheduled_task
```

Make sure this process runs continuously (e.g. via a Supervisor daemon or cron job).

## Migrating Existing Native Wishlists

If your shop already has native Shopware wishlists, you can migrate them using the included console command.

> **Note:** This command migrates **native Shopware wishlists** only. Migration from other wishlist plugins is not officially supported. If you are switching from a different plugin and would like to bring your data over, [get in touch](https://momocode.de) — I'm happy to help with the migration personally.

```bash
bin/console momo:wishlists:migrate-native [--name=<name>] [--delete-native] [--dry-run]
```

| Option            | Description                                                         |
| ----------------- | ------------------------------------------------------------------- |
| `--name`          | Name for the migrated wishlists (interactive prompt if omitted)     |
| `--delete-native` | Automatically deletes native wishlists after a successful migration |
| `--dry-run`       | Previews the migration without writing any data                     |

**Recommended approach:**

1. Run with `--dry-run` first and review the output.
2. Run the actual migration without `--dry-run`.
3. Verify that all wishlists have been migrated correctly.
4. Optionally use `--delete-native` or remove native wishlists manually.

> **Note:** The command is not idempotent. Run it only once to avoid duplicate entries.