=== GroanDeck Dad Jokes ===
Contributors: groandeck
Tags: dad jokes, jokes, humor, widget, puns
Requires at least: 6.3
Tested up to: 7.0
Stable tag: 1.0.1
Requires PHP: 7.4
License: MIT
License URI: https://opensource.org/licenses/MIT

Embed a dad joke widget on any page or post. Fresh joke on every page load with a "Next joke" button.

== Description ==

Add a dad joke widget to your WordPress site in seconds. The widget displays a random joke from GroanDeck's collection of 2,000+ clean, family-friendly dad jokes.

**Features:**

* Fresh joke on every page load
* "Next joke" button for endless entertainment
* Light and dark themes
* Filter by category (animals, food, science, work, and more)
* Gutenberg block + classic shortcode
* Lightweight — under 4 KB
* No API key required

**Usage:**

Use the Gutenberg block (search for "GroanDeck") or the shortcode:

`[groandeck]`

With options:

`[groandeck theme="dark" category="animals"]`

**Categories available:**

animals, back-to-school, books, cars, christmas, clothing, coffee, construction, easter, family, food, gardening, halloween, history, love, math, medical, money, music, nature, ocean, one-liners, puns, school, science, space, sports, technology, thanksgiving, travel, valentines, work.

== Installation ==

1. Upload the `groandeck-dad-jokes` folder to `/wp-content/plugins/`
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Add the block or shortcode to any page or post

== Frequently Asked Questions ==

= Do I need an API key? =

No. The widget works out of the box with no configuration.

= Can I customize the appearance? =

Yes. Use `theme="dark"` for dark mode. The widget automatically adapts to a max-width of 400px.

= How often do jokes change? =

A new joke loads on every page view. Visitors can also click "Next joke" to see more.

= Is this free? =

Yes, completely free. No premium version, no limits.

== Screenshots ==

1. Light theme widget
2. Dark theme widget
3. Gutenberg block settings

== External services ==

This plugin relies on the GroanDeck service (https://groandeck.com) to display dad jokes.

= What the service does =

GroanDeck provides a free API and embeddable widget that serves random dad jokes.

= How the plugin uses it =

* On every page load where the widget is placed, the plugin loads a JavaScript file from `https://groandeck.com/widget.js`.
* That script fetches a random joke from the GroanDeck API (`https://groandeck.com/api/v1/random`).
* When a visitor clicks "Next joke", the script fetches another joke from the same API.

= What data is sent =

Standard HTTP request data (IP address, user agent, referrer) is sent with each API call. No personal data, cookies, or tracking identifiers are transmitted.

= Links =

* Service: [https://groandeck.com](https://groandeck.com)
* Terms of Service: [https://groandeck.com/terms](https://groandeck.com/terms)
* Privacy Policy: [https://groandeck.com/privacy](https://groandeck.com/privacy)

== Changelog ==

= 1.0.1 =
* Block now uses Block API version 3 for compatibility with the iframed editor in WordPress 7.0.
* Tested up to WordPress 7.0.
* Raised minimum requirements to WordPress 6.3 and PHP 7.4.

= 1.0.0 =
* Initial release
* Gutenberg block support
* Shortcode support
* Light/dark themes
* Category filtering

== Upgrade Notice ==

= 1.0.1 =
WordPress 7.0 compatibility (Block API v3). Now requires WordPress 6.3+ and PHP 7.4+.

= 1.0.0 =
Initial release.
