Craft CMS

Das Wink Craft CMS Plugin integriert Wink Reiseinventar in Craft 5 über Twig-Template-Funktionen und einen benutzerdefinierten Feldtyp für den Content-Editor. Redakteure können direkt im Eintragseditor ein bestimmtes Wink-Layout aus einem Dropdown-Menü auswählen.

wink-travel/wink-craft-plugin auf GitHub Quellcode, Entwickler-Setup-Anleitung und Beitragsanweisungen.

Anforderungen

Craft CMS 5.x
PHP 8.1+
Composer

Installation

Installation über Composer:
Terminal-Fenster
```
composer require wink2travel/craft-wink
```
Aktivieren Sie das Plugin im Control Panel unter Einstellungen → Plugins oder über die CLI:
Terminal-Fenster
```
php craft plugin/install wink
```
Gehen Sie im Control Panel zu Einstellungen → Wink.
Geben Sie Ihre Client ID und Client Secret ein, wählen Sie Ihre Umgebung aus und klicken Sie auf Speichern. Rufen Sie Ihre Zugangsdaten unter Applications ab.

Verwendung in Twig-Templates

Nach der Konfiguration können Sie Wink Twig-Funktionen überall in Ihren Templates aufrufen:

{# Rendert ein Hotelraster #}
{{ winkContent('HOTEL', entry.winkLayoutId) }}

{# Suchleiste für Reiseziele #}
{{ winkLookup() }}

{# Button für Reiseplan-Auswahl #}
{{ winkSearch() }}

{# Benutzerkonto-Button #}
{{ winkAccount() }}

Die Funktion winkContent() fügt beim ersten Aufruf auf einer Seite automatisch <wink-app-loader> ein.

Verfügbare Twig-Funktionen

Funktion	Ausgabe	Beschreibung
`winkContent(layout, id)`	`<wink-content-loader>`	Hotelkarten, Raster, Karten
`winkLookup()`	`<wink-lookup>`	Suchleiste für Reiseziele
`winkSearch()`	`<wink-search-button>`	Button für Reiseplan-Auswahl
`winkAccount()`	`<wink-account-button>`	Anmeldung / Benutzerkonto
`winkItinerary()`	`<wink-itinerary-button>`	Button für Reiseplan-Status
`winkShoppingCart()`	`<wink-shopping-cart-button>`	Warenkorb-Button

Wink Layout Feldtyp

Fügen Sie einem beliebigen Bereich ein Wink Layout-Feld hinzu, damit Redakteure ein Dropdown mit allen verfügbaren Layouts aus Ihrem Wink-Konto erhalten:

Gehen Sie zu Einstellungen → Felder → Neues Feld.
Setzen Sie den Feldtyp auf Wink Layout.
Fügen Sie das Feld dem Feldlayout Ihres Eintragstyps hinzu.
Redakteure können nun direkt im Eintragseditor ein Layout auswählen – kein Kopieren und Einfügen von IDs mehr.

Übergeben Sie im Template den Feldwert an winkContent():

{{ winkContent(entry.winkLayout.type, entry.winkLayout.id) }}