# 2. Installation

## Installing the plugin

### Via the Shopware Store

1. Log in to the Shopware Admin.
2. Navigate to **Extensions → Store**.
3. Search for "Accessory Lock" and click **Install**.
4. Go to **Extensions → My Extensions**.
5. Click **Activate** next to the plugin.

### Manual installation (ZIP file)

1. Log in to the Shopware Admin.
2. Navigate to **Extensions → My Extensions**.
3. Click **Upload extension** in the top right and select the ZIP file.
4. Click **Install**, then **Activate**.

## First steps after activation

The plugin is ready to use immediately after activation. No additional setup is required before you can create your first accessory locks.

1. Navigate to **Catalogues → Products** and open the product you want to lock as an accessory.
2. Click the **Accessory Lock** tab.
3. In the **"Required Main Products"** section, add at least one main product.
4. Save the product.

From this point on, the accessory can only be added to a completed order if at least one of the assigned main products is also in the cart.

## Notes

* Compatible with **Shopware \~6.6.0** (plugin 1.x) and **Shopware \~6.7.0** (plugin 2.x). Requires **PHP 8.2+**.
* On uninstall, all plugin data is removed unless you choose **"Keep user data"**.
* No external services or API connections are required.