README

UMD Terp Base 是所有 UMD drupal 8 项目的基模块。它被设计成与 UMD Terp 主题 一起安装。此模块提供了一套模块、功能和配置，以便该主题按设计工作。

• UMD Terp 主题
• UMD Terp Base 模块

安装

按照您通常安装任何 drupal 8 模块的方式安装。

通过 Composer

• composer require umd_digital/umd_terp_base --prefer-dist
• drush en umd_terp_base 或通过管理界面启用
• 启用所有需要的子模块

手动

• 将此仓库下载到 /modules/contrib/umd_terp_base
• drush en umd_terp_base 或通过管理界面启用
• 启用所有需要的子模块

配置

• 无需配置。

子模块

• umd_terp_content_types：为 "UMD Terp" 主题中使用的各种内容类型提供定制和配置。在启用 umd_terp_base 时默认安装。
• ut_accordion：为 UMD 项目提供段落集成的手风琴。此模块提供了一种在 Kitchen Sink 页面上添加手风琴的方法。
• ut_blockquote：为 UMD 项目提供段落集成的引用块。此模块提供了一种在 Kitchen Sink 页面上添加引用块的方法。
• ut_button：为 UMD 项目提供段落集成的按钮和链接。此模块提供了一种在 Kitchen Sink 页面上添加按钮的方法。
• ut_card：为 UMD 项目提供段落集成的卡片。此模块提供了一种在 Kitchen Sink 页面上添加卡片的方法。
• ut_carousel：为 UMD 项目提供段落集成的轮播。此模块提供了一种在 Kitchen Sink 页面上添加轮播的方法。
• ut_divider：为 UMD 项目提供段落集成的水平分隔线。此模块提供了一种在 Kitchen Sink 页面上添加水平分隔线的方法。
• ut_events：为 UMD 项目提供段落集成的活动源（来自 calendar.umd.edu）。基本上，此模块从 hub.umd.edu 拉取即将举行的活动源，带有可选的过滤器参数，以突出相关事件。
• ut_feature：为 UMD 项目提供段落集成的功能。此模块提供了一种在 Kitchen Sink 页面上添加功能的方法。
• ut_images：为 UMD 项目提供段落集成的图片。此模块提供了一种在 Kitchen Sink 页面上添加图片的方法。
• ut_news：为 UMD 项目提供段落集成的新闻源（来自 today.umd.edu）。基本上，此模块从 today.umd.edu 拉取文章源，带有可选的过滤器参数，以突出相关文章。
• ut_people：为 UMD 项目提供段落集成的人员。此模块提供了一种在 Kitchen Sink 页面上添加人员列表的方法。
• ut_sidebar_menu：此模块提供定制的侧边菜单，用于 UMD Terp 主题。
• ut_slideshow：为 UMD 项目提供段落集成的幻灯片。此模块提供了一种在 Kitchen Sink 页面上添加幻灯片的方法。
• ut_stats：为 UMD 项目提供段落集成的统计数据。此模块提供了一种在 Kitchen Sink 页面上添加统计数据的方法。
• ut_table：为 UMD 项目提供段落集成的表格字段。此模块提供了一种在 Kitchen Sink 页面上添加表格的方法。
• ut_tabs：为 UMD 项目提供段落集成的标签。此模块提供了一种在 Kitchen Sink 页面上添加标签的方法。
• ut_text：UMD项目的HTML/文本小部件段落集成。此模块提供了一种将HTML/文本添加到厨房水槽页面的方法。
• ut_video：UMD项目的视频段落集成。此模块提供了一种将视频添加到厨房水槽页面的方法。
• ut_view：UMD项目的视图段落集成。此模块提供了一种将视图添加到厨房水槽页面的方法。
• ut_webform：UMD项目的网页表单段落集成。此模块提供了一种将网页表单添加到厨房水槽页面的方法。
• ut_news_and_events_columns：UMD项目的两列特性段落集成。此模块提供了一种将两列本地文章和事件布局添加到厨房水槽页面的方法。

开发

版本管理

语义标记必须在github上进行，以便通过composer拉取更新。准备部署时，在github中创建一个标签，比上一个版本高一个版本，起始版本为8.1.0。

• 小版本（非破坏性更改）：8.1.1，8.1.2等。
• 大版本（破坏性更改）：8.2.0，8.3.0等。

核心（基础）模块问题、补丁等

所有编辑、请求等应提交给UMD Terp Base模块的github存储库。请在问题队列中添加问题。补丁将根据价值和可用资源进行审查。

前端

所有CSS、JS等均基于UMD Terp主题。此模块不包含任何小部件等的前端样式。

定制

• 此模块绝不应直接修改。
• 所有定制应放入自定义模块中。

每个模块的配置在安装时创建。技术上可以修改这些配置，但我们不建议这样做。任何模块的未来更新都将包含一个挂钩来重新安装该模块的配置，因此最好保持现有模块配置不变。更改现有配置最好通过form_alter挂钩完成，以保留默认配置。

节点

使用hook_form_alter()。例如，要从不需要侧边栏的主题中删除“隐藏侧边栏”布尔值，在YOUR_CUSTOM_MODULE中执行以下操作

function YOUR_CUSTOM_MODULE_form_alter(&$form, FormStateInterface $form_state, $form_id) {
  // Hide the sidebar boolean.
  if ($form_id == 'node_umd_terp_basic_page_form' || $form_id = 'node_umd_terp_basic_page_edit_form') {
    if ( isset($form['field_umdt_ct_hide_sidebar'])) {
      $form['field_umdt_ct_hide_sidebar']['#access'] = FALSE;
    }
  }
}

段落

使用hook_field_WIDGET_TYPE_paragraphs_form_alter()。例如，要从不需要/不想要的样式的主题中删除样式（浅色或深色），在YOUR_CUSTOM_MODULE中执行以下操作

function YOUR_CUSTOM_MODULE_field_widget_paragraphs_form_alter(&$element, &$form_state, $context) {
  // Remove light/dark choice from UT Blockquote.
  if ($element['#paragraph_type'] == 'ut_blockquote') {
    if (isset($element['subform']['field_ut_blockquote_style'])) {
      $element['subform']['field_ut_blockquote_style']['#access'] = FALSE;
    }
  }
}

标记/钩子覆盖

• 您可以通过将它们复制到子主题主题文件夹中来覆盖段落模板。
• 您可以通过复制到子主题 .theme 或自定义模块 .module 并修改钩子名称等来覆盖钩子。