-
Notifications
You must be signed in to change notification settings - Fork 3
Getting Started
This guide covers how to install and configure the UMD Libraries Design System on a Drupal 11+ site.
Install all of the following packages before proceeding:
| Package | Description |
|---|---|
| UMD Libraries Theme | The main theme |
| UMD Libraries Layout Tools | Layout Builder section options |
| UMD Libraries Sidebar Menu | Sidebar navigation block |
| UMD Libraries Social Icons | Social media icons for the footer |
| UMD Libraries UI Pattern Sources | SDC pattern sources for Layout Builder |
The theme also requires the UI Patterns Drupal module (ui_patterns) to be installed and enabled.
Add the packages to your Drupal project using Composer, then enable the required modules via the Drupal admin interface or Drush.
In the Drupal admin, go to Appearance and set UMD Libraries Theme as the default theme.
Set up the site-wide regions using Drupal's Block Layout (/admin/structure/block). Follow the region order described in Base Layout (Drupal Block Layout):
Header region (top to bottom):
- UMD Header (if needed)
- UMD Lib Navigation
- UMD Lib Chat Widget (if needed)
- UMD Lib Alert (if needed)
Footer region (top to bottom):
- UMD Lib Scroll to Top
- UMD Lib Footer
Content pages should use Layout Builder to manage the main content area. Follow the instructions in Content Area Layout (Layout Builder) to set up page layouts.
When adding a new section in Layout Builder, use only the UMD Libraries Layout section option provided by the Layout Tools package.
- Review Layout for an overview of how Block Layout and Layout Builder work together.
- Review Components for available components and their usage.