=== Vunelix Financial Widgets ===
Contributors: vunelix
Tags: cryptocurrency, forex, stocks, widgets, screener
Requires at least: 5.6
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.5
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Real-time financial widgets — tickers, screeners, heatmaps, currency converters, and technical analysis charts for crypto, forex, and stocks.

== Description ==

**Vunelix Financial Widgets** adds embeddable, real-time financial widgets to any WordPress page or post with a simple shortcode.

20+ widgets covering **crypto, stocks, forex, funds, and technical analysis**, powered by live market data over WebSocket.

= Features =

* Free — all included widget types work without a paid upgrade
* Standalone — no other plugin required
* Shadow DOM rendering for CSS isolation from the host theme
* Real-time price updates via WebSocket
* Auto light/dark theme detection plus manual override
* Custom color overrides (separate light/dark values)
* 30+ language translations with full RTL support
* Mobile responsive
* Lazy loading — widget JS runs when scrolled into view
* Visual shortcode generator in the WordPress admin
* Domain-based authorization (no API key to manage)

= Widget Categories =

**Ticker Widgets**
* **Ticker Tape** — Scrolling price bar with live crypto, forex, and stock quotes
* **Ticker** — Static price cards with real-time updates

**Market Movers**
* **Crypto Market Movers** — Top gaining and losing cryptocurrencies
* **Forex Market Movers** — Most active forex pairs by price movement
* **Stock Market Movers** — Top gaining and losing stocks

**Currency Tools**
* **Currency Converter** — Real-time currency conversion with 150+ pairs and historical chart
* **Cross Rates** — Live exchange rates matrix between major and exotic currency pairs
* **Currency Heatmap** — Color-coded forex strength grid across multiple timeframes

**Heatmaps**
* **Crypto Heatmap** — Market cap weighted cryptocurrency treemap
* **Stock Heatmap** — Stock market heatmap organized by sector and market cap

**Screeners (7 types)**
* **Crypto Screener** — Filter, sort, and compare 10,000+ cryptocurrencies
* **Stock Screener** — Screen stocks across 50+ global markets
* **Forex Screener** — Compare forex pairs with technical and fundamental data
* **Fund Screener** — Filter mutual funds and ETFs
* **CEX Screener** — Centralized exchange crypto trading pairs
* **DEX Screener** — Decentralized exchange token pairs
* **DR Screener** — Depositary receipts (ADR/GDR) screener

**Technical Analysis**
* **Technical Analysis** — Full analysis with oscillators, moving averages, and pivot points
* **Technical Summary** — Quick buy/sell signal gauge
* **Oscillators** — RSI, MACD, Stochastic, CCI, and more
* **Moving Averages** — SMA, EMA, WMA, and other MA indicators
* **Pivot Points** — Classic, Fibonacci, Camarilla, and Woodie pivot levels

= How It Works =

1. Install and activate the plugin
2. Go to **Vunelix Widgets** in the WordPress admin sidebar
3. Pick a widget and configure settings visually
4. Copy the generated shortcode
5. Paste into any page, post, or widget area
6. Done — the widget renders with live data on your site

= Shortcode Examples =

**Scrolling Crypto Ticker:**
`[vunelix widget="ticker-tape" theme="dark" symbols="BINANCE:BTCUSD,BINANCE:ETHUSD,BINANCE:SOLUSD"]`

**Stock Screener with 50 rows:**
`[vunelix widget="stock-screener" per_page="50" default_country="US"]`

**Crypto Heatmap:**
`[vunelix widget="crypto-heatmap" default_per_page="100" enable_fullscreen="true"]`

**USD to EUR Converter:**
`[vunelix widget="currency-converter" from="USD" to="EUR" show_chart="true"]`

**Apple Technical Analysis:**
`[vunelix widget="technical-analysis" symbol="NASDAQ:AAPL" default_period="1d"]`

**Forex Market Movers (dark theme):**
`[vunelix widget="forex-market-movers" theme="dark" sort_by="active.chp_desc" per_page="12"]`

= Getting Started =

Widgets load on verified domains. To activate:

1. [Sign up for free](https://developers.vunelix.com/signup) at the Vunelix developer portal
2. Add and verify your website domain
3. Install this plugin and start embedding widgets

No credit card, no trial period — the free plan includes all 20+ widget types.

== External services ==

This plugin relies on two external services to function. By using the plugin you agree to the terms and privacy policies linked below.

= Vunelix (vunelix.com) =

What it is and what it is used for: Vunelix is the service operated by the plugin author. It provides the widget rendering API (HTML/CSS/icon templates per widget), domain-based authorization, language JSON files, and the icon/image assets shown in the WordPress admin dashboard (widget previews, country/symbol flags).

What data is sent and when:

* When a widget is rendered on a frontend page, the browser sends a POST request to `https://vunelix.com/embed/render` containing the widget slug, the widget settings configured in the admin, and the page URL on which the widget is embedded. The site domain is detected from the standard `Origin` / `Referer` headers the browser already sends.
* When a widget loads, the browser fetches language JSON files from `https://vunelix.com/assets/js/lang/...`. (Widget CSS is bundled with the plugin and loaded locally — see "Source code" below.)
* In the WordPress admin dashboard, country flag icons and asset/symbol icons used inside select dropdowns are loaded as `<img>` tags from `https://vunelix.com/assets/icons/...` (these change frequently as new symbols/markets are added, so they are served centrally rather than bundled).
* The admin dashboard also calls `https://vunelix.com/api/` to fetch the searchable lists of currencies, stocks, and crypto symbols when the widget settings UI is opened.

No personal user data is collected by the plugin itself.

* Website: https://vunelix.com
* Terms of Service: https://vunelix.com/terms
* Privacy Policy: https://vunelix.com/privacy-policy

= FCS API (fcsapi.com) =

What it is and what it is used for: FCS API is the upstream market-data provider used by the Vunelix backend to source real-time prices, technical signals, and chart data for crypto, forex, and stock symbols. Widgets receive this data via the Vunelix API and via a WebSocket stream.

What data is sent and when: When a widget connects, a WebSocket connection is opened to the FCS data feed to stream price updates for the symbols configured on the widget. No personal data is sent.

* Website: https://fcsapi.com
* Terms of Service: https://fcsapi.com/terms
* Privacy Policy: https://fcsapi.com/privacy-policy

== Source code ==

All JavaScript shipped with this plugin is provided in human-readable, un-obfuscated form inside the `assets/js/` directory of the plugin. Widget CSS is bundled with the plugin under `assets/css/widget-runtime/`. Admin dashboard CSS lives directly under `assets/css/`. No build step is required to inspect or modify the code.

== Installation ==

**From WordPress Admin:**

1. Go to **Plugins → Add New**
2. Search for "Vunelix Financial Widgets"
3. Click **Install Now** → **Activate**
4. Go to **Vunelix Widgets** in the admin sidebar

**Manual Installation:**

1. Download the plugin zip file
2. Go to **Plugins → Add New → Upload Plugin**
3. Upload the zip file and click **Install Now**
4. Activate the plugin

**After Activation:**

1. [Sign up for free](https://developers.vunelix.com/signup) and verify your domain
2. Go to **Vunelix Widgets** in the admin sidebar
3. Select a widget, configure it, and copy the shortcode
4. Paste the shortcode into any page or post

== Frequently Asked Questions ==

= Do I need an API key? =

No. Vunelix uses domain-based authorization. Just verify your website domain at [developers.vunelix.com](https://developers.vunelix.com/signup) and widgets activate automatically.

= Is it really free? =

Yes. All 20+ widget types are free with no time limit. Premium plans add features like branding removal, higher symbol limits, and priority support.

= Will this slow down my website? =

Widgets use lazy loading — JavaScript runs when a widget scrolls into view. CSS is isolated inside Shadow DOM. There are no heavy libraries and no jQuery dependency.

= Does it work with Elementor / Divi / WPBakery? =

Yes. The shortcode `[vunelix ...]` works in any page builder that supports WordPress shortcodes. Just paste it into a text or shortcode block.

= Does it work with my theme? =

Yes. All widgets render inside Shadow DOM, which means they are completely isolated from your theme's CSS. They will never break your layout, and your styles will never affect the widget.

= Can I use multiple widgets on the same page? =

Yes. You can add as many widgets as you want. Each one loads independently.

= Can I customize the look and feel? =

Yes. Every widget supports:
* Theme: Auto (detect from site), Light, Dark
* Custom colors: Positive, negative, background, text, border — with separate light and dark values
* Transparent background mode

= Does it support RTL languages? =

Yes. Full RTL layout support for Arabic (العربية), Hebrew (עברית), Farsi (فارسی), and Urdu (اردو) with automatic direction detection.

= What markets and assets are covered? =

* **Crypto** — 10,000+ coins and tokens across major exchanges
* **Stocks** — 50+ global markets including US, EU, Asia, Middle East
* **Forex** — 150+ currency pairs from major exchanges
* **Funds** — Mutual funds and ETFs
* **DEX** — Decentralized exchange pairs

= How do I get support? =

Visit [vunelix.com](https://vunelix.com) for documentation, or reach out through the developer dashboard.

== Screenshots ==

1. Crypto Heatmap — Market cap weighted cryptocurrency treemap
2. Ticker — Scrolling price bar with live crypto, forex, and stock quotes
3. Currency Heatmap — Color-coded forex strength across timeframes
4. Stock Screener — Screen stocks across 50+ global markets
5. Stock Heatmap — Sector-based stock market heatmap
6. Stock Market Movers — Top gaining and losing stocks
7. Currency Converter — Real-time conversion with historical chart
8. Crypto Screener — Filter and sort 10,000+ cryptocurrencies
9. Currency Cross Rates — Live exchange rates matrix
10. Crypto Market Movers — Top gaining and losing cryptocurrencies
11. Forex Screener — Compare forex pairs with technical data
12. Forex Market Movers — Most active forex pairs

== Love Vunelix? Leave a Review! ==

If Vunelix Widgets is helping your site, please [leave a 5-star review](https://wordpress.org/support/plugin/vunelix-financial-widgets/reviews/#new-post). It takes 30 seconds and helps other WordPress users discover the plugin. Your feedback motivates us to keep shipping new features and improvements.

== Changelog ==

= 1.0.5 =
* Initial release with 20+ financial widgets
* Visual shortcode generator in WordPress admin
* Shadow DOM isolation — zero CSS conflicts
* Real-time WebSocket price streaming
* Auto light/dark theme detection
* 30+ language translations with full RTL support
* Custom color overrides (light + dark values)
* Lazy loading for optimal page speed
* Domain-based authorization (no API keys)


== Upgrade Notice ==

= 1.0.5 =
First public release on WordPress.org. Includes 20+ financial widgets with real-time data, Shadow DOM isolation, and 30+ language translations.