# Installation
Bevor du die Erweiterung aktivierst, überprüfe die Einstellungen in diesem Abschnitt und stelle sicher, dass diese deinen Anforderungen entsprechen. Nehme Änderungen an den einzelnen Feldern wie unten beschrieben vor, indem du **Meine Erweiterungen** > **Affiliate System** > **Konfiguration** wählst.
Es gibt zwei Bereiche des Affiliate System, in denen eine Konfiguration vorgenommen werden muss:
* Basis Konfiguration
* Admin Dashboard
Bitte führezuerst die Schritte der Basis Konfiguration durch und lesen anschließend im Bereich Admin Dashboard weiter.
### Basis Konfiguration
Bitte prüfe zuerst in den Einstellungen, ob diese deinen Anforderungen entsprechend. Mache entsprechende Anpassungen, die nachfolgend beschrieben werden. Wählen Sie hierfür **Meine Erweiterungen** > **Affiliate System** > **Konfigurieren**.
Gebe zunächst einen **Verkaufskanal** an, für den die Erweiterung aktiviert werden soll. Die Standardeinstellung ist „Alle Verkaufskanäle“.
### Allgemeine Einstellungen
Die allgemeinen Eigenschaften bieten grundlegende Steuerelemente, wie z. B. die Aktivierung/Deaktivierung der Erweiterung und Basiseinstellungen für Partner und deren Provision.
| Feld | Typ | Beschreibung |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| Plugin aktivieren | Toggle | Aktivieren diese Einstellung, um das Affiliate System in Ihrem Shop zu aktivieren. |
| Partner kann seinen Partner Code ändern | Dropdown |
Legen fest, ob ein Partner seinen eigenen Partner Code selbst ändern darf, indem du eine Option aus dem Dropdown-Menü auswählst: |
| – Nein: Der Partner Code kann nur durch einen Admin geändert werden | | |
| – Ja, der Code wird sofort geändert: Der neue Code wird ohne weitere Prüfung übernommen | | |
| – Ja, aber die Änderung muss durch Admin bestätigt werden: Die gewünschte Code-Änderung muss erst durch einen Admin freigegeben werden, bevor sie aktiv wird.
| | |
### Partner Registrierung
Die Einstellungen in diesem Bereich beziehen sich auf die Registrierung von Partnern.
| Feld | Typ | Beschreibung |
| ------------------------------------------------ | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Neuer Partner benötigt Freischaltung | Schalter | Aktivieren diese Einstellung um neue Partner manuell zu prüfen, bevor Sie diese freischalten. |
| Partner muss Bewerbung schreiben | Schalter | Wenn diese Einstellung aktiv ist, muss ein Kunde zur Aufnahme in das Partnerprogramm, einen kurzen Bewerbungstext schreiben. |
| Partner darf Affiliate Code selber wählen | Schalter | Ist diese Option aktiv, dann darf der Partner den Affiliate Code selber wählen. Andernfalls wird ein Zufallscode generiert. |
| Partner muss die Partner Bedingungen akzeptieren | Schalter | Aktivieren diese Einstellung, damit ein neuer Partner während der Registrierung die Partner-Bedingungen bestätigen muss. Bitte unter **Admin → Textbausteine** den Textbaustein **partner-terms** editieren und den Link zu deinen Bedingungen hinterlegen. |
| Benötigte Anzahl Tage registriert | Numerische Eingabe | Wie viele Tage muss ein Kunde mindestens registriert sein, bevor er Partner werden kann? |
| Benötigter Umsatz in EUR | Numerische Eingabe | Geben einen Mindestumsatz an, den ein Kunde erreichen muss, bevor dieser Partner werden kann. |
| Erlaubte Kundengruppen | Mehrfachauswahl | Wählen alle Kundengruppen aus, für die die Partner Registrierung aktiv sein soll. Wird keine Gruppe gewählt, so ist das Partnerprogramm nicht verfügbar. |
### Provision sammeln
Die Einstellungen in diesem Bereich, beziehen sich auf das Sammeln von Provision.
| Feld | Typ | Beschreibung |
| --------------------------------------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Partner kann Kunden von anderen Part | Schalter | Ist diese Einstellung aktiv so kann ein Kunde, der bereits einem Partner zugewiesen ist, bei Klick auf einen anderen Partnerlink abgeworben werden. |
| Lebenszeit eines Partner Cookies in Tagen | Numerische Eingabe | Bei Klick auf einen Affiliate Link, wird ein Cookie erstellt. Definieren Sie hier die Anzahl Tage, die das Cookie bestehen bleiben soll. |
| Provision Aktivierung Bestellung | Dropdown |
Legen fest, wie die Provision für eine Bestellung aktiviert wird, indem Sie eine Option aus dem Dropdown-Menü auswählen: – Immer manuell: über das Admin-Modul – Bestellung bezahlt: Die Provision wird automatisch aktiviert, nachdem die Bestellung bezahlt wurde – Bestellung abgeschlossen: Die Provision wird gutgeschrieben, sobald der Bestellstatus auf abgeschlossen gesetzt wird – Bestellung versendet: Die Provision wird gutgeschrieben, sobald die Bestellung den Status versendet hat.
|
| Aktivierungsbedingungen für Provision | Dropdown | Legen hier fest ob die Einstellung „Provision Aktivierung Bestellung“ eine **ODER** „Provision n-Tage nach Bestellung freischalten“ oder eine **UND** Bedingung ist. |
| Provision n-Tage nach Bestellung freischalten | Numerische Eingabe | Geben die Anzahl an Tagen an, die vergangen sein müssen, das die Provision einer Bestellung automatisch gutgeschrieben wird. |
| Provision abziehen bei Stornierung Bestellung | Schalter | Mit aktivierter Option wird eine Provision automatisch abgezogen, wenn die zugehörige Bestellung storniert wurde. |
### Provision abziehen
| Feld | Typ | Beschreibung |
| ------------------------------------------------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Provision entfernen bei Lieferstatus: Retour | Schalter | Mit aktivierter Option wird eine zuvor gutgeschriebene Provision automatisch abgezogen, sobald der Lieferstatus der zugehörigen Bestellung auf Retour gesetzt wird. |
| Provision entfernen bei Lieferstatus: Teilretour | Schalter | Mit aktivierter Option wird eine zuvor gutgeschriebene Provision automatisch abgezogen, sobald der Lieferstatus der zugehörigen Bestellung auf Teilretour gesetzt wird. |
### Provision Auszahlung
| Feld | Typ | Beschreibung |
| ------------------------------------- | ---- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Individueller Gutschein Code Struktur | Text | Lege das Muster fest, mit dem individuelle Gutschein-Codes erzeugt werden, wenn ein Partner seine Provision in einen Gutschein umwandelt. Jedes %s wird durch ein zufälliges Zeichen ersetzt. Der Standardwert %s%s%s%s%s erzeugt einen fünfstelligen Code. |
### Technische Einstellungen
| Feld | Typ | Beschreibung |
| ------------------------------------------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Affiliate-Link Parameter | Text (Pflichtfeld) | Lege den URL-Parameter fest, der in Affiliate-Links verwendet wird. Im Standard verwenden wir partner, sodass ein Link wie generiert wird. Bitte nicht ändern, wenn Sie bereits aktive Partner haben — andernfalls werden alle bisher genutzten Affiliate-Links ungültig. |
| Affiliate Cookie als technisch notwendig beim Cookie Consent setzen | Schalter | Aktiviere diese Einstellung, damit das Affiliate-Cookie beim Cookie Consent als technisch notwendiges Cookie registriert wird. Ist die Option deaktiviert, dann ist das Affiliate-Cookie ein optionales Cookie — Besucher, die es nicht akzeptieren, werden keinem Partner zugeordnet. |
---
# 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/plugins/affiliate-system/installation.md?ask=
```
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.