README

A tiny Composer metapackage (no code, no files installed) whose only job is to remove Magento's native Google reCAPTCHA modules from your project so they can be superseded by hryvinskyi/magento2-invisible-captcha.

It declares a replace for every magento/module-re-captcha-* package. When it is installed, Composer treats those modules as already provided and does not install them — which cleanly disables the built-in reCAPTCHA (form validators, UI, WebAPI and GraphQL handlers) without touching the rest of magento/security-package (Two-Factor Auth and security.txt are left intact).

Why a separate package?

hryvinskyi/magento2-invisible-captcha deliberately does not replace core modules — installing it should never silently rip out another extension's captcha. This opt-in metapackage lets a merchant make that switch explicitly.

Install

composer require hryvinskyi/magento2-invisible-captcha hryvinskyi/magento2-invisible-captcha-recaptcha-replace
composer update --lock          # re-resolves without the native reCAPTCHA modules
bin/magento setup:upgrade

Then import your existing reCAPTCHA keys and per-form settings:

bin/magento hryvinskyi:invisible-captcha:migrate-recaptcha --dry-run   # preview
bin/magento hryvinskyi:invisible-captcha:migrate-recaptcha             # apply

Run the migration before removing the native modules if you want the command to read the old recaptcha_frontend/* and recaptcha_backend/* values — those config rows survive module removal, but reading them first avoids any doubt.

Uninstall / revert

Remove this package (composer remove hryvinskyi/magento2-invisible-captcha-recaptcha-replace) and run composer update to let Composer reinstall the native reCAPTCHA modules.

Replaced packages

re-captcha-admin-ui, re-captcha-checkout, re-captcha-checkout-sales-rule, re-captcha-contact, re-captcha-customer, re-captcha-frontend-ui, re-captcha-migration, re-captcha-newsletter, re-captcha-paypal, re-captcha-resend-confirmation-email, re-captcha-review, re-captcha-send-friend, re-captcha-store-pickup, re-captcha-ui, re-captcha-user, re-captcha-validation, re-captcha-validation-api, re-captcha-version-2-checkbox, re-captcha-version-2-invisible, re-captcha-version-3-invisible, re-captcha-webapi-api, re-captcha-webapi-graph-ql, re-captcha-webapi-rest, re-captcha-webapi-ui, re-captcha-wishlist (all under the magento/module- prefix).

License

MIT