| Dir : /home/trave494/footcrew.com/ads/wp-content/themes/classipress/includes/recaptcha/ |
| Server: Linux ngx353.inmotionhosting.com 4.18.0-553.22.1.lve.1.el8.x86_64 #1 SMP Tue Oct 8 15:52:54 UTC 2024 x86_64 IP: 209.182.202.254 |
| Dir : /home/trave494/footcrew.com/ads/wp-content/themes/classipress/includes/recaptcha/README.md |
# Google reCaptcha 2.0
Provides support for Google reCaptcha v.2.0.
It provides three helper functions:
* `appthemes_display_recaptcha` - Display the ReCaptcha
* `appthemes_recaptcha_verify` - Verifies the user response
* `appthemes_enqueue_recaptcha_scripts` - Adds action to `wp_enqueue_scripts` and enqueues necessary scripts
Accepted theme support parameters:
- `public_key` *already existed*
- `private_key` *already existed*
- `theme` *already existed* - *new values:* `light` (default) | `dark`
- `size` - **new!** - *values:* `normal` (default) | `compact` (default if `wp_is_mobile()` is **true**)
- `type` - **new!** - *values:* `image` (default) | `audio`
**Changes from older version**
- Themes no longer need to include the reCaptcha library passing it trough the `file` param since the new library is included in the framework. The module still checks for this parameter to fallback to the old reCaptcha in case the old library is still being used.
- The custom `appthemes_recaptcha()` helper used by each theme to display the ReCaptcha is replaced by `appthemes_display_recaptcha()` provided by the module
- The available reCaptcha colors are now limited to: `Light` and `Dark`.
**Usage**
Themes must explicitly enqueue the JS reCaptcha library using the `g-recaptcha` handle or function `appthemes_enqueue_recaptcha_scripts()`, on every page where the reCaptcha will be displayed. This ensures it is not enqueued on every page.
* *Enqueue*
```
if ( current_theme_supports( 'app-recaptcha' ) ) {
appthemes_enqueue_recaptcha_scripts();
}
```
* *Display*
```
if ( current_theme_supports( 'app-recaptcha' ) ) {
appthemes_display_recaptcha()
}
```
* *Verify Response*
```
if ( current_theme_supports( 'app-recaptcha' ) ) {
// Verify the user response.
$response = appthemes_recaptcha_verify();
if ( is_wp_error( $response ) ) {
// Error! - check WP_Error object
return $response;
}
// Success!!
}
```