=== Cryptocurrency Price Widget ===
Contributors: falselight
Tags: bitcoin, cryptocurrency, crypto widget, price ticker, live prices
Donate link: https://currencyrate.today/
Tested up to: 7.0
Requires at least: 3.1
Requires PHP: 5.3
Stable tag: 1.3.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Display live cryptocurrency prices in a clean, customizable WordPress widget with shortcode-based setup and flexible design controls.

== Description ==
Add a live cryptocurrency price widget to any WordPress site in minutes.

Cryptocurrency Price Widget is designed for publishers, crypto blogs, fintech products, landing pages, and market-focused websites that want real-time price visibility without pushing market calculations into WordPress itself. Configure the widget in the admin panel, preview it instantly, and paste the generated shortcode wherever you want it to appear.

= Why site owners use Cryptocurrency Price Widget =
* Live streaming prices in a compact, attention-grabbing widget.
* Fast setup with a built-in preview and shortcode generator.
* Flexible design controls for color, rounded corners, shadow, border, striped rows, streaming, and signature.
* Lightweight WordPress integration: the widget loads from external services, helping keep server-side workload low.
* 447 bundled cryptocurrency choices and 162 bundled fiat currencies in the admin selector.
* Updated local fiat flags and an improved admin asset picker for a cleaner setup experience on WordPress 6.x and 7.0.
* Multilingual-ready output with localized widget script loading.

= Perfect for =
* Crypto blogs and market news sites
* Web3, wallet, exchange, and fintech landing pages
* Price overview pages and comparison pages
* Affiliate and education content around Bitcoin, Ethereum, and altcoins
* Publishers who want a live widget without building their own price feed integration

= Quick start =
1. Install and activate the plugin.
2. Open Settings > CR Crypto Price.
3. Choose the currencies for the top row and the assets for the price list.
4. Adjust the widget design and preview the result live.
5. Copy the generated shortcode and paste it into any post, page, or shortcode-friendly area.

= Live demo and video =
* Demo and generator: [CO-IN.IO](https://co-in.io/crypto-price-widget/)
* Video walkthrough: [YouTube demo](https://www.youtube.com/watch?v=D7thN9c8PxM)

= Shortcode example =
[cryptocurrency-price-widget base="USD,EUR,CNY,GBP" items="BTC,ETH,LTC,XMR,DASH" backgroundColor="fff" streaming="1" rounded="1" boxShadow="1" border="1" signature="1"]

= Supported shortcode attributes =
* items - comma-separated asset symbols shown in the main list
* base - comma-separated currencies shown in the top row
* backgroundColor - background color in hex format without the # symbol
* streaming - 1 to enable live updates, 0 to disable them
* striped - 1 to enable striped rows, 0 to disable them
* rounded - 1 to enable rounded corners, 0 to disable them
* boxShadow - 1 to enable a shadow, 0 to disable it
* border - 1 to show a border, 0 to hide it
* signature - 1 to show the powered-by signature, 0 to hide it

= External services =
This plugin uses external services to deliver live prices, front-end rendering, admin previews, and some admin assets.

* CO-IN.IO loads the front-end widget script and the admin preview.
	Service URL: [https://co-in.io/crypto-price-widget/](https://co-in.io/crypto-price-widget/)
* CurrencyRate.Today is used for the optional powered-by signature link.
	Service URL: [https://currencyrate.today/](https://currencyrate.today/)
	Privacy Policy: [https://currencyrate.today/page/privacy](https://currencyrate.today/page/privacy)
	Legal Disclaimer: [https://currencyrate.today/page/disclaimer](https://currencyrate.today/page/disclaimer)
* CryptoCompare is used in the admin area for cryptocurrency icon assets.
	Service URL: [https://www.cryptocompare.com/](https://www.cryptocompare.com/)
	Privacy Policy: [https://www.cryptocompare.com/privacy-policy/](https://www.cryptocompare.com/privacy-policy/)
	Terms & Conditions: [https://www.cryptocompare.com/terms-conditions/](https://www.cryptocompare.com/terms-conditions/)

When the widget or admin preview is loaded, requests may include selected asset symbols, selected display options, language context, and the browser request needed to return the remote widget script, preview, or icon assets.

Supported by: [CurrencyRate.today](https://currencyrate.today)

== Installation ==

= From your WordPress dashboard =
1. Visit Plugins > Add New.
2. Search for Cryptocurrency Price Widget.
3. Install and activate the plugin.
4. Open Settings > CR Crypto Price.
5. Configure your widget, copy the generated shortcode, and paste it into any post or page.

= Manual installation =
1. Download Cryptocurrency Price Widget.
2. Upload the cryptocurrency-price-widget directory to your /wp-content/plugins/ directory.
3. Activate the plugin from the Plugins page in WordPress.
4. Open Settings > CR Crypto Price.
5. Configure the widget and paste the generated shortcode where you want the widget to appear.

== Frequently Asked Questions ==

= How do I publish the widget on a page? =
Configure the widget in Settings > CR Crypto Price, copy the generated shortcode, and paste it into a post, page, Shortcode block, or any area that supports shortcodes.

= Does it work with WordPress 7.0? =
Yes. Version 1.3.0 is tested up to WordPress 7.0.

= Will it slow down my site? =
The widget script and live market rendering are served by external services, so your WordPress server does not perform the market data calculations itself.

= Can I choose my own coins and fiat currencies? =
Yes. The admin selector includes 447 bundled cryptocurrency choices and 162 bundled fiat currencies. The top row is usually used for fiat currencies, while the main list is usually used for cryptocurrencies.

= Can I customize the widget look? =
Yes. You can control the background color, streaming mode, striped rows, rounded corners, shadow, border, and the optional powered-by signature.

= How do I make the widget a fixed width? =
Place the shortcode output inside a container with a fixed width. For best results, keep the available width at 220px or wider.

= Can I hide the signature link? =
Yes. Set the signature option to 0 in the shortcode, or disable it in the admin settings before copying the generated shortcode.

= Where does the live data come from? =
The front-end widget and admin preview load from CO-IN.IO. The optional attribution link points to CurrencyRate.Today, and cryptocurrency icons in the admin selector are loaded from CryptoCompare.

== Screenshots ==
1. screenshot-1.png - Admin settings with live preview and shortcode generator
2. screenshot-2.png - Front-end widget example with multiple base currencies
3. screenshot-3.png - Front-end widget styling example
4. screenshot-4.gif - Animated widget preview

== Upgrade Notice ==

= 1.3.0 =
Recommended update for WordPress 6.x and 7.0 users. This release refreshes the admin asset picker, updates bundled assets, improves icon quality, and modernizes the setup experience.

== Changelog ==

= 1.3.0 =
* Refined the admin asset picker for WordPress 6.x and 7.0.
* Improved dropdown spacing and overall selector usability.
* Refreshed the bundled crypto asset list for Select vertical.
* Switched Select horizontal fiat flags to updated local assets.
* Increased admin crypto icon source size for cleaner rendering.

= 1.2.5 =
* Verified compatibility with WordPress 7.0.

= 1.2.4 =
* Fixed security issues.
* Fixed general bugs.

= 1.2.3 =
* Fixed the $content error.

= 1.2.2 =
* Important fixes.
* Minor fix.

= 1.2.0 =
* Important fixes.
* Fixed minor bugs.

= 1.1.5 =
* Fixed minor bugs.

= 1.1.4 =
* Fixed minor bugs.

= 1.1.3 =
* Added de, fr, and pt translations.
* Updated Select2.

= 1.1.2 =
* Fixed admin settings.

= 1.1.1 =
* Added Russian language support.

= 1.1.0 =
* Stable release.

= 1.0.0 =
* First release.
