=== Rayzee Pet Counter ===
Contributors: jinghuaai3
Donate link: https://rzplugin.cn/
Tags: pet, visitor, counter, analytics, capybara
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A cute web pet that walks across your site, interacts with visitors, and counts unique visitors by anonymized IP.

== Description ==

Rayzee Pet Counter adds an adorable animated pet (capybara, chihuahua, cheese cat, labubu, or penguin) that walks across your website. The pet responds to visitor interactions: hover to make it stop and face the viewer, click to send a heart and show visitor count, double-click for an angry reaction, and hold-click for a fear/struggle escape animation.

**Features:**
- 5 cute pet characters to choose from
- Two movement modes: bottom of page or random full-page
- Realistic walking animation with leg movement
- Interactive reactions: hover, click, double-click, press-and-hold
- Anonymized IP-based visitor counting
- GDPR-friendly: IP addresses are hashed, never stored in plain text
- Lightweight and performance-optimized
- Fully translatable

== Installation ==

1. Upload the `rayzee-pet-counter` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Go to Settings > Rayzee Pet to configure your pet and movement mode.
4. Visit your website to see the pet in action!

== Frequently Asked Questions ==

= Does this plugin collect personal data? =

No. Visitor IP addresses are hashed using one-way encryption before storage, making it impossible to identify individual visitors while still providing an accurate visitor count.

= Can I add my own pet characters? =

Yes. Add new SVG files to the `assets/svgs/` directory and update the pet list in the plugin settings. Make sure your SVG files use the same leg group IDs (`leftfront`, `rightfront`, `leftback`, `rightback`) for walking animations.

= Is this plugin compatible with caching plugins? =

Yes. The pet is rendered via JavaScript and does not rely on page cache. Visitor counting uses AJAX, which works with most caching solutions.

== Screenshots ==

1. Capybara pet walking on the bottom of a webpage
2. Admin settings page showing pet selection and movement mode
3. Heart animation and visitor count display on click

== Changelog ==

= 1.0.2 =
* Initial release
* Capybara pet with full walking animation
* Visitor counting with anonymized IP
* All interactive reactions (hover, click, double-click, hold)
* Two movement modes
* Quadruped and biped animation support

== Privacy Notice ==

This plugin stores anonymized visitor IP hashes for counting unique visitors. No personal information (names, emails, or plain-text IP addresses) is collected. Stored data can be exported or erased via the WordPress Personal Data tools under Tools > Export Personal Data and Tools > Erase Personal Data.