=== Raptcha ===
Contributors: LaughterOnWater
Tags: captcha, security, privacy, bot-detection, form
Requires at least: 5.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.2.0
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl

A secure, animal-based CAPTCHA for WordPress forms featuring intelligent bot detection and multi-form integrations.

== Description ==

Raptcha is an innovative CAPTCHA alternative that challenges users to count animals in a dynamic image, promoting accessibility and user engagement. Unlike text-based CAPTCHAs, it uses engaging visuals (cats, dogs, birds) with randomized placements and scales for enhanced security.

Key features:

- **Animal Counting Challenges**: Randomized images with 1-10 animals, ensuring varied difficulty.
- **Bot Detection Heuristics**: Advanced checks (drag time, mouse distance, focus duration) to prevent automated submissions.
- **Form Integrations**: Native support for WordPress comments, login forms, and popular plugins (Contact Form 7, Kadence Forms, Ninja Forms).
- **Shortcode Integration**: Easily embed with `[raptcha]` for custom forms.
- **Fully Secured**: Nonce verification, transients for challenge storage, and sanitization throughout.

This plugin prioritizes privacy, security and usability, making it a in-house, private, modern alternative to traditional CAPTCHAs.

== Installation ==

1. Upload the `raptcha` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Embed the CAPTCHA in custom forms using the shortcode: `[raptcha theme="light" size="medium"]`.
4. Enable integrations in your WordPress form builders (no admin settings yet, but checks plugin presence automatically).

== Screenshots ==

1. CAPTCHA challenge showing randomized animals with drag-and-drop number selection
2. Settings page available from the main admin menu
3. Core Form Protection, Plugin Form Protection, Powered-by-Raptcha Toggle
4. Example placement in Contact Form 7
5. The same form placed on a public page
4. In-plugin FAQ for easy reference

== Frequently Asked Questions ==

= Does this work with my form plugin? =

Yes, it integrates with Contact Form 7, Kadence Forms, and Ninja Forms when active. No extra configuration needed.

= How secure is it? =

Raptcha uses nonce verification, bot heuristics, and ephemeral transients. It's not foolproof but provides strong protection against bots.

= Can users customize challenges? =

Advanced options (e.g., animal types, difficulty) aren't exposed yet but can be added via constants in future versions.

= Is it accessible? =

Focused on visual simplicity, with ARIA labels and screen reader support for basic accessibility.

= Troubleshooting: CAPTCHA doesn't load? =

Ensure `raptcha.php` loads correctly and check console for JS errors. Assets must be in the correct directory.

= Can I disable the "Powered by Raptcha" link? =

Yes. The link is optional and can be disabled at any time in the Raptcha settings. Raptcha is free, private, and operates without third-party services. Leaving the link visible helps support ongoing development and allows others to discover a privacy-focused alternative to paid CAPTCHA solutions.

= Why is it called Raptcha? =

Raptcha is a play on CAPTCHA and rapture. Bots arrive, face a brief evaluation, and are peacefully ascended to bot heaven before they can make their move.

== Changelog ==

= 1.2.0 =

- Added: Optional "Powered by Raptcha" attribution footer with admin toggle
- Redesigned: Admin settings page with card-based layout and modern pill toggles
- Enhanced: Save button with visual feedback (spinner during save, success notification)
- Added: Two new FAQ items about attribution and plugin naming
- Improved: Settings default handling for better upgrade experience

= 1.0.0 =

- Initial release: Animal-based CAPTCHA with core integrations, bot detection, and WordPress form support.

== Upgrade Notice ==

= 1.0.0 =
Update to enable modern, secure CAPTCHA features. No breaking changes—safe to upgrade.