=== Kung Woo Easy Encyclopedia ===
Contributors: kungwoopanda
Tags: encyclopedia, dictionary, glossary, terms, vocabulary
Requires at least: 5.8
Tested up to: 7.0
Stable tag: 1.2.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A lightweight, fast, and easy-to-use plugin to create an alphabetical encyclopedia, dictionary, or glossary on your WordPress site.

== Description ==

Kung Woo Easy Encyclopedia is a powerful yet lightweight tool designed to help you build a fully functional glossary, dictionary, or encyclopedia directly on your WordPress site. 

Simply use the `[kwee_encyclopedia]` shortcode to display a beautifully styled, alphabetical grid of your terms.

### Key Features:
* **Alphabetical Sorting:** Automatically groups and sorts your terms by their first letter.
* **Live Search:** Instant, JavaScript-based filtering allowing users to find terms without page reloads.
* **Smart Tooltips:** Hover over a term to see a quick preview. Customize the text manually or let the plugin automatically extract an excerpt.
* **Related Terms:** Easily link concepts together using a built-in meta box.
* **Custom Settings Panel:** Tailor the plugin to your needs. Customize the primary color, change the base URL slug, and control tooltip behavior directly from the WordPress dashboard.
* **Developer & SEO Friendly:** Fully compliant with strict WordPress Coding Standards (WPCS). Clean URL structures and accessible HTML.

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/kung-woo-easy-encyclopedia` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Navigate to `Encyclopedia -> Settings` to configure your primary color, URL slug, and tooltips.
4. **Important:** If you change the Custom URL Slug in settings, you must navigate to `Settings -> Permalinks` and click "Save Changes" to flush the rewrite rules.
5. Create a new page and use the `[kwee_encyclopedia]` shortcode to display your glossary.

== Frequently Asked Questions ==

= How do I display the encyclopedia? =
Simply create a new page and paste the `[kwee_encyclopedia]` shortcode into the content.

= How can I change the URL from /encyclopedia/ to something else? =
Go to `Encyclopedia -> Settings` in your WordPress dashboard, enter your preferred Custom URL Slug (e.g., `dictionary` or `glossary`), save the settings, and then immediately go to `Settings -> Permalinks` and click "Save Changes".

= How do tooltips work? =
When adding or editing a term, you can enter custom text in the "Tooltip Text" meta box. If left empty, the plugin will automatically pull a specified number of words from the main content. You can adjust this word count or disable tooltips entirely in the settings panel.

== Screenshots ==

1. The alphabetical encyclopedia grid with instant live search.
2. The custom settings panel in the WordPress dashboard.
3. Related terms and alphabetical navigation displayed on a single term page.

== Changelog ==

= 1.2.0 =
* Added: Comprehensive Settings Panel (`Encyclopedia -> Settings`).
* Added: Ability to change the Custom URL Slug directly from the dashboard.
* Added: Option to enable or disable tooltips globally.
* Added: Option to customize the automatic tooltip word count extraction.
* Fixed: Complete security overhaul complying with strict WordPress Coding Standards (WPCS). All inputs are now strictly sanitized and all outputs are safely escaped.

= 1.1.0 =
* Added: Instant JavaScript-based Live Search for terms.
* Added: Hover Tooltips for quick term previews on the main encyclopedia page.
* Added: Custom meta box for defining specific Tooltip text.

= 1.0.0 =
* Initial release. Custom Post Type registration, related terms logic, and `[kwee_encyclopedia]` shortcode.