=== Daily Puzzles for Analong ===
Contributors: analong
Stable tag: 1.1.0
Tags: games, puzzles, anagram, daily puzzle, logic games, takuzu, binairo
Requires at least: 5.0
Tested up to: 6.9
License: GPLv2 or later

Boost reader engagement and increase dwell time with free embeddable puzzles. 
No heavy scripts, just a lightweight, privacy-friendly logic game shortcode.

== Description ==
Looking for a free puzzle widget to keep your visitors entertained? **Daily Puzzles for Analong** allows you to embed clean, interactive logic games directly into your WordPress posts or pages. Perfect as a daily crossword alternative, it offers popular mind games like Anagrams, Takuzu (Binary puzzles), Kyudoku (Ninefind), and Shikaku without slowing down your website.

Our widgets are designed to be entirely privacy-friendly, ultra-light, and fully responsive.

== Privacy Notice == 
This plugin relies on an external service to function. It embeds interactive puzzle widgets from **analong.com** via an iframe.

* **Service used:** analong.com
* **Content loaded:** Daily puzzle widgets (Anagram, Takuzu, Kyudoku, Shikaku) via iframe.
* **Data transmitted:** When a user visits a page with the shortcode, their browser connects to analong.com, transmitting their IP address and user-agent.
* **Cookies:** Our widgets may use functional cookies to store game progress and daily scores. These are not used for tracking or advertising purposes.
* **When connection happens:** The connection to the external service only occurs when the shortcode is rendered on a post or page.
* **Privacy Policy:** You can find our privacy policy here: https://www.analong.com/privacy-policy/

== Installation ==
1. Upload the plugin folder to the '/wp-content/plugins/' directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Use the shortcode '[analong_puzzle game="anagram" lang="en"]' in any post or page.

== Shortcode Parameters ==
You can easily customize the puzzle widget by adding parameters to the shortcode to adjust the game type, language, or dimensions.

= Supported Parameters =
* **game** : Choose the puzzle type. Supported values are `anagram', 'takuzu' (Binairo), 'kyudoku' (Ninefind), and 'shikaku'. (Default: 'anagram')
* **lang** : Choose the language of the game interface. Supported values are 'en' (English), 'fr' (Français), 'es' (Español), and 'de' (Deutsch). (Default: 'en')
* **width** : Define the width of the widget iframe (e.g., '100%', '500px'). (Default: '100%')
* **height** : Define the height of the widget iframe (e.g., '650px', '700px'). Minimum forced height is '400px' to maintain grid readability. (Default: '650px')

= Best Display Practices =
For an optimal gaming experience—especially for grid-based games like Takuzu, Kyudoku, and Shikaku—we highly recommend embedding the shortcode in **full-width pages** or **main content areas** rather than narrow sidebars. This ensures the game interface remains perfectly readable and fully interactive for your players.

= Usage Examples =
* Display a French Takuzu puzzle: '[analong_puzzle game="takuzu" lang="fr"]'
* Display a German Kyudoku puzzle in a custom height: '[analong_puzzle game="kyudoku" lang="de" height="700px"]'
* Display a Spanish Anagram game: '[analong_puzzle game="anagram" lang="es" width="100%"]'

== Screenshots ==
1. This is the Kyudoku (Ninefind) puzzle widget layout.
2. This is the Takuzu (Binairo) puzzle widget grid (French version).
3. This is the Anagram puzzle widget interface.