https://github.com/its-digital-technology/global-elements-wordpress
https://github.com/its-digital-technology/global-elements-wordpress
Last synced: 8 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/its-digital-technology/global-elements-wordpress
- Owner: ITS-Digital-Technology
- Created: 2022-05-09T17:45:47.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-01-06T21:24:30.000Z (11 months ago)
- Last Synced: 2025-02-16T00:43:46.266Z (10 months ago)
- Language: PHP
- Size: 156 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# NU Global Elements - kernl(ui) - WordPress Plugin
## Introduction
A WordPress plugin developed by the Northeastern University ITS Web Solutions team. Loads the latest version of [kernl(ui) Global Elements](https://northeastern.netlify.app/pattern-library/page-chrome/global-elements/) to your website, including the code for the [TrustArc](https://trustarc.com/) cookie consent manager.
The global elements package includes a few elements that should be included on almost all Northeastern sites. They have dynamic content and fixed designs for consistency across sites. TrustArc allows users to set their cookie preferences, and is now required on all Northestern University websites.
[Learn more about the kernl(ui) design system](https://northeastern.netlify.app/)
## Requirements
- **Global Header.** In order for the global header to display, the active theme must support a call to `wp_body_open()` after the opening `` tag:
```php
...
```
- **Conflicts.** If older versions of the NU Global elements are active on the site, changes to the theme files or settings in a plugin may be needed in order to prevent old and new global elements from showing.
## Installation
1. Download the latest version of the plugin from [GitHub](https://github.com/ITS-Digital-Technology/global-elements-wordpress/releases/latest/download/global-elements-wordpress.zip).
2. Add the new plugin through WP Admin, uploading the `.zip` file from step 1.
3. Activate the new plugin once it has finished uploading.
4. If you need to stop this plugin from displaying the global header, footer, or TrustArc elements, you can do so from the settings page for this plugin in WP Admin.
5. If you need more detailed instructions, see this [KB article](https://service.northeastern.edu/tech?id=kb_article_view&sysparm_article=KB000022192).
### TrustArc Visibility
Some themes may have a height style on iframes. This can be tested by opening the Cookie Preferences link found as the last item in the footer (front end), where the TrustArc modal may be partly obscured when open. If so, you can override with the following style:
.truste_popframe {
height: var(--truste-popframe-height) !important;
}