Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mlibrary/umlib_admin

Drupal admin theme for U-M Library based on the Claro theme
https://github.com/mlibrary/umlib_admin

design design-system drupal

Last synced: 6 days ago
JSON representation

Drupal admin theme for U-M Library based on the Claro theme

Awesome Lists containing this project

README

        

# umlib_admin
Theme development environment:
- Drupal version: 10.1.6
- Claro version: 10.1.6

Please contact [email protected] if you notice any updates or changes needed based on your installed Drupal version.

This is the admin drupal theme for U-M Library sites built using the Claro admin theme as a parent. The umlib_admin theme uses styles from the U-M Library Design System.

## Regions & Blocks
Coming soon: block configuration- in the meantime, please use the below as a start.

The website header relies on two blocks in the header region.

Region: Header
- Site branding
- User account menu

Region: Pre-content
- Page title
- Primary tabs
- Secondary tabs

Region: Breadcrumb
- Breadcrumb

Region: Highlighted
- Status Messages

Region: Content:
- Primary admin actions
- Main content

For more information, see the Drupal umlib_admin Figma file. Ask Bridget for permission as needed.

## Website header

The website header pulls in the system site name provided in your Drupal instance (Configuration > System > Site name) and the logo and favicons files provided with this theme (`logo.svg` and `favicon.ico`.)

Ensure that the following are checked in Appearance settings:

- [X] Use the logo supplied by the theme
- [X] Use the favicon supplied by the theme

### Setup

**To add this theme to your Drupal full stack project using composer:**

```
vi composer.json
```

and add the following below your drupal line in repositories

```
"repositories": {
"drupal": {
"type": "composer",
"url": "https://packages.drupal.org/8"
},
"umlib_admin-theme": {
"type": "package",
"package": {
"name": "mlibrary/umlib_admin",
"version": "1.0",
"type": "drupal-theme",
"dist": {
"type": "zip",
"url": "https://github.com/mlibrary/umlib_admin/archive/refs/heads/main.zip",
"reference": "main"
}
}
},
```

You may also wish to alter what directory the theme is installed in

```
"extra": {
"enable-patching": true,
"patchLevel": {
"drupal/core": "-p2"
},
"installer-paths": {
"core": [
"type:drupal-core"
],
"libraries/{$name}": [
"type:drupal-library"
],
"modules/contrib/{$name}": [
"type:drupal-module"
],
"themes/contrib/{$name}": [
"themes/{$name}": [
"type:drupal-theme"
],
```

### Install

You can now run the following to get the latest version of the umlib_base theme

```
composer require mlibrary/umlib_admin
```

### Update

To get the lastest version in an existing project, you unfortunately cannot simply run composer update. Instead run

```
composer clear-cache
composer reinstall mlibrary/umlib_admin
```