Craft CMS

El Connector Wink per a Craft CMS integra l’inventari de viatges de Wink a Craft 5 mitjançant funcions de plantilla Twig i un tipus de camp personalitzat per a l’editor de contingut. Els editors poden triar un disseny específic de Wink des d’un menú desplegable directament a l’editor d’entrades.

wink-travel/wink-craft-plugin a GitHub Codi font, guia de configuració per a desenvolupadors i instruccions de contribució.

Requisits

Craft CMS 5.x
PHP 8.1+
Composer

Instal·lació

Instal·la mitjançant Composer:
Finestra del terminal
```
composer require wink2travel/craft-wink
```
Activa el connector al Panell de Control a Configuració → Connectors, o via CLI:
Finestra del terminal
```
php craft plugin/install wink
```
Ves a Configuració → Wink al Panell de Control.
Introdueix el teu Client ID i Client Secret, selecciona el teu entorn i fes clic a Desa. Ves a Aplicacions per obtenir les teves credencials.

Ús en plantilles Twig

Un cop configurat, crida les funcions Twig de Wink a qualsevol lloc de les teves plantilles:

{# Renderitza una graella d'hotels #}
{{ winkContent('HOTEL', entry.winkLayoutId) }}

{# Barra de cerca de destinacions #}
{{ winkLookup() }}

{# Botó per seleccionar l'itinerari #}
{{ winkSearch() }}

{# Botó de compte d'usuari #}
{{ winkAccount() }}

La funció winkContent() injecta automàticament <wink-app-loader> la primera vegada que es crida en una pàgina.

Funcions Twig disponibles

Funció	Sortida	Descripció
`winkContent(layout, id)`	`<wink-content-loader>`	Targetes d’hotel, graelles, mapes
`winkLookup()`	`<wink-lookup>`	Barra de cerca de destinacions
`winkSearch()`	`<wink-search-button>`	Botó per seleccionar l’itinerari
`winkAccount()`	`<wink-account-button>`	Inici de sessió / compte d’usuari
`winkItinerary()`	`<wink-itinerary-button>`	Botó d’estat de l’itinerari
`winkShoppingCart()`	`<wink-shopping-cart-button>`	Botó del carret de la compra

Tipus de camp Wink Layout

Afegeix un camp Wink Layout a qualsevol secció per oferir als editors un menú desplegable amb tots els dissenys disponibles del teu compte Wink:

Ves a Configuració → Camps → Nou Camp.
Estableix el Tipus de Camp a Wink Layout.
Afegeix el camp al disseny de camps del tipus d’entrada.
Ara els editors poden triar un disseny directament a l’editor d’entrades — sense haver de copiar i enganxar IDs.

A la teva plantilla, passa el valor del camp a winkContent():

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