GroanDeck Dad Jokes

الوصف

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

المكوّنات

تقدّم هذه الإضافة مكوّن واحد (1).

  • GroanDeck Dad Jokes

التنصيب

  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

الأسئلة المتكررّة

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.

المراجعات

لا توجد مراجعات لهذه الإضافة.

المساهمون والمطوّرون

“GroanDeck Dad Jokes” هو برنامج مفتوح المصدر. وقد ساهم هؤلاء الأشخاص بالأسفل في هذه الإضافة.

المساهمون

ترجمة ”GroanDeck Dad Jokes“ إلى لغتك.

مُهتم بالتطوير؟

تصفّح الشفرة، تحقق من مستودع SVN، أو الاشتراك في سجل التطوير بواسطة RSS.

سجل التغييرات

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