=== Circle Tag Cloud ===
Contributors: edelhearts
Tags: tag cloud, tags, taxonomy, circle, design
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Displays taxonomy terms in a beautiful, highly packed circle (or rectangle) layout with customizable color palettes and motion effects.

== Description ==

Circle Tag Cloud is a lightweight and customizable plugin that displays your tags (or any taxonomy) in a visually striking, packed layout. Unlike traditional tag clouds, it uses a smart JavaScript packing algorithm to arrange terms tightly within a circle or rectangle without overlapping.

It is designed with performance and accessibility in mind, featuring a built-in caching system (Transient API) and keyboard navigation support.

**Key Features:**

* **Smart Packing:** Automatically arranges tags in a dense Circle or Rectangle shape.
* **Color Palettes:** Choose from preset palettes (Warm, Cool, Vivid, Monochrome, Metallic Mix) or define your own **Custom Colors**.
* **Smart Contrast:** Automatically adjusts text color (black or white) based on the background color for optimal readability.
* **Text Outline:** Adds a "Glow" effect outline to text for better visibility on any color.
* **Motion Effect:** Optional subtle floating animation (respects "prefers-reduced-motion" settings).
* **High Performance:** Uses Transient API caching to minimize database queries.
* **Accessibility Ready:** Full keyboard navigation support with tooltips that appear on focus.
* **Easy Configuration:** Manage everything from a dedicated settings page or override via shortcode attributes.

**Usage:**

Simply add the shortcode `[circle_tag_cloud]` to any post, page, or widget.

You can also specify attributes directly in the shortcode:
`[circle_tag_cloud taxonomy="category" max="30" shape="circle" palette="metallic"]`

== Installation ==

1.  Upload the `circle-tag-cloud` folder to the `/wp-content/plugins/` directory.
2.  Activate the plugin through the 'Plugins' menu in WordPress.
3.  Go to **Settings > Circle Tag Cloud** to configure the default options.
4.  Use the shortcode `[circle_tag_cloud]` in your content.

== Screenshots ==

1.  **Frontend Example:** A beautiful circular tag cloud with the "Metallic Mix" palette.
2.  **Settings Page:** Easily customize shapes, colors, dimensions, and motion settings.
3.  **Tooltip:** Tooltips appear on hover and keyboard focus for better accessibility.

== Frequently Asked Questions ==

= Can I use this with custom taxonomies? =
Yes. You can select any public taxonomy (like Post Tags, Categories, or WooCommerce Product Tags) from the settings page.

= How do I change the colors? =
Go to the settings page and select a preset "Color Palette". If you choose "Custom (User Defined)", you can enter your own comma-separated HEX color codes.

= The tag cloud is not updating after I added new tags. =
The plugin uses caching to improve performance (default 1 hour). To see changes immediately, go to the settings page and click the "Clear Cache" button.

== Changelog ==

= 1.0.2 =
* Added "Metallic Mix" color palette.
* Added "Custom Colors" option for user-defined palettes.
* Added "Text Outline" (Glow effect) feature.
* Added "Clear Cache" button in the admin settings.
* Improved text contrast calculation (auto black/white text).

= 1.0.1 =
* Implemented Transient API for better performance.
* Added accessibility support (keyboard focus tooltips).
* Fixed animation loop issue on window resize.
* Changed tooltip rendering to avoid overflow issues.

= 1.0.0 =
* Initial release.