Craft CMS

Plugin Wink Craft CMS mengintegrasikan inventaris perjalanan Wink ke Craft 5 melalui fungsi template Twig dan tipe field khusus untuk editor konten. Editor dapat memilih layout Wink tertentu dari dropdown langsung di editor entri.

wink-travel/wink-craft-plugin on GitHub Kode sumber, panduan pengaturan pengembang, dan instruksi kontribusi.

Persyaratan

Craft CMS 5.x
PHP 8.1+
Composer

Instalasi

Instal melalui Composer:
Terminal window
```
composer require wink2travel/craft-wink
```
Aktifkan plugin di Control Panel pada Settings → Plugins, atau melalui CLI:
Terminal window
```
php craft plugin/install wink
```
Buka Settings → Wink di Control Panel.
Masukkan Client ID dan Client Secret Anda, pilih lingkungan Anda, lalu klik Save. Buka Applications untuk mengambil kredensial Anda.

Penggunaan di template Twig

Setelah dikonfigurasi, panggil fungsi Twig Wink di mana saja dalam template Anda:

{# Render grid hotel #}
{{ winkContent('HOTEL', entry.winkLayoutId) }}

{# Bar pencarian destinasi #}
{{ winkLookup() }}

{# Tombol pemilih itinerary #}
{{ winkSearch() }}

{# Tombol akun pengguna #}
{{ winkAccount() }}

Fungsi winkContent() secara otomatis menyisipkan <wink-app-loader> saat pertama kali dipanggil di halaman.

Fungsi Twig yang tersedia

Fungsi	Output	Deskripsi
`winkContent(layout, id)`	`<wink-content-loader>`	Kartu hotel, grid, peta
`winkLookup()`	`<wink-lookup>`	Bar pencarian destinasi
`winkSearch()`	`<wink-search-button>`	Tombol pemilih itinerary
`winkAccount()`	`<wink-account-button>`	Masuk / akun pengguna
`winkItinerary()`	`<wink-itinerary-button>`	Tombol status itinerary
`winkShoppingCart()`	`<wink-shopping-cart-button>`	Tombol keranjang belanja

Tipe field Wink Layout

Tambahkan field Wink Layout ke bagian mana pun untuk memberikan editor dropdown dari semua layout yang tersedia di akun Wink Anda:

Buka Settings → Fields → New Field.
Atur Field Type ke Wink Layout.
Tambahkan field ke layout field tipe entri Anda.
Editor sekarang dapat memilih layout langsung di editor entri — tanpa perlu menyalin-tempel ID.

Di template Anda, kirim nilai field ke winkContent():

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