=== VortexCodex Crypto Widgets ===
Contributors: vortexcodex
Tags: cryptocurrency, bitcoin, crypto ticker, coin price, ethereum
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.5
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Live cryptocurrency price ticker, cards, tables and inline labels powered by the free CoinGecko API. Shortcodes, a widget, auto-refresh and caching.

== Description ==

VortexCodex Crypto Widgets adds beautiful, lightweight cryptocurrency price displays to any WordPress site — no API key required.

**Display types**

* **Scrolling ticker** — a smooth, seamless marquee of live prices (pauses on hover).
* **Price cards** — a responsive grid of coin cards with price, 24h change and market cap.
* **Price table** — rank, coin, price, 24h change, market cap and 24h volume.
* **Inline label** — drop a live price right inside a sentence.
* **Sidebar widget** — compact list or cards for any widget area.

**Features**

* 17,000+ coins supported via CoinGecko ids (bitcoin, ethereum, solana, …).
* 20 display currencies including USD, EUR, GBP, INR, JPY — even BTC and ETH.
* Prices auto-refresh in the visitor's browser without a page reload (optional).
* Smart server-side caching — one upstream API call per cache window, no matter how much traffic you get. If the API is briefly unreachable, the last good prices are shown.
* 24h change shown in green/red with a customizable accent color.
* Fully responsive, tiny footprint: one small CSS file and one dependency-free JS file, loaded only on pages that use a widget.
* Respects `prefers-reduced-motion`.
* Translation-ready.

**Shortcodes**

* `[vortexcodex_ticker coins="bitcoin,ethereum" currency="usd" speed="50"]`
* `[vortexcodex_cards coins="bitcoin,ethereum,solana" columns="3"]`
* `[vortexcodex_table coins="bitcoin,ethereum,solana"]`
* `[vortexcodex_label coin="bitcoin" show_change="yes"]`

All attributes are optional; defaults are configured under **Settings → VortexCodex Crypto**. Shortcodes work in the block editor (Shortcode block), classic editor, and most page builders.

**Pro version**

A [Pro add-on](https://dontworry2much.com/) is available with historical price charts, 7-day sparkline cards, a visitor currency switcher, and a live crypto converter.

== External services ==

This plugin retrieves cryptocurrency market data from the **CoinGecko API** (https://www.coingecko.com). Requests are made from your server (never from your visitors' browsers directly to CoinGecko) whenever the local cache expires. Only the list of coin ids and the display currency you configure are sent; no personal or visitor data is transmitted.

* CoinGecko Terms of Service: https://www.coingecko.com/en/terms
* CoinGecko Privacy Policy: https://www.coingecko.com/en/privacy

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/vortexcodex-crypto-widgets`, or install through the WordPress plugins screen.
2. Activate the plugin.
3. Configure defaults under **Settings → VortexCodex Crypto**.
4. Add a shortcode to any post/page, or add the "VortexCodex Crypto Prices" widget to a sidebar.

== Frequently Asked Questions ==

= Do I need an API key? =

No. The plugin uses CoinGecko's free public API. Server-side caching keeps you comfortably within its rate limits.

= How do I find a coin's id? =

Open the coin's page on coingecko.com — the id is the "API id" shown on the page (and usually the slug in the URL). Examples: `bitcoin`, `ethereum`, `ripple`, `dogecoin`.

= How fresh are the prices? =

Data is cached on your server for the duration you choose (default 5 minutes, minimum 1). With auto-refresh enabled, visitors' pages update on the same schedule without reloading.

= Can I change the colors? =

Pick an accent color in Settings → VortexCodex Crypto. For deeper changes, all elements use prefixed `vortexcodex-` CSS classes you can target from your theme's custom CSS.

= Does it slow my site down? =

No. Prices are fetched server-side and cached; the front end loads one ~4 KB CSS file and one ~3 KB JS file, only on pages that actually display a widget.

== Screenshots ==

1. Scrolling price ticker.
2. Price cards grid.
3. Price table with market cap and volume.
4. Inline price labels inside your content.
5. Settings page.

== Changelog ==

= 1.0.5 =
* Added information about the Pro add-on (charts, sparklines, currency switcher, converter) on the settings page.

= 1.0.4 =
* Renamed the plugin to "VortexCodex Crypto Widgets" (slug vortexcodex-crypto-widgets); all internal prefixes, shortcodes and text domain updated to match.

= 1.0.3 =
* Removed the Plugin URI header (author homepage is kept in Author URI).

= 1.0.2 =
* Set plugin and author homepage to dontworry2much.com.

= 1.0.1 =
* Updated plugin name and metadata for the WordPress.org directory; declared compatibility with WordPress 7.0.

= 1.0.0 =
* Initial release: ticker, cards, table and label shortcodes, sidebar widget, settings page, REST-powered auto-refresh, transient caching with stale fallback.

== Upgrade Notice ==

= 1.0.4 =
Plugin renamed to VortexCodex Crypto Widgets; shortcode names changed accordingly.
