Craft CMS

Wink Craft CMS 插件 通过 Twig 模板函数和内容编辑器的自定义字段类型，将 Wink 旅游库存集成到 Craft 5 中。编辑者可以直接在条目编辑器中的下拉菜单中选择特定的 Wink 布局。

wink-travel/wink-craft-plugin on GitHub 源代码、开发者安装指南和贡献说明。

要求

Craft CMS 5.x
PHP 8.1+
Composer

安装

通过 Composer 安装：
Terminal window
```
composer require wink2travel/craft-wink
```
在控制面板的 设置 → 插件 中激活插件，或通过命令行：
Terminal window
```
php craft plugin/install wink
```
进入控制面板的 设置 → Wink。
输入您的 Client ID 和 Client Secret，选择环境，然后点击保存。访问 Applications 获取您的凭证。

在 Twig 模板中使用

配置完成后，可在模板中任意位置调用 Wink Twig 函数：

{# 渲染酒店网格 #}
{{ 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 布局字段类型

向任意区块添加 Wink Layout 字段，供编辑者从您的 Wink 账户中所有可用布局的下拉列表中选择：

进入 设置 → 字段 → 新建字段。
将 字段类型 设置为 Wink Layout。
将该字段添加到您的条目类型的字段布局中。
编辑者现在可以直接在条目编辑器中选择布局，无需复制粘贴 ID。

在模板中，将字段值传递给 winkContent()：

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

Craft CMS

要求

安装

在 Twig 模板中使用

可用的 Twig 函数

Wink 布局字段类型

进一步阅读