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.
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
- Terms of Service: https://groandeck.com/terms
- Privacy Policy: https://groandeck.com/privacy
Blocks
This plugin provides 1 block.
- GroanDeck Dad Jokes
Installation
- Upload the
groandeck-dad-jokesfolder to/wp-content/plugins/ - Activate the plugin through the ‘Plugins’ menu in WordPress
- Add the block or shortcode to any page or post
FAQ
-
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.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“GroanDeck Dad Jokes” is open source software. The following people have contributed to this plugin.
Contributors
Translate “GroanDeck Dad Jokes” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- Initial release
- Gutenberg block support
- Shortcode support
- Light/dark themes
- Category filtering