UMD Terp is the base theme for all UMD drupal 8 projects. It combines UMD approved elements and functionality, into a modified bootstrap theme. It is best used alongside the UMD Terp Base Module, which provides a suite of modules, and configuration to make this theme work as designed. It is also designed to integrate the UMD Schoolwide Header.

This theme can be used on its own, or as a base theme for further customizations via a custom sub-theme.

• UMD Terp Theme
• UMD Terp Base Module
• UMD Schoolwide Header

• Twig Tweak Module
• UMD Terp Base Module

• Ensure Twig Tweak Module is enabled.
• Ensure Twig Field Value Module is enabled.
• Install as you normally would any drupal 8 theme.

• composer require umd_digital/umd_terp --prefer-dist
• drush en umd_terp or enable via admin UI

• Download this repo into /themes/contrib/umd_terp
• drush en umd_terp or enable via admin UI

• Ensure the UMD Terp Base Module is installed, and submodules enabled.

• Light header style: Defaults to dark header/nav area. This option switches it to a light header/nav area.

• Logo: The logo of the department/institution/etc.
• Address: The address of the department/institution/etc.
• Phone number: The phone number of the department/institution/etc.
• Email: The email address of the department/institution/etc.

• Twitter link: The twitter link of the department/institution/etc.
• Facebook link: The facebook link of the department/institution/etc.
• Youtube link: The youtube link of the department/institution/etc.
• Instagram link: The instagram link of the department/institution/etc.
• LinkedIn link: The linkedin link of the department/institution/etc.

• Back to directory text: Provides the text for the back to directory link on profile pages.
• Back to directory path: Provides the path for the back to directory link on profile pages.

• Assets path: Dev use only. The assets path for any static images/etc in the theme, to be used in twig theme.

Semantic tagging must take place in github for the updates to be able to be pulled via composer. When ready to deploy, create a tag in github up one version from previous, with the starting version being 8.1.0:

• Minor versions (non breaking changes): 8.1.1, 8.1.2, etc.
• Major versions (breaking changes): 8.2.0, 8.3.0, etc.

Tagging is handled via Gitflow. Branch naming is as follows:

• Production release branch: master
• Next release development branch: develop
• Feature branch prefix: f-
• Release branch prefix: r-
• Hotfix branch prefix: h-
• Support branch prefix: s-

All edits, requests, etc should be submitted to the github repo for the UMD Terp Theme. Please add issues to the issues queue. Patches will be reviewed on a merit and resources available basis.

All CSS, JS, etc are based in the static folder. This project provides a development experience that mirrors the idfive Component Library but instead uses Bootstrap 4 as the underlying frontend library.

The UMD component library includes Fractal for component based development. Your own components can be added to the src/components folder. Static assets such as JavaScript, CSS and images will be served out of the build folder, but can also be configured to your specific needs by editing the fractal.js file. For more information, read the fractal guide.

See /static/README.md for more information on the frontend configuration.

THIS THEME SHOULD NEVER BE MODIFIED DIRECTLY. Instead, create a sub-theme so that you may still benefit from future releases of this base theme. Once you've done that, you can override CSS, templates, and theme processing from within that sub-theme. See Sub-themes for more information.

Notes on customization:

• Several widgets include "dark mode". You should account for that if restyling kitchen sink widgets.
• Don't forget to account for the UMD Schoolwide Header.

• Ensure Twig Tweak Module is present, and enabled.