Craft CMS

O Wink Craft CMS Plugin integra o inventário de viagens Wink ao Craft 5 por meio de funções Twig e um tipo de campo personalizado para o editor de conteúdo. Os editores podem escolher um layout específico do Wink em um menu suspenso diretamente no editor de entradas.

wink-travel/wink-craft-plugin no GitHub Código-fonte, guia de configuração para desenvolvedores e instruções de contribuição.

Requisitos

Craft CMS 5.x
PHP 8.1+
Composer

Instalação

Instale via Composer:
Terminal window
```
composer require wink2travel/craft-wink
```
Ative o plugin no Painel de Controle em Configurações → Plugins, ou via CLI:
Terminal window
```
php craft plugin/install wink
```
Vá para Configurações → Wink no Painel de Controle.
Insira seu Client ID e Client Secret, selecione seu ambiente e clique em Salvar. Acesse Applications para obter suas credenciais.

Uso em templates Twig

Após configurado, chame as funções Twig do Wink em qualquer lugar dos seus templates:

{# Renderiza uma grade de hotéis #}
{{ winkContent('HOTEL', entry.winkLayoutId) }}

{# Barra de busca de destinos #}
{{ winkLookup() }}

{# Botão seletor de itinerário #}
{{ winkSearch() }}

{# Botão de conta do usuário #}
{{ winkAccount() }}

A função winkContent() injeta automaticamente <wink-app-loader> na primeira vez que é chamada em uma página.

Funções Twig disponíveis

Função	Saída	Descrição
`winkContent(layout, id)`	`<wink-content-loader>`	Cartões de hotéis, grades, mapas
`winkLookup()`	`<wink-lookup>`	Barra de busca de destinos
`winkSearch()`	`<wink-search-button>`	Botão seletor de itinerário
`winkAccount()`	`<wink-account-button>`	Login / conta do usuário
`winkItinerary()`	`<wink-itinerary-button>`	Botão de status do itinerário
`winkShoppingCart()`	`<wink-shopping-cart-button>`	Botão do carrinho

Tipo de campo Wink Layout

Adicione um campo Wink Layout a qualquer seção para oferecer aos editores um menu suspenso com todos os layouts disponíveis da sua conta Wink:

Vá para Configurações → Campos → Novo Campo.
Defina o Tipo de Campo como Wink Layout.
Adicione o campo ao layout de campos do seu tipo de entrada.
Os editores agora podem escolher um layout diretamente no editor de entradas — sem precisar copiar e colar IDs.

No seu template, passe o valor do campo para winkContent():

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