====== Hyvä reCAPTCHA v3 (Enterprise) Extension User Guide for Magento 2 ======

===== Extension context =====

This is a Toweringmedia Magento 2 extension guide generated from the Magento Admin virtual product catalog.

===== Product page =====

  * [[https://toweringmedia.com/towering-media-hyva-recaptcha-v3-enterprise|Hyvä reCAPTCHA v3 (Enterprise) Extension]]

===== Overview =====

Towering Media — reCAPTCHA Enterprise (Hyvä Forms) User Guide This guide shows how to configure and confirm protection for the forms supported by our module. Module: Toweringmedia_HyvaRecaptchaV3 Composer package: toweringmedia/hyva-recaptcha-v3 Magento Admin path: Stores → Configuration → Security → Towering Media reCAPTCHA (Enterprise) What this module does Generates a reCAPTCHA Enterprise v3 token when a user submits a protected form Sends the token to Google’s Enterprise Assessments API server-side Blocks spam based on: Expected Action Minimum Score Threshold Optional Strict Hostname Match Quick start checklist In Google Cloud: enable reCAPTCHA Enterprise API and create an Enterprise Site Key In Magento.

===== What this extension does =====

  * adds invisible reCAPTCHA protection to Magento 2 stores using Hyvä Themes
  * It generates a v3 token on form submit, validates it server-side via Google’s Enterprise Assessments API, and blocks spam based on expected action, minimum score, and optional hostname matching
  * Includes CMS widgets for quickly adding protected Contact, Newsletter Subscribe, and generic form wrappers—plus admin configuration and a built-in Health Check to verify connectivity and credentials

===== Installation =====

Install and validate in staging before production rollout.

<code bash>
cd /path/to/magento
# Install from your licensed package source
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f
php bin/magento cache:flush
</code>

===== Configuration =====

Configure extension options in Magento Admin, then validate key storefront/admin flows tied to this extension.

===== Validation checklist =====

  * Configuration saves without errors in Admin.
  * Expected storefront/admin behavior is present.
  * No critical PHP/JS errors occur during test flow.
  * Caches and static assets are refreshed after changes.

===== Troubleshooting =====

  * **Feature missing**: verify module status, cache flush, and static-content deploy.
  * **Unexpected behavior**: retest with only required related modules enabled.
  * **Admin setting not applying**: verify config scope and clear cache.

===== Related services =====

  * [[https://toweringmedia.com/hyva-theme-performance|Hyva theme performance services]]
  * [[https://toweringmedia.com/magento-2-development-services|Magento 2 development services]]
  * [[https://toweringmedia.com/magento-maintenance-support|Magento maintenance services]]

===== Related Magento 2 docs =====

  * [[magento2:extensions:start|Magento 2 extension index]]
  * [[start|Global docs home]]