README

Introduction

Provides a simple interface for adding the UMD Schoolwide Header to Drupal sites in the University of Maryland system, following the approved University Header Guidelines as defined by the Maryland Brand.

This module was created by idfive for the University of Maryland.

Version

Please use the latest release for your version of drupal from the releases page, or simply use composer to manage.

Installation

Install as usual, see installing modules for further information.

This module can also be added to projects via composer, then enabled via drush, with something similar to the following:

• composer require umd_digital/umd_schoolwide_header
• drush en umd_schoolwide_header or enable via admin UI

Configuration

• Make any desired adjustments on the config page.

UMD Design Library

This module has been coded to attach the full UMD design library to themes other than "UMD Terp". UMD Terp theme already loads this library, so it it is undesireable to load it twice. If a theme other than 11x or greater of umd_terp is used, understand that you will be loading an additional external library.

Updating to 11x

• The module previously relied on an embed code generated by the older version of the UMD header generator.
• There were customizations present in code to hide/show specific links.
• We have retained this code under "legacy" settings if they need to be referenced, however, all configuration options desired to the header will need to be set on the configuration page of this module. This legacy code is only retained for reference, and will be removed in subsequent updates.
• When updating to 11x, sites will simply get the full header with all links, if no configuration are chosen.

Possible Configuration Adjustments

• Hide the Events link
• Hide the News link
• Hide the Admissions link
• Hide the Make a Gift link
• Hide Search

Troubleshooting

• Legacy embed script has been kept, under "Depreciated", to assist in troubleshooting or checking previous settings.
• Check for JS errors in console, and be sure to clear site caches.
• Check for CSS conflicts with your theme.

Development

Update UMD Design System

Any site that uses the umd_terp theme, will load its own JS via that theme, and thus not use the file here. This file is only for custom themes, or other use cases, that need the UMD Design system loaded.

• cd umd_brand_static
• nvm use, to standardize NPM in use.
• npm update, to get a newer version of the UMD Header JS package.
• npm run build, to rebuild the JS file needed for non umd_terp themes.