Home

AI Fun Questions

A small WordPress plugin that asks an AI for one fresh technology riddle, on demand, and reveals the punchline only after the visitor has had a go at answering.

There is no joke database. Every question is generated when someone asks for it, held on the server for ten minutes, and then discarded. The tenth visit is as fresh as the first.

Start here

If you are setting the plugin up for the first time, these four pages are the whole path from download to a working widget:

1. What AI Fun Questions Does — what it is, and the one design decision that explains the rest
2. Installing the Plugin — upload, activate, and what activation changes
3. The Settings Screen — every field, what it does, and what the status labels mean
4. Adding the Widget to Your Site — the shortcode, and where it works

Choosing a provider

The plugin does not include an AI. You point it at one, and you pay for — or self-host — whatever you point it at. Three are supported:

• Set up Ollama — nothing leaves your network. Runs on your own hardware, no API key, no per-question cost.
• Set up an OpenAI-compatible Provider — the least setup, and you pay per request. Works with any endpoint speaking the OpenAI chat-completions API.
• Set up Hugging Face — hosted inference with a Hugging Face token.

Running it in production

• Keeping API Keys Out of the Database — the two wp-config.php constants, and why
• Rate Limits Explained — the two generation limits and how to change them
• Running Behind Cloudflare or a CDN — read this before going live behind a proxy
• What It Costs to Run — one API call per page view, and how to keep the bill down

When something is wrong

• Error Messages Reference — every message, its cause, and the fix
• Please Wait Before Requesting Another Question — three quite different causes
• Could Not Generate a Question — how to find the real error behind the fallback

Privacy and security

• What the Plugin Stores — and what it never stores
• How the Punchline Stays Hidden — why the answer is not in the page source

Extending it

• Filters Reference — the three filters and two constants
• Adding a Custom AI Provider — the interface and where to register it

Quick reference

• Shortcode: [ai_fun_question] — takes no attributes
• Settings: Settings › AI Fun Questions
• Requires: WordPress 6.4+, PHP 7.4+
• Licence: GPL-2.0-or-later

What this wiki covers

These pages are for the person installing and running the plugin. Developer-facing material — the provider interface, the REST contract, the security model in detail — lives in the docs/ folder of the repository.