Craft CMS
Pluginul Wink pentru Craft CMS integrează inventarul de călătorii Wink în Craft 5 prin funcții Twig și un tip de câmp personalizat pentru editorul de conținut. Editorii pot selecta un layout Wink specific dintr-un meniu dropdown direct în editorul de intrări.
wink-travel/wink-craft-plugin on GitHub Cod sursă, ghid de configurare pentru dezvoltatori și instrucțiuni de contribuție.
Cerințe
Section titled “Cerințe”- Craft CMS 5.x
- PHP 8.1+
- Composer
Instalare
Section titled “Instalare”- Instalează prin Composer:
Terminal window composer require wink2travel/craft-wink - Activează pluginul în Control Panel la Settings → Plugins, sau prin CLI:
Terminal window php craft plugin/install wink - Accesează Settings → Wink în Control Panel.
- Introdu Client ID și Client Secret, selectează mediul și apasă Save. Mergi la Applications pentru a-ți obține credențialele.
Utilizare în template-uri Twig
Section titled “Utilizare în template-uri Twig”Odată configurat, apelează funcțiile Twig Wink oriunde în template-urile tale:
{# Afișează o grilă de hoteluri #}{{ winkContent('HOTEL', entry.winkLayoutId) }}
{# Bara de căutare destinații #}{{ winkLookup() }}
{# Buton pentru selectarea itinerariului #}{{ winkSearch() }}
{# Buton cont utilizator #}{{ winkAccount() }}Funcția winkContent() injectează automat <wink-app-loader> prima dată când este apelată pe o pagină.
Funcții Twig disponibile
Section titled “Funcții Twig disponibile”| Funcție | Output | Descriere |
|---|---|---|
winkContent(layout, id) | <wink-content-loader> | Carduri hotel, grile, hărți |
winkLookup() | <wink-lookup> | Bara de căutare destinații |
winkSearch() | <wink-search-button> | Buton selectare itinerariu |
winkAccount() | <wink-account-button> | Autentificare / cont utilizator |
winkItinerary() | <wink-itinerary-button> | Buton stare itinerariu |
winkShoppingCart() | <wink-shopping-cart-button> | Buton coș de cumpărături |
Tip câmp Wink Layout
Section titled “Tip câmp Wink Layout”Adaugă un câmp Wink Layout în orice secțiune pentru a oferi editorilor un dropdown cu toate layout-urile disponibile din contul tău Wink:
- Mergi la Settings → Fields → New Field.
- Setează Field Type la Wink Layout.
- Adaugă câmpul în layout-ul tipului tău de intrare.
- Editorii pot acum selecta un layout direct în editorul de intrări — fără a copia ID-uri.
În template-ul tău, transmite valoarea câmpului către winkContent():
{{ winkContent(entry.winkLayout.type, entry.winkLayout.id) }}