Craft CMS

Wink Craft CMS Plugin integruje inwentarz podróży Wink z Craft 5 poprzez funkcje szablonów Twig oraz niestandardowy typ pola dla edytora treści. Redaktorzy mogą wybrać konkretny układ Wink z listy rozwijanej bezpośrednio w edytorze wpisów.

wink-travel/wink-craft-plugin na GitHub Kod źródłowy, przewodnik dla deweloperów oraz instrukcje dotyczące współpracy.

Wymagania

Craft CMS 5.x
PHP 8.1+
Composer

Instalacja

Zainstaluj przez Composer:
Okno terminala
```
composer require wink2travel/craft-wink
```
Aktywuj wtyczkę w Panelu Sterowania w Ustawienia → Wtyczki lub przez CLI:
Okno terminala
```
php craft plugin/install wink
```
Przejdź do Ustawienia → Wink w Panelu Sterowania.
Wprowadź swój Client ID i Client Secret, wybierz środowisko i kliknij Zapisz. Aby pobrać dane uwierzytelniające, przejdź do Applications.

Użycie w szablonach Twig

Po konfiguracji wywołuj funkcje Twig Wink w dowolnym miejscu swoich szablonów:

{# Renderuj siatkę hoteli #}
{{ winkContent('HOTEL', entry.winkLayoutId) }}

{# Pasek wyszukiwania destynacji #}
{{ winkLookup() }}

{# Przycisk wyboru planu podróży #}
{{ winkSearch() }}

{# Przycisk konta użytkownika #}
{{ winkAccount() }}

Funkcja winkContent() automatycznie wstrzykuje <wink-app-loader> przy pierwszym wywołaniu na stronie.

Dostępne funkcje Twig

Funkcja	Wyjście	Opis
`winkContent(layout, id)`	`<wink-content-loader>`	Karty hoteli, siatki, mapy
`winkLookup()`	`<wink-lookup>`	Pasek wyszukiwania destynacji
`winkSearch()`	`<wink-search-button>`	Przycisk wyboru planu podróży
`winkAccount()`	`<wink-account-button>`	Logowanie / konto użytkownika
`winkItinerary()`	`<wink-itinerary-button>`	Przycisk statusu planu podróży
`winkShoppingCart()`	`<wink-shopping-cart-button>`	Przycisk koszyka

Typ pola Wink Layout

Dodaj pole Wink Layout do dowolnej sekcji, aby dać redaktorom listę rozwijaną ze wszystkimi dostępnymi układami z Twojego konta Wink:

Przejdź do Ustawienia → Pola → Nowe pole.
Ustaw Typ pola na Wink Layout.
Dodaj pole do układu pól swojego typu wpisu.
Redaktorzy mogą teraz wybierać układ bezpośrednio w edytorze wpisów — bez kopiowania i wklejania ID.

W szablonie przekaż wartość pola do winkContent():

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