Craft CMS

A Wink Craft CMS Plugin integrálja a Wink utazási készletet a Craft 5-be Twig sablonfüggvényeken és egyedi mezőtípuson keresztül a tartalomszerkesztő számára. A szerkesztők közvetlenül a bejegyzésszerkesztőben egy legördülő menüből választhatnak ki egy adott Wink elrendezést.

wink-travel/wink-craft-plugin a GitHubon Forráskód, fejlesztői telepítési útmutató és hozzájárulási útmutatók.

Követelmények

Craft CMS 5.x
PHP 8.1+
Composer

Telepítés

Telepítés Composerrel:
Terminál
```
composer require wink2travel/craft-wink
```
Aktiválja a plugint a Vezérlőpulton a Beállítások → Bővítmények menüpont alatt, vagy CLI-n keresztül:
Terminál
```
php craft plugin/install wink
```
Lépjen a Vezérlőpulton a Beállítások → Wink menüpontra.
Adja meg a Client ID és Client Secret értékeket, válassza ki a környezetet, majd kattintson a Mentés gombra. A hitelesítő adatok megszerzéséhez látogasson el az Alkalmazások oldalra.

Használat Twig sablonokban

A beállítás után bárhol meghívhatja a Wink Twig függvényeket a sablonjaiban:

{# Szállodák rács megjelenítése #}
{{ winkContent('HOTEL', entry.winkLayoutId) }}

{# Úti cél keresősáv #}
{{ winkLookup() }}

{# Útvonalválasztó gomb #}
{{ winkSearch() }}

{# Felhasználói fiók gomb #}
{{ winkAccount() }}

A winkContent() függvény automatikusan beszúrja az első híváskor az oldalon a <wink-app-loader> elemet.

Elérhető Twig függvények

Függvény	Kimenet	Leírás
`winkContent(layout, id)`	`<wink-content-loader>`	Szállodakártyák, rácsok, térképek
`winkLookup()`	`<wink-lookup>`	Úti cél keresősáv
`winkSearch()`	`<wink-search-button>`	Útvonalválasztó gomb
`winkAccount()`	`<wink-account-button>`	Bejelentkezés / felhasználói fiók
`winkItinerary()`	`<wink-itinerary-button>`	Útvonal állapot gomb
`winkShoppingCart()`	`<wink-shopping-cart-button>`	Kosár gomb

Wink Layout mezőtípus

Adjon hozzá egy Wink Layout mezőt bármelyik szekcióhoz, hogy a szerkesztők egy legördülő menüből választhassák ki a Wink fiókjában elérhető összes elrendezést:

Lépjen a Beállítások → Mezők → Új mező menüpontra.
Állítsa be a Mezőtípus értékét Wink Layout-ra.
Adja hozzá a mezőt a bejegyzéstípus mezőelrendezéséhez.
A szerkesztők mostantól közvetlenül a bejegyzésszerkesztőben választhatnak elrendezést — nincs szükség azonosítók másolására.

A sablonban adja át a mező értékét a winkContent() függvénynek:

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