=== EV Crosswords ===
Contributors: entreveloper, Migue17, freemius
Tags: crosswords, word search, engagement, wordpress, word games
Requires at least: 6.7
Tested up to: 7.0
Requires PHP: 8.1
Stable tag: 2.0.9
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Give readers a reason to come back tomorrow: AI-assisted crosswords and word search puzzles for your WordPress site, with built-in engagement tracking.

== Description ==

Daily puzzles are one of the clearest reader-retention plays in publishing right now — but until now, that's mostly been available to newsrooms large enough to build or license it themselves. EV Crosswords brings the same mechanic to any WordPress site: self-serve, no enterprise contract, no sales call.

**Generate word lists in seconds, from a prompt or from your own articles**
The admin interface uses AI to generate lists of words and hints for your puzzles — either from a manual prompt, or straight from the content of one of your existing posts. This is the fastest way to turn an article you've already written into a puzzle readers can play.

**Or skip AI entirely**
Every AI feature is optional. Build a crossword manually by typing your word list or adding words one by one. Word search puzzles auto-generate from your word list (configurable grid size, optional diagonal/reversed words) and can be regenerated as many times as you like before saving.

**Native to the block editor**
Puzzles embed as real Gutenberg blocks — no shortcodes, no iframes.

**See what readers actually finish**
Built-in plays and completions tracking, right inside wp-admin, so you can see which puzzles are working without a separate analytics tool.

**Bring your own AI provider**
Works with OpenAI, Anthropic, Gemini, or a self-hosted Ollama instance — your key, your data, your choice.

= Free vs. Pro =

EV Crosswords is free and fully functional today — unlimited puzzles, AI or manual word list creation, native blocks, and usage tracking, all included, no account required.

A Pro tier is in development for publishers who want to run daily puzzles as a serious retention strategy: scheduled/automated puzzle publishing, reader streaks and leaderboards, deeper retention analytics, and multi-site licensing for agencies. Pro isn't available for purchase yet — see https://entreveloper.com/pricing/ for the current status.

== Installation ==

Installation and use of this plugin is straightforward:

1. Install and activate the EntGenAI companion plugin first. Configure your preferred AI Provider (LLM) in the plugin admin interface.
2. Download and copy EV Crosswords to your Plugins directory.
3. Activate EV Crosswords through the 'Plugins' menu in WordPress.
4. Navigate to Dashboard → Crosswords Settings → Config to configure your AI provider and Entreveloper key (both optional).
5. Navigate to Dashboard → Crosswords Settings → Generate to create a word list (manually, via AI, or generated from one of your existing articles) and then generate a crossword or word search from it.
6. Save the puzzle and add it to any page as a block using the WordPress Block Editor (search for "Ev Crossword Viewer" or "Ev Word Search Viewer").

Read more here: https://entreveloper.com/add-crosswords-to-your-wordpress-website/

== Development ==

Development happens in Github:
[EV-Crosswords](https://github.com/TheEntreveloper/ev-crosswords "GitHub Repository")

== Frequently Asked Questions ==

= What does this plugin do? =

It makes it easy to add crosswords and word search puzzles to pages on your WordPress website, with or without AI help.

= What doesn't this plugin do? =

It does not directly create puzzles from a simple prompt. Instead, it gives you an easy way to use AI tools to create lists of words and hints (including generating them straight from an existing article), which are then used to generate a crossword or word search grid.

= Does this plugin require anything else? =

Yes. It requires the EntGenAI companion plugin to be installed and active. AI generation features also require an API key from a supported provider (OpenAI, Anthropic, Gemini, or a local Ollama installation).

= Does this plugin modify any core WordPress, plugin or theme files? =

No, it does not.

= How do I add a puzzle to a page or post? =

Puzzles are added as real Gutenberg blocks, not a shortcode. Add the "Ev Crossword Viewer" or "Ev Word Search Viewer" block from the block inserter in any page or post, then use its sidebar panel to pick any puzzle you've already generated. The puzzle is stored in the block itself, so the page doesn't depend on anything else to display it.

= Can I use the same puzzle on more than one page? =

Yes. Every puzzle you generate is saved on its own, independently of any page. Add the viewer block to as many pages as you like and pick the same puzzle each time.

= Pro's daily automation appended a puzzle to one of my articles — can I remove it from there but keep using it elsewhere? =

Yes. Deleting the auto-appended puzzle section from an article only removes it from that article; the underlying crossword and word search aren't deleted. Add them to any other page the same way you would any generated puzzle - via the viewer block's picker, or by cutting the block and pasting it elsewhere. You keep full control over where, or whether, each puzzle appears.

= Is there a paid version? =

Yes — EV Crosswords Pro is available now, with scheduled/automated puzzle publishing, reader streaks and leaderboards, deeper retention analytics, and multi-site licensing for agencies. See https://entreveloper.com/pricing/ for current plans and pricing.

== Screenshots ==

1. Example of Crossword created with the plugin, and displayed in the frontend of a Wordpress based website.

2. Example of Crossword added to a new Wordpress page, in the admin interface.


