GroanDeck Dad Jokes

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

Blocks

This plugin provides 1 block.

  • GroanDeck Dad Jokes

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

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” adalah perisian sumber terbuka. Orang-orang berikut telah menyumbang kepada pemalam ini.

Penyumbang

Changelog

1.0.0

  • Initial release
  • Gutenberg block support
  • Shortcode support
  • Light/dark themes
  • Category filtering