Apereo CAS 用户界面定制：静态主题配置指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01197/article/details/148415238

Apereo CAS 用户界面定制：静态主题配置指南

cas Apereo CAS - Identity & Single Sign On for all earthlings and beyond. 项目地址: https://gitcode.com/gh_mirrors/ca/cas

什么是静态主题？

在Apereo CAS中，静态主题是一种在不改变视图物理结构的前提下，通过CSS和JavaScript对用户界面进行装饰的定制方式。它允许管理员为不同的注册服务定义独特的视觉风格，同时保留CAS默认的视图布局。

主题工作原理

静态主题通过服务注册表中注册服务的theme属性激活。当用户访问特定服务时，CAS会自动加载与该主题关联的CSS样式表和JavaScript文件，从而改变界面的外观和行为。

创建静态主题步骤

1. 创建主题属性文件

在项目的src/main/resources目录下创建[theme_name].properties文件，其中[theme_name]是您自定义的主题名称。该文件包含主题的各种配置参数。

2. 配置主题资源目录

在src/main/resources/static/themes/[theme_name]目录下创建以下子目录：

css/ - 存放自定义CSS文件
js/ - 存放自定义JavaScript文件
images/ - 存放主题相关图片

3. 配置服务注册

在服务注册定义中指定主题名称：

{
  "@class": "org.apereo.cas.services.CasRegisteredService",
  "serviceId": "^https://www.example.org",
  "name": "MyTheme",
  "theme": "[theme_name]",
  "id": 1000
}

主题配置参数详解

基本资源设置

| 参数 | 说明 | 示例值 | |------|------|--------| | cas.standard.css.file | 主题CSS文件路径（可多个） | /themes/example/css/cas.css | | cas.standard.js.file | 主题JavaScript文件路径（可多个） | /themes/example/js/cas.js | | cas.logo.file | 主题logo路径 | /images/logo.png |

布局控制

| 参数 | 说明 | 默认值 | |------|------|--------| | cas.drawer-menu.enabled | 是否显示抽屉菜单 | true | | cas.footer.show | 是否显示页脚 | true | | cas.login-form.enabled | 是否显示登录表单 | true |

功能开关

| 参数 | 说明 | 默认值 | |------|------|--------| | cas.pm-links.enabled | 是否显示密码管理链接 | true | | cas.public-workstation.enabled | 是否显示"公共工作站"选项 | false | | cas.warn-on-redirect.enabled | 重定向前是否显示警告 | false |

元信息设置

| 参数 | 说明 | 示例值 | |------|------|--------| | cas.theme.name | 主题名称 | 示例主题 | | cas.theme.description | 主题描述 | 示例主题描述 | | cas.favicon.file | 网站图标路径 | /themes/example/images/favicon.ico |