Caution
As of 26 July 2024, this project is archived and no longer being actively maintained.
This is the WordPress theme for the Washington State University Human Resource Services (WSU HRS) website. It is a standalone theme based on the WSU Web Design System and built as a block theme for full site editing.
Block themes use blocks for all parts of the site, including navigation menus, header, content, and site footer. This allows admins to edit all parts of the site and to create new templates without having to modify the theme code. With a block theme, you can place and edit blocks outside your content using the Template Editor or Site Editor.
This theme includes a variety of built-in templates to handle displaying different types of content.
A WordPress pattern is a collection of blocks arranged together into an intentional section for a page or post. Once inserted into a page, the author can edit and customize the blocks to their needs. Patterns help to add complex layouts without having to start from scratch every time.
This theme includes patterns both at the template level and for general content.
This theme is not in the WordPress directory. You have to install it manually either with SFTP or from the WordPress themes screen:
- Download the latest version from GitHub and rename the .zip file to:
hrswp-theme-wds.zip. - From here you can either extract the files into your plugins directory via SFTP or navigate to the Plugins screen in the admin area of your site to upload it through the plugin uploader (steps 3-5).
- Select Themes > Add New and then select the "Upload Theme" button.
- Select "Browse" and locate the downloaded .zip file for the theme (it must be a file in .zip format) on your computer. Select "Install Now."
- You should receive a message that the theme installed correctly. Select "Activate Theme" or return to the themes page to activate later.
This theme will not update automatically and will not notify of available updates. It is your responsibility to make sure you stay up to date with the latest version.
This theme does not store any user information.
The development environment relies on NPM, using the @wordpress/scripts package, and Composer. The package.json and composer.json configuration files manage dependencies for testing and building the production version of the theme. The NPM scripts in package.json do most of the heavy lifting. Please follow the development workflow outlined in the Contributing guide.
- Clone the theme to a directory on your computer.
- Change into that directory.
- Install the NPM and Composer dependencies.
- Ensure linting and coding standards checks are working -- this should exit with zero (0) errors.
- Create a new branch for local development.
In a terminal:
git clone https://github.com/washingtonstateuniversity/hrswp-theme-wds.git
cd hrswp-theme-wds
npm install
composer install
npm run lint
git checkout -b new-branch-nameThe following commands will handle basic build functions.
npm run build: Transforms the code according the configuration so it’s ready for production and optimized for the best performance.npm run lint: Check all PHP and CSS files for coding standards compliance.npm run start: Transforms your code according the configuration provided so it’s ready for development.
See the scripts section of package.json for additional available commands.
Archived: WSU HRS no longer maintains this plugin.
All notable changes are documented in the CHANGELOG.md, with dates and version numbers.
Please submit bugs and feature requests through GitHub Issues. Refer to CONTRIBUTING.md for the development workflow and details for submitting pull requests.