https://github.com/web-illinois/illinois_framework_theme
An Illinois branded Drupal theme. Part of the Illinois Drupal Framework
https://github.com/web-illinois/illinois_framework_theme
drupal drupal-theme illinois-framework sass
Last synced: 5 days ago
JSON representation
An Illinois branded Drupal theme. Part of the Illinois Drupal Framework
- Host: GitHub
- URL: https://github.com/web-illinois/illinois_framework_theme
- Owner: web-illinois
- Created: 2020-05-21T14:38:29.000Z (almost 6 years ago)
- Default Branch: 5.x
- Last Pushed: 2026-04-21T17:21:11.000Z (5 days ago)
- Last Synced: 2026-04-21T18:41:14.430Z (5 days ago)
- Topics: drupal, drupal-theme, illinois-framework, sass
- Language: Twig
- Homepage: https://drupal.webtheme.illinois.edu/
- Size: 12.2 MB
- Stars: 6
- Watchers: 4
- Forks: 1
- Open Issues: 50
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Illinois Drupal Framework Theme
**NOTE:** This theme is intended to be used as part of the Illinois Drupal Framework Distribution. Using this theme without the profile and core module is not supported. Instructions on how to set up the Illinois Drupal Framework Distribution within cPanel can be found at https://github.com/web-illinois/illinois_framework_project.
# Customizing your site by creating a sub-theme
If you wish to customize the look and feel of your Illinois Drupal Framework website, creating a sub-theme is recommended. To create a sub-theme, follow the steps below. This is assuming a site is set-up using the steps found at https://github.com/web-illinois/illinois_framework_project
* Open a terminal and `cd` into `~/illinois_framework`
* Run the command `drush generate theme` which will step you through creating a new sub-theme. See the screenshot below as an example.
* The third prompt should be `Base theme [classy]`, enter `illinois_framework_theme`. This is what sets your custom theme as a sub-theme of the Illinois Framework.
* Answer the rest of the prompts as you see fit. The defaults are OK in most instances.
After generating your sub-theme with Drush, you'll need to modify the regions of your theme to match the Illinois Framework Theme. Replace "MY_THEME" with the machine name of your sub-theme.
* Edit the file `~/illinois_framework/docroot/themes/MY_THEME/MY_THEME.info.yml
* Replace the `regions:` section of the file with:
```
regions:
header: Header
nav_main: 'Main navigation region'
breadcrumb: Breadcrumbs
highlighted: Highlighted
help: Help Information
tabs: 'Tabs'
content: 'Main content'
sidebar_first: 'Sidebar first'
sidebar_second: 'Sidebar second'
footer: Footer
hidden: 'Hidden region for referenced blocks'
```
After your sub-theme is created, you'll need to set it as your site's theme. To do that, follow these steps:
* Login to your site as an administrator
* Click "Appearance" in the admin toolbar
* Scroll down to "Uninstalled Themes"
* Find your sub-theme and click the "Install and set as default" button
# Contributing to the Illinois Framework Theme
If you encounter any issues with the Illinois Framwork, please feel free to submit an issue to our [issue queue](https://github.com/web-illinois/illinois_framework_theme/issues).
The WIGG Drupal group is welcoming contributions from anyone on campus. Please see the [WIGG Drupal webpage](https://webguidelines.web.illinois.edu/subcommittees/drupal/) for more information.
# Configuring the Sidebar Menu Block
- To get the sidebar menu to work correctly go to /admin/structure/block
- Sidebar first: Main navigation block
- display title - toggle off
- under html and style options change to: menu__side_bar_first
## Developing the theme
## Twig Templating with Twig Tweak
If you are looking to modify the twig templates there are some shortcuts provided by the [Twig Tweak Module](https://www.drupal.org/project/twig_tweak). See the [cheat sheet](https://www.drupal.org/docs/contributed-modules/twig-tweak/cheat-sheet).