Files
archived-MoviePilot-Plugins/docs/faq/08-render-dashboard.md
2026-04-20 21:43:30 +08:00

2.2 KiB
Raw Blame History

如何将插件内容显示到仪表板?

返回 README | FAQ 索引

(仅支持 v1.8.7+ 版本)

  • 将插件的内容显示到仪表盘,并支持定义占据的单元格大小,插件产生的仪表板仅管理员可见。
    1. 根据插件需要展示的Widget内容规划展示内容的样式和规格也可设计多个规格样式并提供配置项供用户选择。
    1. 实现 get_dashboard_meta 方法定义仪表板key及名称支持一个插件有多个仪表板
def get_dashboard_meta(self) -> Optional[List[Dict[str, str]]]:
    """
    获取插件仪表盘元信息
    返回示例:
        [{
            "key": "dashboard1", // 仪表盘的key在当前插件范围唯一
            "name": "仪表盘1" // 仪表盘的名称
        }, {
            "key": "dashboard2",
            "name": "仪表盘2"
        }]
    """
    pass
    1. 实现 get_dashboard 方法根据key返回仪表盘的详细配置信息包括仪表盘的cols列配置适配不同屏幕以及仪表盘的页面配置json具体可参考插件站点数据统计
def get_dashboard(self, key: str, **kwargs) -> Optional[Tuple[Dict[str, Any], Dict[str, Any], List[dict]]]:
    """
    获取插件仪表盘页面需要返回1、仪表板col配置字典2、全局配置自动刷新等3、仪表板页面元素配置json含数据
    1、col配置参考
    {
        "cols": 12, "md": 6
    }
    2、全局配置参考
    {
        "refresh": 10, // 自动刷新时间,单位秒
        "border": True, // 是否显示边框默认True为False时取消组件边框和边距由插件自行控制
        "title": "组件标题", // 组件标题,如有将显示该标题,否则显示插件名称
        "subtitle": "组件子标题", // 组件子标题,缺省时不展示子标题
    }
    3、页面配置使用Vuetify组件拼装参考https://vuetifyjs.com/

    kwargs参数可获取的值1、user_agent浏览器UA

    :param key: 仪表盘key根据指定的key返回相应的仪表盘数据缺省时返回一个固定的仪表盘数据兼容旧版
    """
    pass