-
Notifications
You must be signed in to change notification settings - Fork 0
/
README.txt
64 lines (39 loc) · 3.57 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
=== {{My Project}} ===
Contributors: ucfwebcom
Requires at least: 5.3 {{Update as needed!}}
Tested up to: 5.3 {{Update as needed!}}
Stable tag: 0.0.0
Requires PHP: 7.4 {{Update as needed!}}
License: GPLv3 or later
License URI: http://www.gnu.org/copyleft/gpl-3.0.html
{{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](https://github.com/UCF/{{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](https://codex.wordpress.org/Debugging_in_WordPress) 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 {{My-Project}} repo into your local development environment, within your WordPress installation's `plugins/` directory: `git clone https://github.com/UCF/{{My-Project}}.git`
2. `cd` into the new {{My-Project}} 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](https://browsersync.io) 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 plugin, 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).
3. Run `gulp default` to process front-end assets.
4. 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](https://github.com/UCF/{{My-Project}}/wiki/Installation#installation-requirements){{ENDIF}}.
5. Activate this plugin on your development WordPress site.
6. Configure plugin settings from the WordPress admin under "{{Your plugin's admin menu label}}".
7. Run `gulp watch` to continuously watch changes to scss and js files.{{edit this list if the plugin doesn't include css/js!}} If you enabled BrowserSync in `gulp-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 readme` command has been run before committing README changes. See the [contributing guidelines](https://github.com/UCF/{{My-Project}}/blob/master/CONTRIBUTING.md) for more information.
== Contributing ==
Want to submit a bug report or feature request? Check out our [contributing guidelines](https://github.com/UCF/{{My-Project}}/blob/master/CONTRIBUTING.md) for more information. We'd love to hear from you!