asuwebplatforms/webspark-module-asu_brand

ASU头部组件和品牌资产。

1.2.15 2023-03-03 23:21 UTC

README

ASU品牌模块提供以下功能

  • 一个ASU品牌、可访问、符合Web标准的头部,集成了ASU搜索和所需链接。该头部提供导航菜单,您可以通过Drupal管理用户界面进行配置。下面提供更多配置详情。
  • ASU通用谷歌标签管理器。默认启用并自动包含在您网站的标记中,无需您进行任何配置。如果您想关闭它或希望添加额外的GTM容器ID,请访问管理员 -> 配置 -> ASU品牌设置。
  • ASU品牌Cookie同意,符合GDPR合规性。默认开启。无需配置。

有关头部、GTM和Cookie同意的更多技术细节,请访问unity.web.asu.edu

安装说明

当您创建Webspark网站时,ASU品牌模块会自动安装。如果您在Webspark之外或在其他情况下使用此模块,请参阅下面的说明。

  1. 像安装其他模块一样安装和启用ASU品牌模块。
  2. 转到管理员 -> 结构 -> 块,并将ASU品牌头部块放置到您网站的头部区域。请注意,头部提供自己的头部标签,因此您可能需要更新非Webspark主题以确保它们不会设置自己的头部标签。可用的区域将由您使用的主题确定。

CAS集成

ASU品牌头部默认使用的登录/注销路径假设您已启用CAS单点登录模块。CAS应默认包含并安装到Webspark网站中。如果需要实施,请安装并启用CAS模块,以允许用户创建账户并验证到您的网站。

关于缓存的说明

ASU品牌头部为了性能而进行缓存。当您更新头部中使用的菜单时,请清除缓存以立即看到您的更新。在Drupal UI中,转到管理员 -> 配置 -> 性能以清除缓存。

如何配置您的头部

Webspark网站默认安装了启用的ASU头部,并将主菜单配置为头部菜单。如果您想重新配置您的头部或向您的网站添加另一个头部,例如子站或微站,请转到管理员 -> 结构 -> 块,并将“ASU品牌头部”块放置到您网站的头部区域。您创建的每个头部块都有其独立的设置。大多数网站只需要一个。

在ASU品牌头部块设置中,您可以更改头部设置,但默认设置应该适用于大多数情况。

下拉菜单中的列

要创建菜单列,请在菜单的第二级添加一个菜单链接,并在“ASU品牌菜单链接类型”下拉菜单中使用“标题 - 开始一个列”设置进行配置。从该标题之后的第二个级别的所有菜单链接都将位于该列中,直到遇到下一个“标题”菜单链接并开始新的一列。

关于菜单中按钮的说明

菜单中有三种类型的按钮可供使用。

  1. 一级行动按钮显示在一级菜单项旁边,并在块配置中进行配置。
  2. 下拉菜单列中的按钮使用“ASU品牌菜单链接类型”下拉菜单在菜单链接项表单中进行配置。
  3. 下拉菜单底部托盘中的按钮通过点击菜单链接项的“在下拉托盘中显示为ASU品牌按钮”复选框来启用。对于2和3,启用按钮设置将仅当该菜单项位于菜单的第二级时,将该菜单链接转换为相应的按钮类型。如果这些菜单链接字段配置在非标题菜单中,则将忽略它们。

标题菜单深度

只有顶部和第二级的标题菜单链接在标题中显示。

其他配置

与GTM和Cookie同意相关的全局配置可以在以下点击路径中找到:管理员 -> 配置 -> ASU品牌设置。

标题资产

ASU品牌标题的早期版本从外部源加载标题。Webspark 2版本的模块现在包含来自Unity设计系统“components-library”标题组件的所有标题资产。

关于工具栏菜单的说明

ASU品牌标题旨在与Drupal核心工具栏菜单配合使用,该菜单用于提供管理系统链接。目前不支持流行的Drupal模块“Admin Toolbar”,该模块提供来自工具栏的下拉菜单。

帮助!标题与我的内容或UI重叠!

ASU品牌标题使用固定定位,这可能导致UI中其他固定定位元素的问题。我们已经尝试捕获并提供CSS规则,以调整Webspark中提供的那些UI元素。如果您有自定义或添加了重叠的模块,可以使用以下CSS进行UI调整

body.asu-brand-header-present {
  /* Your rules here. See css/asu_brand.header.css for examples from this
     module. To see how the ASU Brand module uses Javascript to detect and
     apply necessary changes related to the header, see
     js/asu_brand.header.js */
}

扩展Google Analytics数据层

ASU品牌模块初始化Google Analytics数据层,以便前端Unity组件使用。数据层已被实现,以便模块可以利用它,同时使用hook_asu_brand_gtm_datalayer_alter()钩子。请注意,使用此钩子添加基于页面的数据层推送尚未测试,因此开发者有责任确保其按预期行为,并且不会干扰现有页面上其他数据层的使用。如果您测试了此功能,我们非常希望了解您的体验。

function hook_asu_brand_gtm_datalayer_alter(array &$datalayer) {
  // Set a "site" variable return.
  $datalayer['site'] = 'My Site';
}
*/