# Wordpress Plug-In

**Richtet sich an:** Kooperationspartner eines Gutscheinnetzwerkes

**Kurzbeschreibung:** Mit diesem WordPress Plugin können Sie die Geschäfte Ihres Gutscheinnetzwerkes (Netzwerk) in Ihre WordPress Seite integrieren. Somit können Besucher Ihrer Webseite nach Geschäften suchen und sich Details für jedes Geschäft anschauen.

**Sie brauchen:** Einen API Key für Ihr Netzwerk. Einen Link zum Gutschein Checkout. Und das Zmyle Wordpress Plugin als Bundle. Wenden Sie sich diesbezüglich bitte an unseren Support: <support@zmyle.de>.

## Beschreibung

Hauptbestandteil des Plugins ist eine Liste von Geschäften (Suchergebnisse). In dieser Liste werden die einzelnen Geschäfte in Form von Suchergebnissen dargestellt. Für jedes einzelne Geschäft gibt es dann eine Detailseite, welche durch einen Link auf ein Suchergebnis erreicht wird.

Oben über den Suchergebnissen wird ein Textfeld für Suchbegriffe sowie ein paar weitere Suchfilter (optional) angezeigt. Die Suchergebnisse können dadurch manipuliert werden sodass die Geschäfte nach versch. Kriterien sortiert und/oder ausgeblendet werden können.

## Installation

### Plugin download

{% file src="/files/aTE33ieTCNjCUUVPgVYn" %}

### Plugin installieren

1. In Ihrem WordPress Adminbereich wechseln Sie auf die Plugin Seite
2. Klicken Sie den Button "Installieren"
3. Auf der folgenden Seite klicken Sie "Plugin hochladen"
4. Wählen Sie die ZIP-Datei mit dem Zmyle Wordpress Plugin Bundle und klicken Sie dann auf "Jetzt installieren"
5. Nach erfolgreicher Installation aktivieren Sie das Plugin durch klicken des Buttons "Plugin aktivieren"

### API Key konfigurieren

In Ihrem WordPress Adminbereich gehen Sie auf der linken Seite im Menu auf "Einstellungen" > "Zmyle". Auf der folgenden Seite finden Sie zwei Eingabefelder für "API Key' und für "API Secret". Tragen Sie hier entspr. die API Keys ein die Sie von uns zur Verfügung gestellt bekommen haben.

Im Feld "Stadtgutschein Checkout" tragen Sie den entspr. Checkout Link ein den Sie von uns zur Verfügung gestellt bekommen haben.

Speichern Sie die Einstellungen.

### Plugin in die Seiten einbinden

Die Einbindung des Plugins erfolgt über einen Shortcode. Am besten legen Sie für das Plugin eine neue Seite an. Danach gehen Sie wie folgt vor:

1. Gehen Sie in den Content-Editor der Seite
2. Geben Sie den Shortcode `[Zmyle]` ein
3. Speichern und veröffentlichen Sie die Änderungen

![](/files/-MjVm-Jg7ukdRQJ12Ltm)

Wenn Sie sich nun die Live Version der Seite anschauen dann sehen Sie die Liste mit den Geschäften.

## Konfiguration

Das Plugin hat die folgenden Einstellungen die Sie konfigurieren können:

* **"Zeige Akzeptanzstellenfilter":** aktiviert einen weiteren Filter, sodass Besucher Ihrer Webseite sich nur Akzeptanzstellen anzeigen lassen können.
* **"Nur Akzeptanzstellen anzeigen":** deprecated. Bitte lassen Sie diese Einstellung auf Ihrem Standartwert stehen.
* **"Zeige Detailseiten":** Stellen Sie auf "Ja" wenn die Suchergebnisse auf die Detailseiten verlinken sollen.

## Templates und WordPress Themes

Die Darstellung der Suchergebnisse und der Detailseiten in diesem Plugin sind in Templates hinterlegt. Sie können unsere standard Templates in Ihrer WordPress Theme überschreiben und somit die Darstellung Ihren eigen Wünschen anpassen. Gehen Sie dazu wie folgt vor:

1. Entpacken Sie das zmyle WordPress Plugin Bundle (zip Datei).
2. In dem Bundle befindet sich ein Ordner "public" und darin ein weiterer Ordner "templates". Dies sind die standard Templates für das Plugin.
3. Legen Sie in Ihrer eigenen Theme einen neuen Ordner an: "zmyle-templates" und kopieren Sie die standard Templates in diesen Ordner.&#x20;
4. Das Plugin verwendet nun die Templates aus dem Ordner in Ihrer Theme. Sie können diese Templates nun nach belieben anpassen.

## Gutscheinkauf und -versand

Den online Gutscheinkauf und -versand ermöglichen Sie am besten mit unserem Magic-Checkout-Link. Alle Infos dazu finden hier:

{% embed url="<https://support.zmyle.de/stores-fuer-akzeptanzstellen/verwaltung/marketing/magic-checkout>" %}


---

# 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://networks-docs.zmyle.de/hilfreich/wordpress-plug-in.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.
