Craft CMS

התוסף Wink Craft CMS Plugin משלב את מלאי הנסיעות של Wink ב-Craft 5 דרך פונקציות Twig ושדה מותאם לעורך התוכן. העורכים יכולים לבחור תבנית Wink ספציפית מתוך תפריט נפתח ישירות בעורך הערכים.

wink-travel/wink-craft-plugin on GitHub קוד מקור, מדריך התקנה למפתחים והוראות לתרומה.

דרישות

Craft CMS 5.x
PHP 8.1+
Composer

התקנה

התקן דרך Composer:
Terminal window
```
composer require wink2travel/craft-wink
```
הפעל את התוסף בלוח הבקרה תחת Settings → Plugins, או דרך שורת הפקודה:
Terminal window
```
php craft plugin/install wink
```
עבור אל Settings → Wink בלוח הבקרה.
הזן את Client ID ו-Client Secret שלך, בחר את הסביבה ולחץ על Save. עבור אל Applications כדי לקבל את האישורים שלך.

שימוש בתבניות Twig

לאחר ההגדרה, קרא לפונקציות Twig של Wink בכל מקום בתבניות שלך:

{# הצגת רשת מלונות #}
{{ winkContent('HOTEL', entry.winkLayoutId) }}

{# שורת חיפוש יעד #}
{{ winkLookup() }}

{# כפתור בחירת מסלול #}
{{ winkSearch() }}

{# כפתור חשבון משתמש #}
{{ winkAccount() }}

הפונקציה winkContent() מזריקה אוטומטית את <wink-app-loader> בפעם הראשונה שהיא נקראת בדף.

פונקציות Twig זמינות

פונקציה	פלט	תיאור
`winkContent(layout, id)`	`<wink-content-loader>`	כרטיסי מלונות, רשתות, מפות
`winkLookup()`	`<wink-lookup>`	שורת חיפוש יעד
`winkSearch()`	`<wink-search-button>`	כפתור בחירת מסלול
`winkAccount()`	`<wink-account-button>`	כניסה / חשבון משתמש
`winkItinerary()`	`<wink-itinerary-button>`	כפתור סטטוס מסלול
`winkShoppingCart()`	`<wink-shopping-cart-button>`	כפתור עגלת קניות

סוג שדה Wink Layout

הוסף שדה Wink Layout לכל סקשן כדי לאפשר לעורכים לבחור מתוך תפריט נפתח את כל התבניות הזמינות מחשבון Wink שלך:

עבור אל Settings → Fields → New Field.
הגדר את Field Type ל-Wink Layout.
הוסף את השדה לפריסת השדות של סוג הערך שלך.
כעת העורכים יכולים לבחור תבנית ישירות בעורך הערכים — ללא צורך בהעתקה והדבקה של מזהים.

בתבנית שלך, העבר את ערך השדה ל-winkContent():

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