# Installation

Install the plugin via **Extensions > My Extensions**. After installation, specify a sales channel for which the plugin should be activated. The default setting is **All Sales Channels**.

The Stock Reminder plugin has two aspects:

1. **Basic Configuration** – Settings for the behavior of the notification form and emails.
2. **Management Dashboard** – Overview of subscriptions and statistics in the administration area.

First, follow the steps in the Basic Configuration section, then read the Management Dashboard section to learn how to manage the plugin on an ongoing basis.

## Basic Configuration

Before activating the plugin, review the settings in this section and make sure they match your requirements. Make changes to individual fields by navigating to **My Extensions > Stock Reminder > Configuration**.

First, specify a sales channel for which the plugin should be activated. The default setting is **All Sales Channels**.

### General Settings

The general settings provide basic controls such as activating the plugin and configuring the notification form.

| Field                   | Type   | Description                                                                                                                                                                                                                                                                                                                                   |
| ----------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Plugin active           | Toggle | Enables or disables the stock notification service for the selected sales channel.                                                                                                                                                                                                                                                            |
| Hide add-to-cart button | Toggle | When enabled, the add-to-cart button is hidden for out-of-stock products and only the notification form is shown. When disabled, the add-to-cart button is shown alongside the notification form. Enabled by default.                                                                                                                         |
| Enable Double Opt-In    | Toggle | When enabled, the visitor must verify their email address via a confirmation link before the notification is activated. When disabled, the notification becomes active immediately after form submission. Disabling this can reduce friction for users but carries the risk of abuse through third-party email addresses. Enabled by default. |
| Hide quantity field     | Toggle | When enabled, the quantity field is hidden in the notification form. The notification will automatically use the product's configured minimum order quantity. This simplifies the form when the desired quantity is not relevant.                                                                                                             |

### Product Groups

Using dynamic product groups, you can flexibly control which products display the notification form and under which conditions the notification email is sent.

| Field                                          | Type      | Description                                                                                                                                                                                                                                                                                |
| ---------------------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Display condition (Dynamic product group)      | Selection | Defines which products display the notification form. Only products matching the conditions of this dynamic product group will show the form. If left empty, the form is shown by default for all products with a stock of 0 or less.                                                      |
| Notification condition (Dynamic product group) | Selection | Defines the conditions under which the notification email is actually sent. Only when a product with active subscriptions matches the conditions of this dynamic product group will the email be triggered. If left empty, notifications are sent by default when stock is greater than 0. |

> **Display condition example:** Create a dynamic product group with the condition "Available stock is less than or equal to 0" to replicate the default behavior, or add further conditions like category or manufacturer.

> **Notification condition example:** Create a dynamic product group with the conditions "Active is Yes AND Available stock is greater than 3" to only notify once a certain stock level is reached.

### Cleanup

| Field                                        | Type          | Description                                                                                                                                                                                                            |
| -------------------------------------------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Delete old subscription entries after (days) | Numeric input | Notified subscription entries will be automatically deleted after the specified number of days. Set to 0 to never delete entries automatically. Default: 30 days. This setting applies globally to all sales channels. |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.premsoft.de/en/plugins/back-in-stock-notification/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.