=== RavyCode Typing Speed Test ===
Contributors: rvaishnav32, ravycode
Tags: typing test, typing speed, wpm, cpm, keyboard practice
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add a fast, lightweight typing test to your WordPress site with real-time WPM, CPM, accuracy tracking, and a modern share popup.

== Description ==

RavyCode Typing Speed Test helps students and visitors practice typing directly on your website.

Key features:

* Real-time WPM, CPM, accuracy, and mistakes tracking
* Smooth single-line typing flow with live highlighting
* Restart and multi-duration support
* Share-ready result popup with WhatsApp, Telegram, Facebook, X, LinkedIn, Email, Copy Link, and native share
* Gutenberg block support and shortcode support
* Lightweight frontend with no third-party JS dependencies

Free version note:

* The free version uses a built-in rotating text bank.
* Custom text bank management is planned for a Pro version.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/` or install via the WordPress plugin uploader.
2. Activate **RavyCode Typing Speed Test** from the **Plugins** screen.
3. Go to **Settings > RavyCode Typing Speed Test** and configure heading, tagline, durations, and accent color.
4. Add the typing test to any page or post using shortcode or block.

== Usage ==

Basic shortcode:

`[ravycode_typing_speed_test]`

Advanced shortcode:

`[ravycode_typing_speed_test duration="60" show_title="true"]`

Advanced shortcode parameters:

* `duration` (integer): force a specific test duration in seconds for that page/post.
* `show_title` (`true` or `false`): show or hide heading/tagline for that instance.

== Coming Soon in Pro ==

* Leaderboard
* Add custom paragraphs
* Pre-built themes
* Gutenberg Block enhancements
* Multi-language support
* Advanced stats
* Typing sound effects
* Admin dashboard stats
* Smart Difficulty Adjustment
* Elementor / Page Builder Widget

== Screenshots ==

1. Plugin settings page where heading, tagline, durations, and colors are configured.
2. Desktop typing test before start.
3. Desktop typing test in progress with live highlight and stats.
4. Final result popup with share actions.

== Frequently Asked Questions ==

= Does this plugin work with Gutenberg? =

Yes. A dynamic block is included.

= Can I use shortcode in Classic Editor? =

Yes. Both Classic and Block editor are supported.

= How is WPM calculated? =

WPM is calculated from correct characters only:  
`WPM = (correct_characters / 5) / elapsed_minutes`

= Can users paste text to cheat? =

Paste is blocked in the typing input to keep results fair.

= Can I set custom text passages in free version? =

Not yet. Free version uses a curated rotating text bank.