Merge pull request #523 from auth0/dev

Release 3.7.0

CHANGELOG.md

@@ -1,5 +1,36 @@
 # Change Log
 
+## [3.7.0](https://github.com/auth0/wp-auth0/tree/3.7.0) (2018-08-13)
+[Full Changelog](https://github.com/auth0/wp-auth0/compare/3.6.2...3.7.0)
+
+**Closed issues**
+- Optionally load client ID, secret and domain from environment [\#480](https://github.com/auth0/wp-auth0/issues/480)
+- Allow login redirect URL to point to an in-network domain for multi-site [\#459](https://github.com/auth0/wp-auth0/issues/459)
+
+**Added**
+- Add new IP addresses and tests for WP_Auth0_Ip_Check [\#513](https://github.com/auth0/wp-auth0/pull/513) ([joshcanhelp](https://github.com/joshcanhelp))
+- Add constant settings support [\#509](https://github.com/auth0/wp-auth0/pull/509) ([joshcanhelp](https://github.com/joshcanhelp))
+- Add translation ability [\#507](https://github.com/auth0/wp-auth0/pull/507) ([joshcanhelp](https://github.com/joshcanhelp))
+- Add more info to Contributing section, including tests [\#506](https://github.com/auth0/wp-auth0/pull/506) ([joshcanhelp](https://github.com/joshcanhelp))
+- Add custom domain support with tests; add compat test to Circle CI [\#505](https://github.com/auth0/wp-auth0/pull/505) ([joshcanhelp](https://github.com/joshcanhelp))
+- Add testing suite, initial tests, and CircleCI [\#503](https://github.com/auth0/wp-auth0/pull/503) ([joshcanhelp](https://github.com/joshcanhelp))
+- Add code quality tools and contrib instructions [\#498](https://github.com/auth0/wp-auth0/pull/498) ([joshcanhelp](https://github.com/joshcanhelp))
+
+**Changed**
+- Update new Application creation URLs [\#514](https://github.com/auth0/wp-auth0/pull/514) ([joshcanhelp](https://github.com/joshcanhelp))
+- Add support for subdomains and different scheme URLs for redirect [\#512](https://github.com/auth0/wp-auth0/pull/512) ([joshcanhelp](https://github.com/joshcanhelp))
+- Update wordpress.org readme [\#500](https://github.com/auth0/wp-auth0/pull/500) ([joshcanhelp](https://github.com/joshcanhelp))
+
+**Removed**
+- Remove account cleanup tool [\#510](https://github.com/auth0/wp-auth0/pull/510) ([joshcanhelp](https://github.com/joshcanhelp))
+- Remove connection settings [\#502](https://github.com/auth0/wp-auth0/pull/502) ([joshcanhelp](https://github.com/joshcanhelp))
+- Remove signup disabling [\#501](https://github.com/auth0/wp-auth0/pull/501) ([joshcanhelp](https://github.com/joshcanhelp))
+
+**Fixed**
+- Fix login processing if already logged in [\#518](https://github.com/auth0/wp-auth0/pull/518) ([joshcanhelp](https://github.com/joshcanhelp))
+- Fix PHP notice for Amplificator widget [\#511](https://github.com/auth0/wp-auth0/pull/511) ([joshcanhelp](https://github.com/joshcanhelp))
+- Fix whitespace [\#499](https://github.com/auth0/wp-auth0/pull/499) ([joshcanhelp](https://github.com/joshcanhelp))
+
 ## [3.6.2](https://github.com/auth0/wp-auth0/tree/3.6.2) (2018-06-29)
 [Full Changelog](https://github.com/auth0/wp-auth0/compare/3.6.1...3.6.2)
 

README.md

@@ -3,7 +3,7 @@
 Login by Auth0
 ====
 
-Single Sign On for Enterprises + Social Login + User/Passwords. For all your WordPress instances. Powered by Auth0.
+Single Sign On for Enterprises + Social Login + User/Passwords + Passwordless. For all your WordPress instances. Powered by Auth0.
 
 * [WordPress.org plugin page](https://wordpress.org/plugins/auth0/)
 * [Documentation (installation, configuration, more)](https://auth0.com/docs/cms/wordpress)
@@ -30,7 +30,12 @@ We're happy to review and approve new filters and actions that help you integrat
 * Change the least amount of code to achieve the goal; PRs with lots of whitespace changes and abstraction combined with a feature add or bug fix are difficult to review and may be rejected
 * Use the latest version of WordPress and turn `WP_DEBUG` on
 * If other plugins are installed during testing that might affect behavior, please list those in the PR description
-* Make sure to test against the lowest PHP version supported (see `Requires PHP:` [here](readme.txt#L5)) 
+* Run the [Composer](https://getcomposer.org/doc/00-intro.md#installation-linux-unix-osx) scripts listed below before creating your PR:
+	* `composer phpcbf` to correct whitespace project-wide (required by CI)
+	* `composer compat` to check for PHP version compatibility (currently 5.3; required by CI)
+	* `composer phpcs-tests` to run code standard checks on test files (required by CI)
+	* `composer phpcs-path ./path/to/file/changed.php` to find other potential issues (not required by CI currently)
+	* `composer test` to run all tests (required by CI; see [Testing](#testing) below)
 
 ### How to install and configure WordPress for testing
 
@@ -53,20 +58,49 @@ git clone https://github.com/joshcanhelp/auth0-wp-test.git ./wp-content/themes/a
 # Optional, clones the testing theme to assist with development
 ```
 
-The main requirement for testing, though, is using the latest version of WordPress with our minimum supported PHP version. 
+For a more complete script, [see this Gist](https://gist.github.com/joshcanhelp/50f66002643ece68f01bf5f94e1abe56).
 
-### How to build the initial setup assets?
+The main requirement for testing, though, is using the latest version of WordPress with our minimum supported PHP version and testing both single and multi-site setups. 
 
-You need to install the stylus tool and run this command (inside /assets/css):
+### Testing
 
+All new features and functionality should also include unit tests coverage. The plugin currently has the WP-CLI test scaffolding, a composer script, and tests for the latest functionality. 
+
+WordPress testing is a bit different from typical testing in PHP, mainly because of the need for a working database. To run tests locally, you'll need to install the test suite, which is [covered here](https://make.wordpress.org/cli/handbook/plugin-unit-tests/#running-tests-locally). Run this install command:
+
+```bash
+bin/install-wp-tests.sh wordpress_test root '' localhost latest
 ```
-$ stylus -c -o initial-setup.css initial-setup/main.styl
+
+... changing the options for your local setup. Once that completes succesfully, you can run the Composer script:
+
+```bash
+composer test
 ```
 
-To watch and auto-compile it while working:
+... to run all tests or:
+
+```bash
+composer test-path ./tests/testFiletoRun.php
+```
 
+... to run a specific test. 
+
+Please note that we are in the early stages of adding testing to this plugin so feedback on the current setup, including any problems you're having setting it up, are welcome and encouraged in the [Issues](https://github.com/auth0/wp-auth0/issues) tab. 
+
+
+### CSS pre-processing
+
+You need to install the stylus tool and run this command (from the plugin root):
+
+```bash
+stylus -c -o assets/css/initial-setup.css assets/css/initial-setup/main.styl
 ```
-$ stylus -w -o initial-setup.css initial-setup/main.styl
+
+To watch and auto-compile it while working:
+
+```bash
+stylus -cw -o assets/css/initial-setup.css assets/css/initial-setup/main.styl
 ```
 
 ## Issue Reporting