Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/ucf/creol-research-group/archive/refs/heads/main.zip{{My Project}}
{{Here is a short description of the plugin. This should be no more than 150 characters. No markup here.}}
Description
{{This is the long description. No limit, and you can use Markdown (as well as in the following sections).}}
Documentation
Head over to the {{My Project}} wiki for detailed information about this plugin, installation instructions, and more.
Changelog
= 1.0.0 = {{Update number as needed!}}
- Initial release
Upgrade Notice
n/a
Development
Note that compiled, minified css and js {{edit this list if the plugin doesn't include css/js!}} files are included within the repo. Changes to these files should be tracked via git (so that users installing the plugin using traditional installation methods will have a working plugin 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
-
Clone the {{My-Project}} repo into your local development environment, within your WordPress installation's
plugins/directory:git clone https://github.com/UCF/{{My-Project}}.git -
cdinto the new {{My-Project}} directory, and runnpm installto install required packages for development intonode_modules/within the repo -
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 asgulp-config.json.To enable BrowserSync, set
synctotrueand assignsyncTargetthe base URL of a site on your local WordPress instance that will use this plugin, such ashttp://localhost/wordpress/my-site/. YoursyncTargetvalue will vary depending on your local host setup.The full list of modifiable config values can be viewed in
gulpfile.js(seeconfigvariable). -
Run
gulp defaultto process front-end assets. -
If you haven't already done so, create a new WordPress site on your development environment to test this plugin against{{IF THIS PLUGIN REQUIRES OTHER PLUGINS:}}, and install and activate all plugin dependencies{{ENDIF}}.
-
Activate this plugin on your development WordPress site.
-
Configure plugin settings from the WordPress admin under "{{Your plugin's admin menu label}}".
-
Run
gulp watchto continuously watch changes to scss and js files.{{edit this list if the plugin doesn't include css/js!}} If you enabled BrowserSync ingulp-config.json, it will also reload your browser when plugin files change.
Other Notes
- This plugin's README.md file is automatically generated. Please only make modifications to the README.txt file, and make sure the
gulp readmecommand has been run before committing README changes. See the contributing guidelines for more information.
Contributing
Want to submit a bug report or feature request? Check out our contributing guidelines for more information. We'd love to hear from you!