Skip to content

WordPress theme that serves up HTML emails for bi-weekly news & announcements, events, and weekly coronavirus updates.

Notifications You must be signed in to change notification settings

UCF/UCF-GMUCF-Theme

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Good Morning UCF Theme

This theme is used to generate the email content for the UCF Today and UCF Events emails sent out each week via Postmaster, and can also be used for managing other custom emails (with additional plugins). It also provides a barebones post template using the Athena Framework for one-off pages.

Installation Requirements

This theme is developed and tested against WordPress 5.3+ and PHP 7.3+.

Required Plugins

These plugins must be activated for the theme to function properly.

Recommended Plugins

These plugins are not technically required for this theme to function normally, but are generally expected to be installed for full functionality of the GMUCF site:

Configuration

After installing this theme and all necessary dependencies, you should perform the following configuration steps:

  • Make sure your site's timezone is configured appropriately under Settings > General. This step is required to ensure certain theme functionality works as expected. (EST time is UTC-4)
  • Download this theme's ACF config file, and import field groups using the ACF importer under Custom Fields > Tools.
  • If implementing the Request Email form: Download the Request Email Gravity Form config file, and import the file under Forms > Import/Export > Import Forms. You should then create a new page and include this form on it.
  • Adjust site settings as necessary via the Customizer. All fields are expected to have a value; default values will be applied on empty fields (see GMUCF_THEME_CUSTOMIZER_DEFAULTS in includes/config.php).

Development

Note that compiled, minified css and js files are included within the repo. Changes to these files should be tracked via git (so that users installing the theme using traditional installation methods will have a working theme out-of-the-box.)

Enabling debug mode in your wp-config.php file is recommended during development to help catch warnings and bugs.

Requirements

  • node v16+
  • gulp-cli

Instructions

  1. Clone the UCF-GMUCF-Theme repo into your local development environment, within your WordPress installation's themes/ directory: git clone https://github.com/UCF/UCF-GMUCF-Theme.git

  2. cd into the new UCF-GMUCF-Theme directory, and run npm install to install required packages for development into node_modules/ within the repo

  3. Optional: If you'd like to enable BrowserSync for local development, or make other changes to this project's default gulp configuration, copy gulp-config.template.json, make any desired changes, and save as gulp-config.json.

    To enable BrowserSync, set sync to true and assign syncTarget the base URL of a site on your local WordPress instance that will use this theme, such as http://localhost/wordpress/my-site/. Your syncTarget value will vary depending on your local host setup.

    The full list of modifiable config values can be viewed in gulpfile.js (see config variable).

  4. Run gulp default to process front-end assets.

  5. If you haven't already done so, create a new WordPress site on your development environment, and install and activate theme dependencies.

  6. Set the UCF GMUCF Theme as the active theme.

  7. Make sure you've completed all theme configuration steps.

  8. Run gulp watch to continuously watch changes to scss and js files. If you enabled BrowserSync in gulp-config.json, it will also reload your browser when scss or js files change.

About

WordPress theme that serves up HTML emails for bi-weekly news & announcements, events, and weekly coronavirus updates.

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published