Craft CMS

Wink Craft CMS Plugin integroi Wink-matkavaraston Craft 5:een Twig-mallifunktioiden ja sisällönmuokkaajan mukautetun kenttätyypin avulla. Muokkaajat voivat valita tietyn Wink-asettelun suoraan merkinnän muokkaajassa pudotusvalikosta.

wink-travel/wink-craft-plugin on GitHub Lähdekoodi, kehittäjän asennusopas ja ohjeet osallistumiseen.

Vaatimukset

Craft CMS 5.x
PHP 8.1+
Composer

Asennus

Asenna Composerilla:
Terminal window
```
composer require wink2travel/craft-wink
```
Aktivoi laajennus Ohjauspaneelissa kohdassa Asetukset → Laajennukset tai komentoriviltä:
Terminal window
```
php craft plugin/install wink
```
Siirry Ohjauspaneelissa kohtaan Asetukset → Wink.
Syötä Client ID ja Client Secret, valitse ympäristö ja klikkaa Tallenna. Hae tunnukset [Sovellukset]-sivulta (/portal/settings/applications).

Käyttö Twig-malleissa

Kun asetukset on tehty, kutsu Wink Twig -funktioita missä tahansa malleissasi:

{# Näytä hotelliruudukko #}
{{ winkContent('HOTEL', entry.winkLayoutId) }}

{# Kohteen hakupalkki #}
{{ winkLookup() }}

{# Matkaohjelman valintapainike #}
{{ winkSearch() }}

{# Käyttäjätilin painike #}
{{ winkAccount() }}

winkContent()-funktio lisää automaattisesti <wink-app-loader> ensimmäisellä kutsukerralla sivulla.

Saatavilla olevat Twig-funktiot

Funktio	Tuloste	Kuvaus
`winkContent(layout, id)`	`<wink-content-loader>`	Hotellikortit, ruudukot, kartat
`winkLookup()`	`<wink-lookup>`	Kohteen hakupalkki
`winkSearch()`	`<wink-search-button>`	Matkaohjelman valintapainike
`winkAccount()`	`<wink-account-button>`	Kirjautuminen / käyttäjätili
`winkItinerary()`	`<wink-itinerary-button>`	Matkaohjelman tilapainike
`winkShoppingCart()`	`<wink-shopping-cart-button>`	Ostoskoripainike

Wink Layout -kenttätyyppi

Lisää Wink Layout -kenttä mihin tahansa osioon, jotta muokkaajat saavat pudotusvalikon kaikista Wink-tilisi käytettävissä olevista asetteluista:

Siirry kohtaan Asetukset → Kentät → Uusi kenttä.
Valitse Kenttätyyppiksi Wink Layout.
Lisää kenttä merkintätyypin kenttäasetteluun.
Muokkaajat voivat nyt valita asettelun suoraan merkinnän muokkaajassa — ei tarvitse kopioida tunnuksia.

Mallissasi välitä kentän arvo winkContent()-funktiolle:

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