Main Site Utilities
Various utilities and wp-cli tasks for Main-Site
by UCF Web Communications · github.com/ucf/main-site-utilities-plugin
Install
No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:
wp plugin install https://github.com/ucf/main-site-utilities-plugin/archive/refs/heads/master.zipReadme
Main Site Utilities WP-CLI Package
Provides utilities (jobs) to run for the main website.
Description
Provides utilities (jobs) to run for the main website.
Installation
Manual Installation
- Upload the plugin files (unzipped) to the
/wp-content/pluginsdirectory, or install the plugin through the WordPress plugins screen directly. - Activate the plugin through the "Plugins" screen in WordPress
- Run commands via wp cli. See WP-CLI Docs for more command options.
WP CLI Installation
$ wp plugin install --activate https://github.com/UCF/Main-Site-Utilities/archive/master.zip. See WP-CLI Docs for more command options.- Run commands via wp cli.
Commands
Research Import
wp research import
<search_url>
[--params=<params>]
[--force-template=<bool>]
[--force-update=<bool>]
Options
| Option | Type | Description | Default |
|---|---|---|---|
search_url |
string |
The URL of the search service. | empty |
--params |
string |
An HTML encoded parameter string. Can be used to add additional filtering to the search service endpoint. | null |
--force-template |
bool |
If True, forces an update to the page template for each researcher imported. | false |
--force-update |
bool |
If True, removes all researchers prior to importing. | false |
Expert Import
wp expert import
<csv_url>
[--force-template=<bool>]
[--force-update=<bool>]
| Option | Type | Description | Default |
|---|---|---|---|
csv_url |
string |
The URL of the CSV containing the experts to import. | empty |
--force-template |
bool |
If True, forces an update to the page template for each expert imported. | false |
--force-update |
bool |
If True, removes all experts prior to importing. | false |
Changelog
3.3.0
Enhancements:
- Added article template converter to move articles from the old to new template.
3.2.1
Bug Fixes:
- Base url was changed in order to fix the outgoing links.
3.2.0
- changed the post method to get method and added the Limit & offset querystring.
- job object was modified.
3.1.1
Bug Fixes:
- The code for the prior release was never checked in.
3.1.0
Enhancements:
- Added an expert importer.
3.0.2
Enhancements:
- Added composer file.
3.0.1
Bug Fixes:
- Corrected a syntax error that causes problems when using WP CLI.
3.0.0
Enhancements:
- Addition of the Workday job listings shortcode
[ucf-jobs]. - This also changes the main plugin's file name from commands.php to main-site-utilities.php, which results in the plugin being deactivated if pushed when currently activated for the site. To go around this we can just deactivate it before we push up the changes to new environments. This shouldn't effect anything, since the only thing we use this plugin for currently is running WP-CLI commands.
- New customizer options have been created for the Jobs/WorkDay URLs for the feed and the base site URL. The base URL is used to create the individual job listing links, since just the relative path to them is included in the json feed. The defaults set for them will need to be updated once we have the "live" WorkDay URLs come July 1.
- A future tag will add in the ability to filter listings by Job Family (faculty, staff, etc).
2.0.0
Enhancements:
- Added importers for research from the search service, as well as for researchers' data from external WP instances.
- Removed importers that are no longer in use.
1.0.1
Enhancements:
- Added converter/importer for azindex links.
Bug Fixes:
- Updated name of
Doctoralprogram type toDoctorateto match the logic used during the import.
1.0.0
- Initial release
Upgrade Notice
n/a
Installation Requirements
None
Development & Contributing
NOTE: this plugin's readme.md file is automatically generated. Please only make modifications to the readme.txt file, and make sure the gulp readme command has been run before committing readme changes.
Read the full README on GitHub →
Releases
| Tag | Published |
|---|---|
| v3.3.0 | May 29, 2026 |
| v3.2.1 | Aug 13, 2024 |
| v3.2.0 | Aug 12, 2024 |
| v3.1.1 | Dec 12, 2023 |
| v3.1.0 | Dec 12, 2023 |
| v3.0.2 | Mar 21, 2023 |
| v3.0.1 | Aug 10, 2022 |
| v3.0.0 | Jul 13, 2022 |
| v2.0.0 | Jan 3, 2022 |
| v1.0.1 | Nov 9, 2017 |
| v1.0.0 | Jun 14, 2017 |
These releases are tags only. The author does not attach a packaged zip, so there are no download counts to report.