=== Solitaire Games: Klondike, FreeCell, Spider and Mahjong ===
Contributors: ssmallya
Tags: solitaire, klondike, freecell, mahjong, card games
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add playable solitaire and puzzle games to any post or page: Klondike, FreeCell, Spider, Mahjong Solitaire and 18 more.

== Description ==

Add a playable game to any post or page in one step. Games run in a sandboxed iframe served by trysolitaire.com, so there is nothing to install or maintain. Your readers need no account and no sign-up, and a game keeps working offline once it has loaded.

**22 games:** Klondike, Spider (1/2/4 suits), FreeCell, Mahjong Solitaire, Pyramid, TriPeaks, 2048, Golf, Yukon, Russian, Forty Thieves, Double Klondike, Australian Patience, Canfield, Easthaven, Eight Off, Baker's Game, Baker's Dozen, Spiderette, Scorpion, Wasp, Beleaguered Castle.

**Two ways to embed:**

1. The **TrySolitaire Game** block. Pick the game, theme, card style and language in the editor, and see a live preview.
2. The `[trysolitaire]` shortcode:

`[trysolitaire game="spider" suits="2" theme="navy" lang="en"]`

Attributes: `game`, `theme` (dark-green, dark, navy, midnight, teal, light), `cards` (card face style), `lang` (en, es, fr, de, nl, hi), `draw` (1 or 3, Klondike-family), `suits` (1, 2 or 4, Spider-family), `timer`, `moves`, `hints`, `fullscreen` (true/false), `sound` (on/off), `credit` (yes/no).

The embed is responsive and adapts its aspect ratio to phones and tablets. A small attribution line links to the game's page on trysolitaire.com.

Mahjong Solitaire opens on the Turtle layout.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/`, or install it from the Plugins screen.
2. Activate it.
3. Add the "TrySolitaire Game" block to a post, or use the `[trysolitaire]` shortcode.

== Frequently Asked Questions ==

= Do my readers need an account? =

No. Games start instantly, with no sign-up and no download.

= Does the embed slow my page down? =

The iframe is lazy-loaded, so nothing is fetched until it approaches the viewport.

= Can I remove the attribution link? =

Yes. Set `credit="no"` on the shortcode, or switch the credit off in the block settings.

The single credit line below the game is how the free service is sustained, so we would rather you kept it. But it is your page, and a credit you cannot decline is not a credit.

== Changelog ==

= 1.2.0 =
* Added Mahjong Solitaire, which opens on the Turtle layout.
* Renamed the plugin so the listing says what it embeds.

= 1.1.0 =
* Added `credit="yes|no"` so the attribution link is optional.
* Widened the attribution wording from two phrasings to ten, varying by game and by host site.

= 1.0.0 =
* Initial release: 21 games, Gutenberg block + shortcode, responsive sizing, theme/card-style/language options.
