=== Tarot and Horoscope ===
Contributors: tarotandhoroscope
Author URI: https://www.tarotandhoroscope.com/
Tags: tarot, horoscope, games, tarot-reader, astrology
Requires at least: 5.0
Tested up to: 6.8
Stable tag: 1.0.4
Requires PHP: 7.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add interactive tarot card games and live chat to your WordPress site for free, powered by TarotandHoroscope.com.

== Description ==
The Tarot and Horoscope plugin brings engaging tarot games, AI chatbots, and horoscopes to your WordPress site, including Monthly Horoscopes, One Card, Daily, and Three Card Tarot games. Easily integrate our API for dynamic tarot games and conversational AI, trained in tarot and horoscope interpretations.

== Key Features ==
- Tarot games with customizable styles: `[tarotxhoroscope_onecard]`, `[tarotxhoroscope_dailytarot]`, `[tarotxhoroscope_threecard]`.
- Monthly Horoscope game with customizable styles (example: `[tarotxhoroscope_monthly_horoscope sign="pisces"]`).
- Optional live chat with the Tarot Bot, configurable for appearance and welcoming message.
- Comprehensive and unique horoscope forecasts, from daily to yearly predictions, exclusive to your site.

== View Demos ==
Explore curated demos at [TarotandHoroscope.com](https://app.tarotandhoroscope.com/demo/) highlighting the functionality and versatility of the games and chat.

== Free vs. Pro ==
- Free Version: Includes all basic games with up to 2 chat replies per session.
- Pro Version: Upgrade your API key at [TarotandHoroscope.com](https://www.tarotandhoroscope.com/join) for more games, more chat replies, and premium features (pro plugin available separately).

== Notes ==
- This plugin connects to external APIs at `api.tarotandhoroscope.com` for game data and chat functionality, please see "External Services" below. A free API key is required from [TarotandHoroscope.com](https://www.tarotandhoroscope.com/join).
- This plugin includes static images (e.g., tarot card graphics) bundled in the /games/images/ directory. These are not intended for the media library as they are core to the plugin’s functionality. All image URLs are sanitized with esc_url() for security.


== External Services ==

This plugin connects to external APIs provided by TarotandHoroscope.com to deliver tarot game data, horoscope content, and live chat functionality. These services are essential for the plugin’s core features, including tarot card games (One Card, Daily Tarot, Three Card), Monthly Horoscope forecasts, and the AI-powered Tarot chat. All data transmissions are secured via HTTPS (or WSS for chat).

### Service Details
- **Service Provider**: TarotandHoroscope.com
- **Purpose**: The APIs provide dynamic tarot card readings, horoscope forecasts, and conversational AI responses for the chat feature. They are used to fetch game data (e.g., card draws, interpretations) and validate the API key, as well as to power the live chat with tarot and horoscope insights.
- **Data Sent**: 
  - The plugin sends the API key and the site’s domain (e.g., `example.com`) to `https://api.tarotandhoroscope.com/validate-api-key/` during API key validation, which occurs when the key is saved in the plugin settings.
  - For tarot games and horoscopes (e.g., endpoints like `https://api.tarotandhoroscope.com/onecardwp/`, `https://api.tarotandhoroscope.com/monthlyhoroscopewp/`, etc.), no user-specific data is sent beyond the API key and game-specific parameters (e.g., zodiac sign for horoscopes or card draw requests). These requests occur when a user loads a page or game with a shortcode like `[tarotxhoroscope_onecard]` or `[tarotxhoroscope_monthly_horoscope]`.
  - For the live chat feature, user-entered chat messages are sent to the API (e.g., https://api.tarotandhoroscope.com/token/ for setup, and WebSocket endpoints like wss://api.tarotandhoroscope.com/ws/onecardchatwpfree/ for real-time interaction) only if the chat functionality is enabled and the user interacts with the Tarot Bot. No personally identifiable information is sent unless explicitly provided by the user in the chat.
- **When Data is Sent**: Data is transmitted when:
  - The API key is validated when saved in settings or when shortcodes/chat are loaded.
  - A tarot game or horoscope shortcode is used on a page or post.
  - A user sends a message via the live chat (if enabled).
- **Links**:
  - Terms of Service: [https://app.tarotandhoroscope.com/terms-of-service/](https://app.tarotandhoroscope.com/terms-of-service/)
  - Privacy Policy: [https://www.tarotandhoroscope.com/privacy-policy/](https://www.tarotandhoroscope.com/privacy-policy/)


== Installation ==
1. Upload the `tarot-and-horoscope` folder to `/wp-content/plugins/` or install via the WordPress Plugin Directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Visit the "Tarot and Horoscope" menu in your admin dashboard.
4. Get a free API key from [TarotandHoroscope.com](https://www.tarotandhoroscope.com/join) and enter it in the "Settings" tab.
5. Customize game and chat settings in the "Games" tab.
6. Add shortcodes (e.g., `[tarotxhoroscope_tonecard]`) to your pages or posts.

== Frequently Asked Questions ==
= Do I need an API key? =
Yes, a free API key from [TarotandHoroscope.com](https://www.tarotandhoroscope.com/join) is required for game and chat functionality.

= Can I customize the games and chat? =
Yes, use the "Games" tab to style games and the chatbox (colors, fonts, borders, etc.).

= What’s the difference between free and pro? =
The free version limits live tarot chats to 2 replies per chat session and includes 4 games. Upgrade your API key for more games, more replies, and additional features.

= Where do I get support? =
Visit [TarotandHoroscope.com/support/](https://www.tarotandhoroscope.com/support/).

= What are the AI Chatbots? =
Our AI Chatbots are trained in tarot and horoscope interpretations, delivering insightful readings and interactive experiences.

= Can the chatbots understand different spreads? =
Yes, they interpret various spreads (e.g., three-card, daily tarot etc.) and adapt to game context.

= Are the readings unique? =
Yes, readings are distinct, tailored to card positions and orientations, ensuring no generic responses.

== Screenshots ==
1. Example of the One Card Tarot game card selection.
2. Example of the One Card Tarot game drawn.
3. Screenshot of a live chat with the AI Tarot Reader
4. Example of the Horoscope game on a page.
5. Game customization options in the admin dashboard.

== Changelog ==
= 1.0.4 =
* Added horoscope responsive css fix.

= 1.0.3 =
* Updated to show multiple horoscope on a single page.

= 1.0.2 =
* Updated and tested for WordPress 6.8 compatibility.
* Updated Horoscope game images for improved visuals.

= 1.0.1 =
* Removed chatbox width option (now redundant).

= 1.0.0 =
* Initial release with Monthly Horoscope, One Card Tarot, Daily Tarot, and Three Card Tarot games, plus chat functionality.

== Upgrade Notice ==
= 1.0.4 =
Added horoscope responsive css fix to monthly horoscopes.
