Refresh user claim

[rkcreation]

Fix #339
Address #122

All Submissions:

• Have you followed the plugin Contributing guideline?
• Does your code follow the WordPress' coding standards?
• Have you checked to ensure there aren't other open Pull Requests for the same update/change?

Changes proposed in this Pull Request:

Adding a new WP action to trigger user claim refresh.

How to test the changes in this Pull Request:

1. Updates manually some attributes of your user
2. Checks that $user->get('openid-connect-generic-last-user-claim') contains outdated information
3. Calls

$user = wp_get_current_user();
$token_response = $user->get('openid-connect-generic-last-token-response');
do_action( 'openid-connect-generic-refresh-user-claim', $user, $token_response );

4. Checks that $user->get('openid-connect-generic-last-user-claim') contains updated information

Other information:

• Have you added an explanation of what your changes do and why you'd like us to include them?
• Have you written new tests for your changes, as applicable?
• Have you successfully run tests with your changes locally?

Changelog entry

Adding a new WP action to trigger user claim refresh: do_action( 'openid-connect-generic-refresh-user-claim', $user, $token_response )

[timnolte]

@rkcreation this is the feature I was meaning to comment on. ;-)

...just a heads up that I'm going to change this implementation a bit since there is now, with the release, a plugin singleton available that you can use to access some methods of the plugin directly. I'm going to change the new method so that it is available through this method as well as change the add_action to a do_action. This will allow you to either use the method that was added in your own add_action that the plugin will trigger, or you can just use the new method in any hook you would like, include any others provided by this plugin that make sense. Let me know if you have any concerns with that change.

[timnolte]

@rkcreation so after my refactor using the new singleton pattern you'll be able to do is this:

$user = wp_get_current_user();
$token_response = $user->get('openid-connect-generic-last-token-response');
oidcg_refresh_user_claim( $user, $token_response );