# Installation

Nach der Installation der App, muss diese unter **Erweiterungen -> Meine Erweiterungen -> Apps -> Prämienartikel App** konfiguriert werden.

<figure><img src="/files/1nBiLLdUsYSMIW9SsxVv" alt=""><figcaption></figcaption></figure>

Gebe zunächst einen **Verkaufskanal** an, für den die App aktiviert werden soll. Die Standardeinstellung ist **Alle Verkaufskanäle**.

### Allgemeine Einstellungen

Die allgemeinen Eigenschaften bieten grundlegende Steuerelemente, wie z. B. die Aktivierung/Deaktivierung der App.

| Feld                                                                     | Typ             | Beschreibung                                                                                            |
| ------------------------------------------------------------------------ | --------------- | ------------------------------------------------------------------------------------------------------- |
| App aktivieren                                                           | KippSch.        | Aktivieren diese Einstellung, um die App in deinem Shop zu aktivieren.                                  |
| Im Off-Canvas anzeigen                                                   | Dropdown-Menü   | Lege fest wie und ob die Prämien im OffCanvas Warenkorb angezeigt werden sollen.                        |
| Im Warenkorb anzeigen                                                    | Dropdown-Menü   | Wähle einen Eintrag aus der Liste um die Anzeige der Prämien im Warenkorb festzulegen.                  |
| Auf der Bestellübersicht anzeigen                                        | Dropdown-Menü   | Durch Auswahl eines Eintrages kannst du die Anzeige der Prämien auf der Bestellübersichtsseite steuern. |
| Kundengruppe verbieten                                                   | Mehrfachauswahl | Sperre die Prämien für ausgewählte Kundengruppen.                                                       |
| Produkte von der Berechnung des Mindestpreises im Warenkorb ausschließen | Mehrfachauswahl | Ausgewählte Produkte werden von der Berechnung des Mindestpreises im Warenkorb ausgeschlossen.          |

### Prämienartikel Einstellungen

Mit den folgenden Einstellungen kann festgelegt werden, wie viele Prämienartikel erlaubt sind und wie die Berechnung des Mindest Warenkorbwertes erfolgen soll.

| Feld                                    | Typ      | Beschreibung                                                                                                                                            |
| --------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Nur eine Art Prämienartikel erlauben    | KippSch. | Es kann nur eine Prämie ausgewählt werden. Die Menge der Prämie ist variabel und wird durch die Einstellungen am Produkt (max. Bestellmenge) gesteuert. |
| Netto Warenkorbwert nutzen              | KippSch. | Wenn eine Prämie einen Mindestbestellwert hat, wird standardmäßig der Brutto Warenkorbwert genutzt.                                                     |
| Warenkorbwert ohne Versandkosten nutzen | KippSch. | Kann nicht mit der Einstellung "Netto Warenkorbwert nutzen" kombiniert werden                                                                           |

### Slider Einstellungen

In diesem Bereich kann eingestellt werden, welche Informationen zu Prämienartikeln angezeigt werden sollen.

| Feld                          | Typ      | Beschreibung                                                         |
| ----------------------------- | -------- | -------------------------------------------------------------------- |
| Produkt Titel anzeigen        | KippSch. | Wenn aktiviert, wird der Titel des Produktes einer Prämie angezeigt. |
| Produkt Beschreibung anzeigen | KippSch. | Aktiviere die Anzeige der Produkt Beschreibung für eine Prämie.      |


---

# 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/apps/pramienartikel-gratisartikel/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.