WordPress plugin that provides Athena Framework styling for Gravity Forms.
This plugin provides plug-and-go styling for Gravity Forms on sites that utilize the Athena Framework.
Most form configurations should work out-of-the-box, but please note that the following are not yet supported:
- Left and right-aligned labels
- CSS-ready classes
- "Enhanced user interface" fields
- Athena custom form inputs
Due to how Gravity Forms wraps advanced fields in containers with their sublabels, sublabels will only span the width of the field. Long custom sublabels may wrap to a new line in unexpected ways.
- 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
$ wp plugin install --activate https://github.com/UCF/Athena-GravityForms-Plugin/archive/master.zip. See WP-CLI Docs for more command options.
Enhancements:
- Added composer file.
Miscellaneous:
- Upgraded node dependencies
- Updated CSS to work with the new version of Gravity Forms 2.5.
Documentation:
- Updated contributing doc to reflect the switch from slack to teams.
Enhancements:
- Upgraded packages, including the Athena Framework, to latest versions
- Updated linter configs
- Replaced old scss-lint rules with sass-lint rules; cleaned up linter issues
Miscellaneous:
- Upgraded node dependencies
- Added linter configs, a CONTRIBUTING doc, and issue templates to the project
Bug fixes:
- Fixed sizing and positioning of list field add/delete buttons
- Added margin above progress bars when the form title or description is displayed above it
- Added character count text styles
Bug fixes:
- Added styles to hide honeypot validation fields.
- Initial release
n/a
None
Note that compiled, minified css 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.
- node
- gulp-cli
-
Clone the Athena-GravityForms-Plugin repo into your local development environment, within your WordPress installation's
plugins/directory:git clone https://github.com/UCF/Athena-GravityForms-Plugin.git -
cdinto the new Athena-GravityForms-Plugin 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, and install and activate GravityForms.
-
Activate this plugin on your development WordPress site.
-
Run
gulp watchto continuously watch changes to scss files. If you enabled BrowserSync ingulp-config.json, it will also reload your browser when plugin files change.
- 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.
Want to submit a bug report or feature request? Check out our contributing guidelines for more information. We'd love to hear from you!