Skip to content

Installation

Jim Barnes edited this page Feb 22, 2024 · 6 revisions

Navigation


Installation requirements

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

While this theme should work against any server running the minimum requirements for WordPress installations, we cannot guarantee compatibility with, or provide support for, installations on non-LAMP stacks (e.g. Windows installations).

Required Plugins

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

Supported Plugins

The plugins listed below are extended upon in this theme--this may include custom layouts for feeds, style modifications, etc. These plugins are not technically required on sites running this theme, and shouldn't be activated on sites that don't require their features. A plugin does not have to be listed here to be compatible with this theme.

For more information on how these plugins are extended in this theme, please see our Plugin Extensions and Overrides docs.


Installation instructions

Before getting started: make sure you've satisfied all the installation requirements for this theme, and that any required plugins or recommended plugins that you wish to use are installed and activated.

  1. Install the theme:**

    • via Github Updater

      This theme supports installation and updates via the Github Updater plugin. See their documentation for more information on setup and usage. (Requires PHP 5.6.0+)

    • via standard (manual) installation

      Download the theme .zip file here: https://github.com/UCF/UCF-WordPress-Theme/archive/master.zip

      This theme can be installed via traditional installation methods if desired. After downloading the latest theme .zip file onto your computer, follow the steps on this page.

      Alternatively, if you're running a WordPress Multisite instance, you can install the theme by navigating to the network admin, go to Themes > Add New, then click the "Upload Theme" button to upload the .zip file. After uploading and installing the theme, you can choose to either network activate it, or activate the theme for a specific site (navigate to All Sites, click on a site in the list, then click the Themes tab and enable the theme in the list.)

    • via WP-CLI

      $ wp theme install https://github.com/UCF/UCF-WordPress-Theme/archive/master.zip

      See the WP-CLI docs for more information.

  2. Activate the theme: from your site's admin, navigate to Appearance > Themes, hover over the theme's thumbnail, and click the "Activate" button that appears.

  3. Configure the theme: create and set menus, and make any other configuration updates noted in the theme configuration steps.

That's it! Now you're ready to start adding content.

** Note that this theme is not deployed to the WordPress theme directory, and therefore will not notify you of theme updates, unless you are using Github Updater. You are responsible for keeping your copy of this theme up-to-date with bugfixes and other new releases.


Theme configuration

After installing this theme, you should perform the following configuration steps:

  • Download this theme's ACF config file, and import field groups using the ACF importer under Custom Fields > Tools.

    NOTE: Some child themes may be configured to use their own ACF config; check the documentation for dependent child themes for specific field import instructions.

  • Create and set a static front page under Settings > Reading.

  • Create and assign a menu to the "Header Menu" menu location under Appearance > Menus. The top-level navigation from ucf.edu will be used as fallback navigation if a header menu isn't provided.

  • If desired, create a site footer by assigning widgets to footer columns under Appearance > Widgets.