=== Embed Browser Games by Games I Know ===
Contributors: gamesiknow
Tags: embed, browser-games, game-widget, gutenberg-block, shortcode
Requires at least: 6.3
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Embed browser games in WordPress with a Gutenberg block, shortcode, and responsive game widget—no coding required.

== Description ==

**Embed Browser Games by Games I Know** is a WordPress game plugin for adding interactive browser games to posts and pages. Embed games in WordPress using a Gutenberg block, a `[gamesiknow]` shortcode, or the built-in shortcode builder—no custom code needed.

= What is Embed Browser Games by Games I Know? =

Games I Know provides embeddable browser games such as Tic-Tac-Toe, Four-in-a-Row, Bingo, and I Know. This plugin adds a WordPress game widget that loads those games in a responsive iframe on your site.

= Who is this plugin for? =

* Bloggers and publishers who want interactive content
* Community and membership sites adding lightweight games
* Marketers running engagement campaigns with embeddable games
* WordPress users who prefer blocks or shortcodes over manual iframe code

= Key features =

* **Gutenberg block** – Insert a game widget from the block inserter.
* **Shortcode** – Use `[gamesiknow]` in posts, pages, and widgets.
* **Shortcode builder** – Generate copy-ready embed code in wp-admin.
* **Responsive game widget** – Control width, max width, alignment, radius, and shadow.
* **Safe iframe URLs** – Embeds are limited to Games I Know endpoints.
* **Partner ID support** – Connect site embeds to your Games I Know partner account.

= Supported browser games =

* Tic-Tac-Toe (Player vs AI or PvP)
* Four-in-a-Row
* Bingo
* I Know

= How do I embed a game in WordPress? =

1. Install and activate the plugin.
2. Add the **Games I Know Game** block, or paste a `[gamesiknow]` shortcode.
3. Choose a game and layout options.
4. Publish—the game loads on the frontend via a secure iframe from Games I Know.

= External service =

This plugin embeds browser games hosted by Games I Know. When a game is displayed, the visitor's browser loads iframe content from [gamesiknow.com](https://gamesiknow.com/). The iframe URL may include the selected game, Partner ID, `source=wordpress`, theme, mode, and campaign ID. Gameplay data is not stored in WordPress—only plugin settings are saved locally.

* [Privacy policy](https://gamesiknow.com/privacy-policy/)
* [Terms](https://gamesiknow.com/terms/)
* [Setup guide](https://gamesiknow.com/embed/wordpress-game-widget/)
* [Documentation](https://gamesiknow.com/embed/docs/)

= Translations =

All user-facing strings use the `gamesiknow-embed` text domain. Contribute translations on [WordPress.org](https://translate.wordpress.org/projects/wp-plugins/gamesiknow-embed/) to help international users find and use the plugin.

== Installation ==

1. Upload the `gamesiknow-embed` folder to `/wp-content/plugins/`, or upload the plugin ZIP from the WordPress Plugins screen.
2. Activate **Embed Browser Games by Games I Know** from the Plugins screen.
3. Open **Games I Know → Settings**.
4. Click **Get Partner ID** to sign in at Games I Know, then paste your Partner ID (optional but recommended).
5. Add the **Games I Know Game** block to a post or page, or use `[gamesiknow game="tic-tac-toe"]`.

== Frequently Asked Questions ==

= What is the Games I Know WordPress plugin used for? =

It embeds browser games from Games I Know into WordPress pages using a block, shortcode, or admin shortcode builder.

= Do I need a Partner ID? =

No. Games work without one. A Partner ID links embeds on your site to your Games I Know partner account for tracking and setup.

= How do I get a Partner ID? =

Go to **Games I Know → Settings** in wp-admin and click **Get Partner ID**, or visit [gamesiknow.com/partners/login/](https://gamesiknow.com/partners/login/).

= Can I embed games with a shortcode instead of the block? =

Yes. Example: `[gamesiknow game="tic-tac-toe"]`. Optional attributes include `width`, `height`, `theme`, `mode`, and `campaign_id`.

= Which games can I embed? =

`tic-tac-toe`, `four-in-a-row`, `bingo`, and `i-know`.

= Does this plugin store gameplay or visitor data in WordPress? =

No. Only plugin settings are stored in WordPress. Gameplay runs inside a Games I Know iframe.

= Is the plugin compatible with the block editor? =

Yes. It includes a native Gutenberg block plus shortcode support for classic content areas.

= Is this plugin translation-ready? =

Yes. Contribute at the WordPress.org translate project for `gamesiknow-embed`.

== Screenshots ==

1. Games I Know settings with Partner ID setup and frontend embed behavior toggles.
2. Shortcode Builder with embed options, shortcode copy control, and recommended game sizes.
3. Games I Know Game block in the editor.

== Changelog ==

= 1.0.1 =

* Updated plugin listing title to **Embed Browser Games by Games I Know** (slug unchanged: `gamesiknow-embed`).
* Improved readme for search, FAQ clarity, and AI-friendly structured descriptions.
* Optimized directory tags: embed, browser-games, game-widget, gutenberg-block, shortcode.
* Updated WordPress.org banner with real Games I Know Tic-Tac-Toe gameplay artwork.
* Added translation contribution guidance and WordPress compatibility notes.

= 1.0.0 =

* Initial release with Gutenberg block, shortcode, settings, shortcode builder, and uninstall cleanup.

== Upgrade Notice ==

= 1.0.1 =

Listing and documentation updates only. No breaking changes. Existing embeds and settings are preserved.
