Drupal for Illinois Websites
What is the Illinois Drupal Framework?
The Illinois Drupal Framework is a product of the WIGG Drupal working group. It is a centralized Drupal distribution designed specifically for campus web administrators, developers, and IT professionals. It provides a robust, accessible, and university-branded foundation for rapidly deploying modern Drupal websites across campus units.
Is this Framework right for you?
This framework is built for technical site builders and campus web administrators managing digital infrastructure for their units. Utilizing the framework requires a working knowledge of Drupal site administration, dependency management via Composer, and navigating hosting environments such as the campus cPanel service.
Note: The WIGG team provides the tools and a collaborative community, but does not perform unit deployments or build websites on your behalf.
Framework Architecture
The framework operates as a Composer-ready Drupal installation profile comprised of three main components:
- Illinois Framework Profile: Defines the Drupal distribution and includes high-level system configurations.
- Illinois Framework Core: Packages the default set of required modules, pre-configured Paragraphs, and Content Types.
- Illinois Framework Theme: The front-end presentation layer, utilizing Twig templates to ensure adherence to campus branding and accessibility standards out of the box. It relies heavily on the Illinois Web Toolkit.
How do I use the Illinois Drupal Framework?
The framework is intended to be hosted on the campus cPanel service, but can be run on any server that supports the necessary services. The codebase is structured to support seamless version control, automated testing integrations, and local development environments (like DDEV or Lando) before pushing to production.
Instructions on setting up a site on cPanel can be found in the README of the Illinois Framework project repository. If you find any issues or want to suggest new features, please submit a ticket to the GitHub issue tracker.
Join our Developer Community
Whether you are heavily focused on front-end theme development or back-end migrations and module configuration, your contributions help improve the framework for the entire campus.
If you have some general feedback, please fill out our feedback form. We also host a Microsoft Teams channel that includes monthly meetings. Please join our MS Teams group (WIGG Drupal) if you'd like to start a discussion, get feedback, or participate in online meetings.
Contributing to Code Repositories
If you'd like to submit pull requests or create issues, please follow these steps:
- Create a GitHub account associated with your @illinois.edu e-mail address.
- Review the GitHub Shared Service - End User Service Agreement from AITS.
- Join our Web at Illinois GitHub organization by going to https://github.com/orgs/web-illinois/sso.
As a member of the Web at Illinois organization, you can download the code, create issues, and comment on existing pull requests. If you aren't sure which repository to use for a new issue, please add it to the theme's issue queue.
This site is running on the Illinois Drupal Framework version 5.0