=== Chips Content ===
Contributors: chipsbuilder
Donate link: https://content.chipsbuilder.com
Tags: news, rss, aggregation, ai, api
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Display AI-curated news on your WordPress site. Connect to Chips Content API to aggregate, summarize, and publish news from 75+ sources.

== Description ==

Chips Content connects your WordPress site to the [Chips Content](https://content.chipsbuilder.com) news aggregation platform. Configure keywords and sources, and let AI fetch, summarize, and display curated news articles on your site.

= Key Features =

* **75+ Pre-configured Sources** - Browse a catalog of RSS feeds, Reddit, and Google News sources across 7 categories
* **AI Summaries** - Every article gets an AI-generated summary in your preferred language
* **Shortcode Display** - Add `[chipsfeed]` to any page for a responsive 3-column news grid
* **Keyword Filtering** - Define keywords to fetch only relevant articles
* **Article Moderation** - Approve, reject, or auto-publish articles from the WordPress admin
* **Multi-Language** - Support for English, Italian, German, French, and Spanish
* **Expand In-Place** - Readers click "Read more" to expand the full article without leaving the page
* **Source Catalog** - Add sources with one click from a curated catalog, or add custom RSS/Reddit/Google News sources

= How It Works =

1. Sign up for a free account at [content.chipsbuilder.com](https://content.chipsbuilder.com/signup/)
2. Get your API key from the dashboard
3. Install and configure the plugin with your API key
4. Set keywords, choose sources from the catalog, and configure fetch frequency
5. Add the `[chipsfeed]` shortcode to any page or post
6. Articles are fetched automatically and displayed in a clean, responsive grid

= Shortcode Usage =

`[chipsfeed]` - Display all published articles (default count from settings)

`[chipsfeed count="6"]` - Display 6 articles

`[chipsfeed count="12" status="published"]` - Display 12 published articles

== External Services ==

This plugin connects to the Chips Content API to fetch and manage news articles.

= Chips Content API =
The plugin sends requests to the Chips Content REST API to retrieve articles, manage sources, update configuration, and trigger news fetches.

* **Data sent:** API key (for authentication), configuration settings (keywords, language, frequency), source management actions (add/delete/toggle), article moderation actions (approve/reject)
* **Data received:** News articles (title, summary, body, source URL, metadata), source list, configuration state, statistics
* **When:** On every admin page load (Sources, Articles, Configuration pages), on shortcode page load (cached), and when admin triggers a fetch
* **Service:** [https://content.chipsbuilder.com](https://content.chipsbuilder.com)
* **Terms of Service:** [https://content.chipsbuilder.com/terms/](https://content.chipsbuilder.com/terms/)
* **Privacy Policy:** [https://content.chipsbuilder.com/privacy/](https://content.chipsbuilder.com/privacy/)

No user data or visitor data is sent to the API. Only the site administrator's API key and content management actions are transmitted.

== Installation ==

1. Upload the `chipsfeed-news` folder to `/wp-content/plugins/` or install through the WordPress plugins screen
2. Activate the plugin through the 'Plugins' screen in WordPress
3. Go to Chips Content > Settings and enter your API key
4. Go to Chips Content > Configuration to set keywords, language, and fetch frequency
5. Go to Chips Content > Sources to add news sources from the catalog
6. A "News" page with the `[chipsfeed]` shortcode is created automatically on activation

== Frequently Asked Questions ==

= Where do I get an API key? =

Sign up for a free account at [content.chipsbuilder.com](https://content.chipsbuilder.com/signup/) and generate an API key from the dashboard.

= Is there a free plan? =

Yes! The free plan includes 1 news project, fetch every 24 hours, unlimited sources and keywords, and basic AI summaries.

= What source types are supported? =

RSS feeds, Reddit subreddits, and Google News. You can add sources from the built-in catalog (75+ pre-configured) or add custom sources manually.

= Can I moderate articles before they appear? =

Yes. By default, articles are fetched as drafts. You can approve or reject them from the Articles page. Enable "Auto-publish" in Configuration to skip moderation.

= How does caching work? =

The plugin caches API responses using WordPress transients. You can configure the cache duration (default 30 minutes) in Settings.

= Can I customize the display? =

The shortcode outputs standard HTML with CSS classes (prefixed `cfn-`). You can override styles in your theme's stylesheet.

== Screenshots ==

1. News grid displayed on the frontend with responsive 3-column layout
2. Source catalog with category and language filters
3. Article moderation in the WordPress admin
4. Configuration page with keywords, language, and fetch settings

== Changelog ==

= 1.1.0 =
* Added source catalog with 75+ pre-configured sources
* Category and language filters for the catalog
* One-click source addition from catalog
* Dynamic placeholder for source URL input
* Improved summary truncation with "..." indicator
* Added "Read more" expand button for articles
* Added "Source" link to original article

= 1.0.0 =
* Initial release
* Chips Content API integration
* Shortcode `[chipsfeed]` with responsive grid
* Admin pages: Settings, Configuration, Sources, Articles
* Keyword management with chip UI
* Article moderation (approve/reject/bulk actions)
* Multi-language support

== Upgrade Notice ==

= 1.1.0 =
Added source catalog for easy one-click source setup. Improved article display with read more and source links.

= 1.0.0 =
Initial release of Chips Content for WordPress.
