=== Slodds Random Facts ===
Contributors: slodds
Tags: random facts, facts, trivia, fun facts, widget
Requires at least: 5.8
Tested up to: 6.9
Stable tag: 1.0.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Display random facts on any page. 1,000 curated facts across 14 categories. No API calls, no tracking.

== Description ==

**Shortcode:** `[slodds_random_facts]` — paste it into any page or post to display a random fact widget.

Slodds Random Facts adds a clean, interactive random fact widget to your WordPress site. Show your visitors interesting facts about science, space, animals, history, food, and more. Perfect for blogs, educational sites, and anyone who wants to add a fun element to their pages.

= Features =

* 1,000 curated, high-quality facts across 14 categories
* Filter by category: Animals, Space, Science, History, Food, and more
* Kid-friendly mode — show only facts suitable for all ages
* Light and dark theme support
* "Next Fact" button with smooth transitions
* Mobile responsive design
* No external API calls — works entirely offline
* No tracking, no cookies, no data collection
* Lightweight — no external dependencies

= Categories =

Animals, Culture, Food, General, Geography, History, Human Body, Language, Nature, Ocean, Psychology, Science, Space, Technology

= Shortcode Options =

`[slodds_random_facts]` — basic usage

`[slodds_random_facts category="Space" kid_friendly="true" theme="dark"]`

* `category` — filter to a specific category. Default: all
* `kid_friendly` — true or false. Default: false (shows all facts)
* `theme` — light or dark. Default: light
* `show_category` — show category label. Default: true

== Installation ==

1. Upload the `slodds-random-facts` folder to `/wp-content/plugins/`
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Add `[slodds_random_facts]` to any page or post
4. Optionally configure settings under Settings > Slodds Random Facts

== Frequently Asked Questions ==

= Does this plugin make external requests? =

No. All facts are included in the plugin. No external API calls, no tracking, no cookies.

= How many facts are included? =

1,000 curated facts across 14 categories.

= Can I filter by category? =

Yes. Use the `category` attribute, e.g., `[slodds_random_facts category="Space"]`.

= Is there a kid-friendly mode? =

Yes. Use `kid_friendly="true"` to show only facts suitable for all ages.

= Where do the facts come from? =

Facts are curated by the team at [FactFacts.com](https://factfacts.com), which maintains a database of over 11,000 facts.

== Screenshots ==

1. Random fact widget on a page
2. Dark theme
3. Settings page

== Changelog ==

= 1.0.0 =
* Initial release
* 1,000 curated facts across 14 categories
* Category filter
* Kid-friendly mode
* Light and dark theme support
* Optional credit link (off by default)
