appmanschap / craft-playlister
直接导入播放列表到CraftCMS
1.0.5
2024-09-26 08:32 UTC
Requires
- php: >=8.2
- craftcms/cms: ^5.0.0
- google/apiclient: ^2.15.0
Requires (Dev)
- craftcms/ecs: dev-main
- craftcms/phpstan: dev-main
README
Craft CMS的播放列表插件
Playlister是一个CraftCMS插件,用于将YouTube播放列表导入Craft。检索播放列表和相应的视频。
要求
此插件需要CraftCMS 5.0.0或更高版本。
安装
要安装插件,可以从插件商店安装,或按照以下说明进行操作
- 使用composer安装
composer require appmanschap/craft-playlister
- 安装插件
craft plugin/install craft-playlister
- 在设置中添加您的YouTube API令牌。
用法
您可以使用字段或模板变量检索播放列表和视频。这两种情况都将返回一个播放列表元素或视频元素
字段
创建一个新的播放列表字段或视频字段并将其添加到您的条目类型中。
模板变量
craft.playlister.playlists()
返回一个PlaylistQuery。按需查询以检索播放列表。示例(检索启用的播放列表)
craft.playlister.playlists.enabled(true).all()
按播放列表ID检索单个播放列表
craft.playlister.playlists.playlistId(YOUR-PLAYLIST-ID).one()
craft.playlister.videos()
返回一个VideoQuery。按需查询以检索视频。
检索可嵌入视频示例
craft.playlister.videos.embeddable(true).all()
从播放列表检索视频
craft.playlister.videos.playlistId(YOUR-PLAYLIST-ID).all()
按标签检索视频示例
craft.playlister.videos.tags[('awesome', 'video']).all()
播放列表元素
方法:getVideos(?bool embeddable)
检索播放列表中的视频。当可用时,embeddable参数将根据其值过滤查询。
视频元素
方法:getThumbnail(string size)
该方法将根据给定的大小返回第一个可能的缩略图URL。如果没有传递参数,则将检索其已知最大的缩略图URL。
可能的大小
- default
- medium
- high
- standard
- maxres
支持
通过创建Github问题来联系