Craft CMS

El Wink Craft CMS Plugin integra el inventario de Wink travel en Craft 5 mediante funciones Twig y un tipo de campo personalizado para el editor de contenido. Los editores pueden seleccionar un diseño específico de Wink desde un menú desplegable directamente en el editor de entradas.

wink-travel/wink-craft-plugin en GitHub Código fuente, guía de configuración para desarrolladores e instrucciones para contribuir.

Requisitos

Craft CMS 5.x
PHP 8.1+
Composer

Instalación

Instala vía Composer:
Ventana de terminal
```
composer require wink2travel/craft-wink
```
Activa el plugin en el Panel de Control en Settings → Plugins, o vía CLI:
Ventana de terminal
```
php craft plugin/install wink
```
Ve a Settings → Wink en el Panel de Control.
Ingresa tu Client ID y Client Secret, selecciona tu entorno y haz clic en Save. Ve a Applications para obtener tus credenciales.

Uso en plantillas Twig

Una vez configurado, llama a las funciones Twig de Wink en cualquier parte de tus plantillas:

{# Renderiza una cuadrícula de hoteles #}
{{ winkContent('HOTEL', entry.winkLayoutId) }}

{# Barra de búsqueda de destinos #}
{{ winkLookup() }}

{# Botón selector de itinerario #}
{{ winkSearch() }}

{# Botón de cuenta de usuario #}
{{ winkAccount() }}

La función winkContent() inyecta automáticamente <wink-app-loader> la primera vez que se llama en una página.

Funciones Twig disponibles

Función	Salida	Descripción
`winkContent(layout, id)`	`<wink-content-loader>`	Tarjetas de hotel, cuadrículas, mapas
`winkLookup()`	`<wink-lookup>`	Barra de búsqueda de destinos
`winkSearch()`	`<wink-search-button>`	Botón selector de itinerario
`winkAccount()`	`<wink-account-button>`	Inicio de sesión / cuenta de usuario
`winkItinerary()`	`<wink-itinerary-button>`	Botón de estado del itinerario
`winkShoppingCart()`	`<wink-shopping-cart-button>`	Botón del carrito

Tipo de campo Wink Layout

Agrega un campo Wink Layout a cualquier sección para que los editores tengan un menú desplegable con todos los diseños disponibles de tu cuenta Wink:

Ve a Settings → Fields → New Field.
Configura Field Type a Wink Layout.
Añade el campo al diseño de campos de tu tipo de entrada.
Los editores ahora pueden seleccionar un diseño directamente en el editor de entradas — sin copiar y pegar IDs.

En tu plantilla, pasa el valor del campo a winkContent():

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