﻿=== RSS NewsSync ===
Contributors: daazlabs
Tags: rss, feed, aggregator, news, automation
Requires at least: 5.6
Tested up to: 6.9
Stable tag: 1.0.1
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

The most powerful and easy-to-use RSS aggregator for WordPress — perfect for blogs, magazines, and niche sites.

== Description ==

RSS NewsSync automatically pulls content from unlimited RSS feeds and displays it with Grid, List, Carousel, Hero and Minimal layouts.

Features:
- Multiple RSS feeds
- 5 layouts: Grid, List, Carousel, Hero and Minimal
- Auto-import as regular WordPress posts
- Smart image download and local attachment handling
- Full custom mode (HTML/CSS)
- Elementor ready

== Quick Guide ==
1. Add feeds: RSS NewsSync → Add Feed.
2. Configure import settings (image handling, cache duration, and schedule).
3. Test import: run a manual import for one feed to confirm mapping.

== Shortcode examples ==
- Basic: [rsp limit="5"] — show up to 5 items.
- With offset: [rsp limit="5" offset="3"] — skip first 3 items, then show next 5.
- Order by title ascending: [rsp limit="10" orderby="title" order="ASC"]

Note: The plugin provides built-in ordering and limits; extensions may add more options via filters.

== Privacy ==
This plugin does not send site content, feed URLs, or any personal data to external services by default.

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/rss-newssync` directory, or install via the WordPress plugin installer.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Go to RSS NewsSync → Add your feeds → check layout and import settings.

== Screenshots ==

1. Grid layout
2. List + Custom mode
3. Hero carousel
4. Minimal layout
5. Settings panel

== Frequently Asked Questions ==

= Q: What does this plugin do? =
A: Imports items from configured RSS feeds and displays them via shortcodes or templates. Imported items are saved as regular WordPress posts unless configured otherwise.

= Q: What is the difference between "Run now (schedule)" and "Run now (direct)"? =
A: "Run now (schedule)" schedules a background job using WP‑Cron. "Run now (direct)" executes a single batch immediately in your browser — useful when WP‑Cron is not running or for testing.

== For reviewers ==
This repository contains the free plugin distribution. The plugin provides core functionality and hooks/filters for extensions.

== Changelog ==

= 1.0.0 =
* Initial release
* Core RSS import and display features
* i18n ready (text domain: rss-newssync)

== Notes for translators ==
Text domain: rss-newssync
Load translations from: /languages/

== Assets & Credits ==
See CREDITS.txt in the plugin root for information about bundled screenshots and their source licenses (Unsplash, Pixabay).
