Playful Sparkle - Google reCAPTCHA for OpenCart 4

The Playful Sparkle - Google reCAPTCHA extension for OpenCart 4.x+ enhances the security of your online store by integrating Google’s advanced reCAPTCHA service. Safeguard your store from spam and automated abuse while providing a frictionless experience for legitimate users. This extension supports flexible implementation options, including reCAPTCHA v3 (background validation), v2 (checkbox), and v2 Invisible. With multi-language support and fully customizable settings, such as badge position, theme, and size, the extension ensures a seamless fit for your store's design and functionality. It also complies with Google’s guidelines, including the ability to hide the badge when the required branding is visibly included in the user flow.

---

Features

• Comprehensive reCAPTCHA Options:
  • Support for reCAPTCHA v3 (score-based): Validate user actions in the background without user intervention.
  • Support for reCAPTCHA v2 (checkbox): Displays the "I'm not a robot" checkbox challenge.
  • Support for reCAPTCHA v2 Invisible: Validates actions in the background with minimal user interruption.
• Customizable Display Settings:
  • For v3:
    • Badge position: Choose between bottom left, bottom right, or inline.
    • Theme: Select between light and dark.
    • Option to hide the badge with a footer notice to comply with Google policy.
    • Set different score thresholds for specific pages, such as Admin Login, Forgotten Password; Client Login, Forgotten Password, Register, Guest Checkout, Reviews, Comment, Returns, and Contact.
  • For v2 Checkbox:
    • Badge theme: Choose between light and dark.
    • Badge size: Select normal or compact.
  • For v2 Invisible:
    • Badge position: Choose between bottom left, bottom right, or inline.
    • Theme: Select between light and dark.
    • Option to hide the badge with a footer notice to comply with Google policy.
• Advanced Features:
  • Logs any reCAPTCHA verification failures for debugging and monitoring purposes.
  • Toggle option to include the client's IP address when sending verification requests to Google's reCAPTCHA service.
• Compatibility: Integrates smoothly with OpenCart 4.x+, supporting a range of online store setups.
• Multilingual Support: Ready for international use with languages including العربية (ar), فارسی (fa-ir), Български (bg), 中文(简体) (zh-cn), 中文(繁體) (zh-tw), Čeština (cs-cz), English (UK) (en-gb), English (US) (en-us), Français (fr-fr), Deutsch (de-de), Ελληνικά (el-gr), Magyar (hu-hu), Italiano (it-it), 日本語 (ja), 한국어 (ko-kr), Polski (pl-pl), Português (Brasil) (pt-br), Русский (ru-ru), Slovenčina (sk-sk), Español (es-es), and Türkçe (tr-tr).

---

Installation Instructions

1. Download the latest version from this repository.
2. Log in to your OpenCart admin panel.
3. Navigate to Extensions > Installer.
4. Click the Upload button and upload the ps_google_recaptcha.ocmod.zip file.
5. Locate the extension in the Installed Extensions list and click the Install button.
6. Navigate to Extensions > Extensions and select Modules from the Choose the extension type dropdown list.
7. Locate the extension in the Modules list and click the Install button.
8. Click the Edit button, configure the extension parameters, and click the Save button to save your settings.

---

Support & Inquiries

For assistance or inquiries related to this extension, please open an issue on this repository, visit our support website, or contact us via email at support@playfulsparkle.com.

---

License

This project is distributed under the GPL-3.0 license. Please refer to the LICENSE file for further details.

---

Contributing

We encourage contributions from the community. To contribute, please fork the repository and submit a pull request with your proposed changes.