GravityView is a commercial plugin available from https://gravityview.co. The plugin is hosted here on a public Github repository in order to better facilitate community contributions from developers and users. If you have a suggestion, a bug report, or a patch for an issue, feel free to submit it here.

If you are using the plugin on a live site, please purchase a valid license from the website. We cannot provide support to anyone that does not hold a valid license key.

---

Installing GravityView from Github

The plugin includes Git submodules that need to be included in the download for the plugin to be functional. In order to create a proper .zip file:

1. Clone the GravityView repo on your computer using the Github app
2. Install Homebrew
3. Run brew install git-archive-all
4. Use the following command in the Terminal:

cd /path/to/gravityview/
git-archive-all ../gravityview.zip

This will create a gravityview.zip file in the directory above the cloned GravityView plugin on your computer, which includes the submodules.

Run Unit Tests

The plugin uses PHPUnit as part of development process. Installing the testing environment is best done using a flavor of Vagrant (try Varying Vagrant Vagrants).

1. From your terminal SSH into your Vagrant box using the vagrant ssh command
2. cd into the root of your GravityView directory (VVV users can use cd /srv/www/wordpress-default/wp-content/plugins/gravityview/)
3. Run bash tests/bin/install.sh gravityview_test root root localhost where root root is substituted for your mysql username and password (VVV users can run the command as is).
   • If you are running locally and have Gravity Forms installed, the script will check for /gravityforms/ directory in your plugins folder. If it exists, it will use that directory.
   • If the script doesn't find a Gravity Forms directory, it will need the path to Gravity Forms directory or the URL of a .zip file passed as the 6th parameter. Example: bash tests/bin/install.sh gravityview_test root root localhost latest http://example.com/path/to/gravityview.zip or bash tests/bin/install.sh gravityview_test root root localhost latest ../gravityview/
4. Upon success you can run phpunit

If you want to generate a code coverage report you can run the following phpunit --coverage-html "./tmp/coverage" and then a report will be generated in the /tmp/coverage/ subdirectory of the GravityView plugin.

---

Thanks to:

• BrowserStack for automated browser testing
• Flexibility - Adds support for CSS flexbox to Internet Explorer 8 & 9
• Gamajo Template Loader - Makes it easy to load template files with user overrides
• jQuery Cookie plugin - Access and store cookie values with jQuery
• PHPEnkoder script encodes the email addresses