=== StockTitan News Feed ===
Contributors: stocktitan
Tags: news, stocks, finance, feed, block
Requires at least: 6.3
Tested up to: 6.9
Requires PHP: 8.1
Stable tag: 1.0.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

StockTitan stock market news block for NYSE, NASDAQ, OTC finance headlines with simple styling controls.

== Description ==

StockTitan News Feed is a server-rendered Gutenberg block by StockTitan that brings timely, reliable headlines from the StockTitan platform directly to your site.

It streams market-moving alerts from NYSE, NASDAQ, and OTC markets--earnings, filings, IPO updates, analyst notes, sentiment signals--so readers stay on your site for fresh finance coverage.

Want the always-on live feed? Visit https://www.stocktitan.net/news/live.html.

- Server-rendered: Renders on the server for fast, SEO-friendly output.
- Theming: Presets and CSS variables let the block blend with your theme.
- Controls: Toggle logo/date/summary/tag, limit items, choose date format.
- Fast loading: Lean markup keeps the feed quick on busy pages.

Block registration is powered by `block.json` and compiled assets in `assets/`.

== About StockTitan ==

Transforming complex market data into actionable intelligence

Welcome to StockTitan, where we empower investors and traders with timely, reliable, simple, and effective financial information and tools. Our mission is to transform complex market data into practical, actionable tools that help you navigate the stock market with confidence.

We combine our deep market experience, technological expertise, and your valuable feedback to create a platform that truly serves your investment needs-whether you're a seasoned professional or just beginning your trading journey.

=== Data and privacy ===

- External request: The block fetches JSON news data from `https://wpapi.stocktitan.net/api/news/json`.
- Personal data: No personal user data is sent; requests include only the parameters needed to render the feed.
- Caching: Responses are stored in a WordPress transient (2-minute TTL). Subsequent requests use HTTP conditional GET (ETag / If-None-Match), so unchanged data returns as HTTP 304 with zero payload — no bandwidth consumed regardless of traffic volume.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/`, or install the ZIP via the WordPress dashboard.
2. Activate the plugin through the "Plugins" menu.
3. Add the "StockTitan News Feed" block to a post or page.

== Frequently Asked Questions ==

= What kind of news will this block show? =
It pulls the same stream StockTitan publishes—official company announcements, SEC filings, and press releases from US-listed tickers. You get reliable headlines straight from the source rather than third-party commentary.

= How fast are updates? =
Updates arrive with the same 30-second delay that StockTitan applies to free-tier users. If you need real-time delivery, upgrade to StockTitan Gold on the main site—the block will then mirror the faster feed. You can always tap into the live stream at https://www.stocktitan.net/news/live.html.

= Does StockTitan offer a public API? =
No. StockTitan keeps its data inside the web experience and mobile-optimized PWA, so this block uses the official site endpoints instead of a developer API.

= Can I use StockTitan on my phone and get alerts? =
Yes. StockTitan provides a Progressive Web App you can add to your home screen for push notifications and an app-like layout. It works across desktop, iOS, and Android without installing a store app.

= Does this collect personal data? =
No. It only requests the news JSON needed to render headlines—no user details, cookies, or analytics payloads are sent.

== Screenshots ==

1. The StockTitan News Feed block in the editor.
2. Choose a theme for your news block or select each color individually.
3. Front-end rendering with theme preset.
4. Find the block in the Gutenberg editor

== Changelog ==

= 1.0.4 =
Dropped legacy WordPress editor compatibility, moved to Block API v3, and cleaned obsolete runtime fallbacks.

= 1.0.3 =
Updated API token handling, switched to wp_date(), and general cleanup.

= 1.0.0 =
Initial release.

== Upgrade Notice ==

= 1.0.4 =
Targets current WordPress block APIs and removes obsolete compatibility code.
