=== OST 3D Image Tag Cloud ===
Contributors: opensourcetech
Tags: tag cloud, tags, 3d, images, widget
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 2.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Show your post tags as a rotating 3D cloud, using each tag's latest featured image.

== Description ==

OST 3D Image Tag Cloud shows your post tags in a rotating 3D sphere. Each tag is drawn with the featured image of its most recent post. Tags without an image show their name. Click a tag to open its archive.

* `[ost3dcloud]` shortcode for any post, page or block theme template.
* "OST 3D Image Cloud" widget for classic themes.
* Settings for title, number of tags, size, colours, font and text sizes.
* The tag list stays in the page for screen readers, keyboard users and search engines.
* Visitors who prefer reduced motion see a plain list of tags instead of the animation.
* No jQuery needed.

= Shortcode =

`[ost3dcloud tags="20" width="300" height="300"]`

* `tags` – number of tags. Default: the value in Settings.
* `width`, `height` – size in pixels. Default: the value in Settings.

= Third-party library =

The 3D animation uses [TagCanvas](https://www.goat1000.com/tagcanvas.php) 2.11 by Graham Breach, licensed under the LGPL v3. The readable source is included as `assets/js/tagcanvas.js`.

== Installation ==

1. In your WordPress admin go to Plugins > Add New, search for "OST 3D Image Tag Cloud", then install and activate it.
2. Go to Settings > OST 3D Image Cloud to set the size and colours.
3. Add the `[ost3dcloud]` shortcode to a page, or add the widget under Appearance > Widgets.

== Frequently Asked Questions ==

= Where do the tag images come from? =

From the featured image of the newest published post that uses the tag.

= Do my settings carry over from version 1.0? =

Yes. Settings and placed widgets are kept. The settings page has moved from its own menu to Settings > OST 3D Image Cloud.

== Changelog ==

= 2.0.0 =
* Security: settings are now saved with a nonce and permission check, and all settings and output are validated and escaped.
* Fixed the wrong image being picked for a tag.
* Fixed the clouds breaking when shown more than once on a page.
* Updated TagCanvas from 1.19 (2012) to 2.11 and removed the jQuery dependency.
* New `[ost3dcloud]` shortcode, so the cloud also works in block themes.
* Settings page now includes colours, font and text sizes, and moved under Settings.
* Accessibility: the tag list stays available to screen readers and keyboard users, and the animation is off for reduced-motion users.
* Empty tags are no longer shown.
* Settings are removed when the plugin is deleted.
* Renamed from "OST 3D Image tag cloud : Beta 1.0" to "OST 3D Image Tag Cloud".
* Now requires WordPress 6.0 and PHP 7.4 or later. Tested up to WordPress 7.1.

= 1.0 =
* Initial release.

== Upgrade Notice ==

= 2.0.0 =
Security update with a newer 3D library, a shortcode for block themes and better accessibility.
