Craft CMS
Ang Wink Craft CMS Plugin ay nag-iintegrate ng Wink travel inventory sa Craft 5 sa pamamagitan ng Twig template functions at isang custom field type para sa content editor. Maaaring pumili ang mga editor ng partikular na Wink layout mula sa dropdown nang direkta sa entry editor.
wink-travel/wink-craft-plugin on GitHub Source code, developer setup guide, and contribution instructions.
Mga Kinakailangan
Section titled “Mga Kinakailangan”- Craft CMS 5.x
- PHP 8.1+
- Composer
Pag-install
Section titled “Pag-install”- I-install gamit ang Composer:
Terminal window composer require wink2travel/craft-wink - I-activate ang plugin sa Control Panel sa Settings → Plugins, o gamit ang CLI:
Terminal window php craft plugin/install wink - Pumunta sa Settings → Wink sa Control Panel.
- Ilagay ang iyong Client ID at Client Secret, piliin ang iyong environment, at i-click ang Save. Pumunta sa Applications para makuha ang iyong mga kredensyal.
Paggamit sa Twig templates
Section titled “Paggamit sa Twig templates”Kapag na-configure na, tawagin ang Wink Twig functions kahit saan sa iyong mga template:
{# I-render ang hotel grid #}{{ winkContent('HOTEL', entry.winkLayoutId) }}
{# Destination search bar #}{{ winkLookup() }}
{# Itinerary picker button #}{{ winkSearch() }}
{# User account button #}{{ winkAccount() }}Ang winkContent() function ay awtomatikong nag-iinject ng <wink-app-loader> sa unang pagkakataon na tawagin ito sa isang pahina.
Mga Available na Twig functions
Section titled “Mga Available na Twig functions”| Function | Output | Paglalarawan |
|---|---|---|
winkContent(layout, id) | <wink-content-loader> | Mga hotel card, grids, mapa |
winkLookup() | <wink-lookup> | Destination search bar |
winkSearch() | <wink-search-button> | Itinerary picker button |
winkAccount() | <wink-account-button> | Sign-in / user account |
winkItinerary() | <wink-itinerary-button> | Itinerary status button |
winkShoppingCart() | <wink-shopping-cart-button> | Cart button |
Wink Layout field type
Section titled “Wink Layout field type”Magdagdag ng Wink Layout field sa anumang seksyon upang bigyan ang mga editor ng dropdown ng lahat ng available na layouts mula sa iyong Wink account:
- Pumunta sa Settings → Fields → New Field.
- Itakda ang Field Type sa Wink Layout.
- Idagdag ang field sa field layout ng iyong entry type.
- Maaari nang pumili ang mga editor ng layout nang direkta sa entry editor — hindi na kailangang mag-copy-paste ng mga ID.
Sa iyong template, ipasa ang halaga ng field sa winkContent():
{{ winkContent(entry.winkLayout.type, entry.winkLayout.id) }}