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 项目集成手风琴段落。此模块提供了一种将手风琴添加到厨房水槽页面上的方法。
• ut_blockquote: 为 UMD 项目集成引用段落。此模块提供了一种将引用添加到厨房水槽页面上的方法。
• ut_button: 为 UMD 项目集成按钮和链接段落。此模块提供了一种将按钮添加到厨房水槽页面上的方法。
• ut_card: 为 UMD 项目集成卡片段落。此模块提供了一种将卡片添加到厨房水槽页面上的方法。
• ut_carousel: 为 UMD 项目集成轮播图段落。此模块提供了一种将轮播图添加到厨房水槽页面上的方法。
• ut_divider: 为 UMD 项目集成水平分隔线段落。此模块提供了一种将水平分隔线添加到厨房水槽页面上的方法。
• ut_events: 为 UMD 项目集成事件流（来自 calendar.umd.edu）。本质上，此模块从 hub.umd.edu 拉取即将举行的事件流，并可选提供过滤器参数，以突出相关事件。
• ut_feature: 为 UMD 项目集成功能段落。此模块提供了一种将功能添加到厨房水槽页面上的方法。
• ut_images: 为 UMD 项目集成图像段落。此模块提供了一种将图像添加到厨房水槽页面上的方法。
• ut_news: 为 UMD 项目集成新闻流（来自 today.umd.edu）。本质上，此模块从 today.umd.edu 拉取文章流，并可选提供过滤器参数，以突出相关文章。
• ut_people: 为 UMD 项目集成人员段落。此模块提供了一种将内容类型人员列表添加到厨房水槽页面上的方法。
• ut_sidebar_menu: 此模块提供自定义侧边栏菜单，用于 UMD Terp 主题。
• ut_slideshow: 为 UMD 项目集成幻灯片段落。此模块提供了一种将幻灯片添加到厨房水槽页面上的方法。
• ut_stats: 为 UMD 项目集成统计数据段落。此模块提供了一种将统计数据添加到厨房水槽页面上的方法。
• ut_table: 为 UMD 项目集成表格字段段落。此模块提供了一种将表格添加到厨房水槽页面上的方法。
• ut_tabs: 为 UMD 项目集成标签段落。此模块提供了一种将标签添加到厨房水槽页面上的方法。
• ut_text: 为 UMD 项目集成 HTML/文本小部件段落。此模块提供了一种将 HTML/文本添加到厨房水槽页面上的方法。
• ut_video: 为 UMD 项目集成视频段落。此模块提供了一种将视频添加到厨房水槽页面上的方法。
• ut_view：UMD项目的视图段落集成。此模块提供了一种将视图添加到厨房洗涤页面的方法。
• ut_webform：UMD项目的网页表单段落集成。此模块提供了一种将网页表单添加到厨房洗涤页面的方法。
• ut_news_and_events_columns：UMD项目的两列功能段落集成。此模块提供了一种将两列本地文章和事件布局添加到厨房洗涤页面的方法。

开发

版本控制

为了通过composer拉取更新，必须在github上进行语义标记。准备部署时，在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 并修改钩子名称等来覆盖钩子。