RSS NewsSync – Complete Documentation

1. Basic Shortcode

[ newssync ]

Uses your default settings from the admin panel.

2. Main Parameters (work in ALL layouts)

Parameter	Example	Description
`layout`	`grid`, `list`, `carousel`, `hero`, `minimal`	Choose the visual style
`limit`	`limit="6"`	Maximum number of items (Hero/Carousel limited to 6)
`category`	`category="CNBC"`	Show only one source (must match the category name you set)
`source`	`source="posts"`	Use imported posts instead of live RSS
`autoplay`	`autoplay="on"`	Enable/disable carousel autoplay (on/off)
`cache_ttl`	`cache_ttl="3600"`	Cache duration in seconds (overrides global setting)
`orderby`	`orderby="date"`	Order by date or title
`order`	`order="DESC"`	Sort order: DESC (newest first) or ASC (oldest first)
`offset`	`offset="3"`	Skip first N items (limited in FREE version due to per-feed restrictions)
`show_image`	`show_image="no"`	Show/hide images. Works in all layouts: grid, list, carousel, hero.
`hide_image`	`hide_image="yes"`	Alternative way to hide images — same as show_image=”no”.
`custom_css_class`	`custom_css_class="my-dark"`	Adds a custom CSS class to the container. Use it to target the feed with your own CSS rules (e.g. for dark themes).

3. List Mode (only when layout=”list”)

list_mode="standard" → Classic list with image
list_mode="minimal" → Ultra-compact (title + time + source)
list_mode="custom" → Full control!

4. CUSTOM MODE – Full Control

Use list_mode="custom" and combine any of these parameters: Note: show_image and hide_image also work in grid, carousel and hero layouts.

[ newssync layout="list" list_mode="custom"
 limit="8"
 category="CNN"
 show_image="no"
 show_excerpt="yes"
 excerpt_length="20"
 show_date="yes"
 show_source="yes"
 date_format="H:i - d/m"
 show_readmore="yes"
 compact="yes" ]

All available parameters:

Parameter	Description
`show_title="yes/no"`	Show/hide title
`show_image="yes/no"`	Show/hide image. Works in all layouts (grid, list, carousel, hero).
`hide_image="yes/no"`	Alternative way to hide images — same as show_image=”no”. Works in all layouts.
`show_excerpt="yes/no"`	Show/hide description
`show_date="yes/no"`	Show/hide date/time
`show_source="yes/no"`	Show/hide source (CNBC, etc.)
`show_readmore="yes/no"`	Show “Read more” link
`compact="yes"`	Ultra-compact layout (perfect for 30% columns)
`date_format="H:i - d/m"`	Any PHP date format (ver formatos)
`excerpt_length="20"`	Maximum number of words in excerpt (max 25)

5. Complete Examples

Example 1: Grid with 6 items

[ newssync layout="grid" limit="6" ]

Example 2: Carousel with autoplay

[ newssync layout="carousel" autoplay="on" limit="6" ]

Example 3: List with specific source

[ newssync layout="list" category="BBC News" limit="10" ]

Example 4: Ultra-compact sidebar

[ newssync layout="minimal" limit="5" ]

Example 5: Custom list without images

[ newssync layout="list" list_mode="custom" show_image="no" show_date="yes" show_source="yes" compact="yes" ]

Tip: show_image=”no” also works with layout=”grid” and layout=”carousel”.

Example 6: Hero banner

[ newssync layout="hero" limit="3" ]

Example 7: Using imported posts

[ newssync source="posts" limit="8" layout="grid" ]

Requires “Save RSS Items as Posts” enabled in Settings

6. Layout Comparison

Layout	Best For	Characteristics
Grid	Main content areas, magazine style	Responsive columns, images, excerpts
List	Archives, news feeds, blog lists	Vertical list, customizable fields
Carousel	Featured content, homepage highlights	Sliding items, autoplay, navigation
Hero	Top banner, breaking news	Large images, prominent headlines
Minimal	Sidebars, widgets, compact spaces	Title + date + source only, no images

NewsSync PRO — Documentation

Everything you need to get the most out of DaazSync PRO.

Shortcodes

Shortcode	Description
`[ newssync ]`	Displays live RSS news on any page or post. Supports grid, list, hero, carousel and more.
`[ newssync layout="split-hero" ]` ⭐ PRO	Large image left + numbered article list right. Customisable colour and auto-advance speed.
`[ newssync_best ]` ⭐ PRO	Best news of the day from WordPress posts. Requires “Save as Posts” enabled.
`[ newssync layout="ticker" ]` ⭐ PRO	Horizontal scrolling headline strip. Ideal for finance, crypto and breaking news sites.
`[ newssync layout="masonry" ]` ⭐ PRO	Pinterest-style grid with variable card heights. Perfect for editorial and magazine sites.
`[ newssync layout="magazine" ]` ⭐ PRO	1 large featured article + 4 side articles. Classic newspaper front-page layout.
`[ newssync_briefing_ticker ]` ⭐ PRO	Repeating “DAILY BRIEFING” teaser strip. Scrolls a bold call-to-action that links to your Daily Briefing page.
`[ newssync_daily_briefing ]` ⭐ PRO	Renders the AI-generated daily news briefing as a styled newsletter block with inline source links.

Getting Started

DaazSync PRO extends the free plugin with caching, per-feed limits, AI summaries, full-text extraction, and keyword filtering. All PRO settings live on this page — changes take effect on the next feed fetch.

To display a feed on any page or post, use the shortcode:

[ newssync feed="https://example.com/feed" ]

You can add as many shortcodes as you like on the same page, each pointing to a different feed URL.

General Settings

Cache Duration — How long fetched feed data is stored before a fresh request is made. Use a longer cache (e.g. 12 h) for busy sites to reduce external HTTP calls.
Max Items per Feed — Global cap on how many articles are stored per feed source. Override this on individual feeds inside the Feeds tab.
Max Items to Import — Maximum number of new items imported per scheduled run. Useful for high-traffic feeds.

Shortcode: [ newssync ]

The main shortcode. Place it on any page, post, or widget area. Works without any attributes — it will use your Feeds and General settings automatically.

[ newssync ]

Layout & items

Attribute	Default	Description
`layout`	`grid`	Display layout. Values: grid, list, hero, carousel, minimal.
`limit`	(from settings)	Max number of articles to show. Overrides the global per-feed cap.
`offset`	`0`	Skip the first N articles. Useful to show different slices on different pages.
`orderby`	`date`	Sort articles by: date, title, or guid.
`order`	`DESC`	Sort direction: DESC (newest first) or ASC (oldest first).
`category`	(all)	Filter by category slug or ID.
`autoplay`	`on`	Auto-play slides in hero/carousel. Values: on, off.

Display controls

Attribute	Default	Description
`show_image`	`1`	Show article thumbnail. 1 = yes, 0 = no.
`show_title`	`yes`	Show article title. Values: yes, no.
`show_date`	`yes`	Show publication date.
`show_excerpt`	`yes`	Show article excerpt.
`show_source`	`no`	Show the feed source name below the title.
`show_readmore`	`no`	Show a “Read More” link. Can also be toggled globally in General settings.
`excerpt_length`	`25`	Max excerpt length in words.
`date_format`	`H:i - d/m`	PHP date format string for displayed dates.

PRO-exclusive attributes ⭐ PRO

Attribute	Default	Description
`layout="split-hero"`	—	Activates the PRO split-hero layout. See section below for details.
`layout="ticker"`	—	Horizontal scrolling headline strip. See section below.
`layout="masonry"`	—	Pinterest-style variable-height grid. See section below.
`layout="magazine"`	—	Newspaper grid: 1 featured + 4 side articles. See section below.
`accent_color`	`#e11d48`	Accent colour for the split-hero layout (badge, active border, progress bar). Any hex colour.
`heading`	(none)	Optional title displayed above the split-hero widget.
`interval`	`5`	Auto-advance interval in seconds for split-hero and magazine slideshow (1–60).
`slideshow`	`no`	Set to “yes” on the magazine layout to enable dynamic slideshow mode.
`keyword_filter`	(none)	Filter articles by keyword. Comma-separated = OR logic. Separate groups with `\	` for AND logic. Case-insensitive. See Advanced Filtering section for full documentation.

Exemplos

[ newssync layout="grid" limit="9" show_readmore="yes" ]
[ newssync layout="hero" limit="6" autoplay="off" ]
[ newssync layout="list" offset="3" orderby="title" order="ASC" ]
[ newssync layout="split-hero" accent_color="#3b82f6" interval="8" ]
[ newssync layout="split-hero" accent_color="#f59e0b" heading="Latest News" ]
[ newssync layout="split-hero" show_date="no" show_source="no" ]
[ newssync keyword_filter="AI,crypto,blockchain" ]
[ newssync layout="grid" category="Finance" keyword_filter="fed,interest rate,inflation" ]
[ newssync layout="split-hero" keyword_filter="AI,machine learning|crypto,blockchain,token" ]

The last example uses AND-groups (pipe separator): articles must mention AI or machine learning AND also crypto, blockchain or token. For full syntax and more examples, see the Advanced Filtering section below.

Shortcode: [ newssync_best ] ⭐ PRO

Displays the most recently imported posts from the past 24 hours. Works only when “Save as Posts” is enabled in NewsSync → Settings. The post list is cached and refreshed automatically every day at midnight.

[ newssync_best max="5" layout="list" ]

Attribute	Default	Description
`max`	`5`	Number of posts to show (1–20).
`layout`	`list`	Display mode: list, grid, split-hero, masonry, magazine, ticker.
`columns`	`3`	Columns when layout=grid (1–6).
`title`	(none)	Optional heading displayed above the list/grid layout.
`badge`	(none)	Label shown as a vibrant pill above the layout (e.g. “🔥 Best of the Day”).
`badge_color`	`#e11d48`	Background color of the badge (any valid CSS color or hex code).
`show_image`	`1`	Show post thumbnail. Set to 0 to hide.
`show_date`	`1`	Show the publication date. Set to 0 to hide.
`show_excerpt`	`1`	Show a short excerpt. Set to 0 to hide.
`category`	`0`	Filter by WordPress category ID. 0 shows all categories.
`heading`	(none)	Heading shown inside the PRO layout panel (split-hero, masonry, magazine, ticker).
`heading_align`	`left`	Heading alignment: left, center, right.
`heading_size`	`14`	Heading font size in px (used in PRO layouts).
`heading_bg`	(none)	Background color for the heading bar in PRO layouts.
`accent_color`	(none)	Accent color for PRO layouts (numbers, borders, overlays).
`slideshow`	`no`	Auto-advance items: yes or no (split-hero, magazine).
`interval`	`5`	Auto-advance interval in seconds (split-hero, magazine).
`speed`	`80`	Scroll speed for the ticker layout (px/s).

Examples:

[ newssync_best max="10" layout="grid" columns="3" title="Today's News" ]
[ newssync_best max="5" category="7" show_image="0" ]
[ newssync_best max="8" layout="split-hero" badge="🔥 Best of the Day" badge_color="#e11d48" heading="Top Stories" accent_color="#e11d48" ]
[ newssync_best max="6" layout="masonry" badge="✨ Editor's Picks" badge_color="#7c3aed" ]
[ newssync_best max="8" layout="magazine" badge="📰 Today's Edition" badge_color="#0f766e" slideshow="yes" interval="6" ]
[ newssync_best max="10" layout="ticker" badge="🔴 Live Updates" badge_color="#dc2626" speed="60" ]

Note: This shortcode reads from WordPress posts imported with “Save as Posts”. Live feed items not saved as posts will not appear here.

PRO Layout: split-hero ⭐ PRO

A CoinTelegraph-style layout: large featured image on the left, numbered article list on the right. Clicking an item fades the image and updates the overlay. Auto-advances every N seconds and pauses on hover.

[ newssync layout="split-hero" ]

Customisation attributes

Attribute	Default	Description
`accent_color`	`#e11d48`	Accent colour for the active border, badge, progress bar and item numbers. Any hex colour value.
`interval`	`5`	Seconds between automatic article advances (1–60). A progress bar fills over this duration.
`heading`	(none)	Optional title shown inside the right panel, above the article list. Accepts any plain text.
`heading_align`	`left`	Heading text alignment. Accepted values: left, center, right.
`heading_size`	`14`	Heading font size in pixels (10–60). Example: `heading_size="18"`.
`heading_bg`	(none)	Background colour for the heading bar. Any hex value, e.g. `heading_bg="#f1f5f9"`.
`show_source`	`yes`	Show/hide the source/category badge. Set to “no” to hide.
`show_date`	`yes`	Show/hide the publication date. Set to “no” to hide.
`limit`	`6`	Number of articles in the list. Uses the hero cap from General settings when not specified.

Exemplos

[ newssync layout="split-hero" interval="8" limit="5" ]
[ newssync layout="split-hero" accent_color="#3b82f6" interval="10" ]
[ newssync layout="split-hero" heading="Latest News" show_source="no" ]
[ newssync layout="split-hero" heading="Breaking" heading_align="center" heading_size="18" heading_bg="#f1f5f9" ]
[ newssync layout="split-hero" show_date="no" show_source="no" ]

Behaviour notes

Hovering the widget pauses the auto-advance. Moving the mouse away resumes it.
Clicking an item in the list immediately activates it and resets the timer.
Prev / Next arrows appear in the bottom-right corner of the image panel for manual navigation.
Double-clicking a list item opens the article in a new tab.
Multiple split-hero shortcodes on the same page work independently.
The accent_color accepts hex values with or without the # sign (e.g. #e11d48 ou e11d48).

PRO Layout: ticker ⭐ PRO

A horizontal scrolling headline strip, similar to the tickers seen on financial and crypto news sites. Headlines scroll continuously from right to left and pause when the visitor hovers the strip.

[ newssync layout="ticker" ]

Customisation attributes

Attribute	Default	Description
`speed`	`80`	Scroll speed in pixels per second (10–500). Higher = faster. Default 80 is comfortable for reading.
`label`	`NEWS`	Text shown in the coloured badge on the left. Set to empty to hide: `label=""`.
`accent_color`	`#e11d48`	Colour of the label badge and separators. Any hex colour.
`limit`	(from settings)	Number of headlines in the strip. More headlines = longer before looping.

Exemplos

[ newssync layout="ticker" speed="60" label="BREAKING" ]
[ newssync layout="ticker" accent_color="#f59e0b" label="CRYPTO" speed="100" ]
[ newssync layout="ticker" label="" speed="50" ]

PRO Layout: masonry ⭐ PRO

A Pinterest-style multi-column grid where cards have variable heights. Images appear at their natural aspect ratio and excerpts expand as needed, giving each card a unique size for an editorial look.

[ newssync layout="masonry" ]

Attributes

Attribute	Default	Description
`columns`	`3`	Number of columns (1–4). Automatically collapses to fewer on smaller screens.
`limit`	(from settings)	Total number of articles to display.
`show_excerpt`	`yes`	Show article excerpt below the title.
`show_image`	`1`	Show thumbnail. 1 = yes, 0 = no.
`show_date`	`yes`	Show publication date below the title.
`show_source`	`yes`	Show or hide the source/category label above the title.

Exemplos

[ newssync layout="masonry" columns="3" limit="12" ]
[ newssync layout="masonry" columns="2" show_excerpt="no" ]
[ newssync layout="masonry" show_source="no" show_date="no" ]

PRO Layout: magazine ⭐ PRO

Classic newspaper front-page layout: 1 large featured article on the left with a full image and overlay text, and up to 4 smaller articles stacked on the right. Fully responsive — stacks vertically on mobile.

[ newssync layout="magazine" ]

Attributes

Attribute	Default	Description
`slideshow`	`no`	Set to “yes” to enable dynamic mode: clicking a side article promotes it to featured, and the widget auto-cycles through all articles.
`interval`	`6`	Auto-cycle interval in seconds when `slideshow="yes"` (1–60).
`show_source`	`yes`	Show/hide the source/category badge on both the featured and side articles.
`show_date`	`yes`	Show/hide the publication date on featured and side articles.
`limit`	`5`	Total articles to fetch. Only first 5 used (1 featured + 4 side). Recommended value: 5.

Notes

The first article always becomes the large featured piece. The order can be changed with orderby="title" ou orderby="date" order="ASC".
Only the first 5 articles are used (1 featured + 4 side). Fetches up to 6 and silently ignores any extra.
In slideshow mode, hovering the widget pauses the auto-cycle. Each side article becomes clickable to promote it to featured without opening the link.
In static mode (default), clicking an article opens it directly in a new tab.

Exemplos

[ newssync layout="magazine" ]
[ newssync layout="magazine" slideshow="yes" interval="8" ]
[ newssync layout="magazine" show_source="no" show_date="no" ]
[ newssync layout="magazine" slideshow="yes" orderby="date" ]

Features & Settings

AI Summaries

When enabled, each imported article is sent to your chosen AI provider to generate a short summary. The summary replaces the default excerpt stored in WordPress.

OpenAI — Uses the OpenAI Chat Completions API. Requires an API key from platform.openai.com. Recommended models: gpt-4o-mini (fast, cheap) or gpt-4o.
GitHub Copilot — Uses the GitHub Models API (preview). Requires a GitHub Personal Access Token with the Models permission. Free quota available for testing.
OpenRouter — Access 100+ AI models through a single API. Requires an API key from openrouter.ai. Useful for cost comparison or model diversity.

Tip: use the “Test Connection” button to verify your key before importing articles.

Full-Text Extraction

Most RSS feeds provide only a short teaser. When Full-Text Extraction is enabled, NewsSync PRO fetches the full article page and extracts the main body text before saving it to WordPress.

Min Content Length — If the extracted text is shorter than this (in characters), the plugin falls back to the original feed excerpt. Prevents saving nearly-empty articles.
Source Attribution — Appends a “Read original article” link at the end of the extracted content, credited to the source domain.

Note: Full-text extraction runs before AI Summaries so the AI receives the full body, not just the teaser.

Advanced Filtering ⭐ PRO

Keyword filtering lets you control which articles are displayed, without changing what is stored in WordPress. Filtering is applied at render time — articles that do not match are simply hidden from the page, never deleted.

Global settings (Advanced Filtering tab)

Enable filtering and configure your rules once in the Advanced Filtering tab. The rules apply to every shortcode on every page.

Enable Filtering — Master switch. When off, all articles are shown regardless of the keyword rules below.
Include Keywords — Only articles matching at least one keyword are shown. Leave empty to show all articles.
Exclude Keywords — Articles matching any exclude keyword are always hidden, even if they also match the include list. Useful for blocking sponsored content or low-quality sources.
Search Scope — Choose whether keywords are matched against the title only, or also against the article excerpt/body.
Case-Sensitive — By default matching is case-insensitive. Enable this option when you need exact capitalisation (e.g. a company acronym like “BBC” vs “bbc”).

Keywords are comma-separated. Example: bitcoin, ethereum, crypto

Filtering order

When both Include and Exclude keywords are set, Exclude is checked first. An article is hidden as soon as it matches any exclude keyword, even if it would also have matched an include keyword.

Shortcode attribute: `keyword_filter` ⭐ PRO

The keyword_filter attribute on [ newssync ] lets you filter articles per-shortcode — independently of the global settings above. Works even when global filtering is disabled. The filter is always case-insensitive and searches the article title and excerpt.

Mode 1 — OR (any keyword)

Separate keywords with commas. An article is shown if it contains at least one of the keywords.

[ newssync keyword_filter="AI,crypto,blockchain" ]

Shows articles about AI, or crypto, or blockchain — independently of each other. One match is enough.

Mode 2 — AND groups (topic intersection)

Separate keyword groups with the pipe character |. An article must satisfy ALL groups to appear. Within each group, OR logic applies. Use this to show only articles where two different topics are discussed together.

[ newssync keyword_filter="Group1_kw1,Group1_kw2|Group2_kw1,Group2_kw2" ]

Practical example — AI meets Crypto

Show only articles where AI and Crypto topics appear together:

[ newssync keyword_filter="AI,robotics,machine learning,artificial intelligence|crypto,blockchain,token,Web3,DeFi" ]

Group 1 — AI topic: AI, robotics, machine learning, artificial intelligence
Group 2 — Crypto topic: crypto, blockchain, token, Web3, DeFi
An article must match at least one word from Group 1 AND at least one word from Group 2.

Results:

✔ “How AI is changing crypto trading” — AI (group 1) + crypto (group 2)
✔ “AI tokens to watch in 2026” — AI (group 1) + token (group 2)
✔ “Robotics companies on the blockchain: real opportunity?” — robotics (group 1) + blockchain (group 2)
✘ “Bitcoin hits new all-time high” — only group 2 matched, excluded
✘ “GPT-5 released by OpenAI” — only group 1 matched, excluded

More examples

[ newssync layout="grid" keyword_filter="oil,gas,energy" ]

Energy news — any article mentioning oil, gas or energy.

[ newssync layout="list" category="Finance" keyword_filter="fed,interest rate,inflation" ]

Finance category articles about the Fed, interest rates or inflation.

[ newssync layout="ticker" keyword_filter="bitcoin,crypto,blockchain" limit="20" ]

Crypto-only scrolling ticker with up to 20 headlines.

[ newssync layout="split-hero" keyword_filter="AI,machine learning|stock,market,equity,ETF" ]

Split-hero showing only articles where AI intersects with financial markets.

Notes

Matching is always case-insensitive — “AI”, “ai” and “Ai” all work the same way.
Works with any layout: grid, list, carousel, hero, minimal, split-hero, ticker, masonry, magazine.
Can be combined freely with category, limit, offset and all other attributes.
When no articles match, the shortcode renders empty — no error is shown.
The pipe | syntax supports any number of groups — not just two.

Content Cleanup

The Content Cleanup tab lets you strip unwanted HTML from imported post content before it is saved to the database. Settings take effect on the next import run.

Remove script tags — Strips all inline JavaScript blocks. Recommended for security and to avoid breaking your theme.
Remove iframe tags — Removes embedded frames (ad iframes, tracking pixels, etc.) from the feed content.
Remove inline styles — Strips style="" attributes so the post inherits your theme’s typography and colours instead of the source site’s.
Append source link — Adds a “Source:” line at the bottom of each imported post pointing back to the original article.

Webhook Import Trigger

The Webhook gives you a secret URL that triggers a full news import the moment it is visited — from a browser, a script, or any automation tool. Think of it as a hidden “Refresh news now” button on the internet. Only you know the address, so only you can trigger it.

How to set it up

Go to General → Webhook section.
Click “Generate token”. A secret URL appears — copy it.
Save that URL somewhere safe (bookmarks, notes app, script).
Whenever you open that URL in a browser or call it from a script, all your feeds are imported immediately.

What the response means

After calling the URL, you will always get a JSON response in the browser:

{"success":true,"data":{"status":"ok","message":"Import triggered successfully.","result":5}}

“result”: 5 — 5 new articles were found and imported into WordPress.
“result”: 0 — Import ran successfully, but there were no new articles since the last run. This is normal.
“status”: “skipped” — Import was skipped because another one ran less than 60 seconds ago. Wait a moment and try again.

Practical examples

1. Quick refresh from your phone

Save the webhook URL as a shortcut on your phone’s home screen. Tap it whenever you want the latest news imported — no need to open the WordPress admin.

2. Scheduled import with a server cron job (Linux)

Run this in your terminal to import news every 15 minutes automatically:

*/15 * * * * curl -s "https://your-site.com/?newssync_webhook=YOUR_TOKEN" > /dev/null

3. Scheduled import with Windows Task Scheduler

Create a task that runs this PowerShell command every hour:

Invoke-WebRequest -Uri "https://your-site.com/?newssync_webhook=YOUR_TOKEN" -UseBasicParsing

4. Zapier / Make.com automation

In Zapier, add a “Webhooks by Zapier” step with Method: GET and your webhook URL. Trigger it from any event — a new tweet, a Google Sheets update, a calendar entry, etc.

5. GitHub Actions (import after a deploy)

Add this step to your workflow file to refresh news every time you deploy your site:

- name: Trigger NewsSync import
  run: curl -s "${{ secrets.NEWSSYNC_WEBHOOK_URL }}"

Security notes

The token is 128-bit random — it cannot be guessed by brute-force.
The comparison is timing-safe (hash_equals), preventing timing attacks.
The endpoint is rate-limited to 1 run per 60 seconds to prevent abuse.
Treat the URL like a password — do not share it publicly or commit it to a public repository.
If you suspect the token has been leaked, click “Regenerate token” in General → Webhook to invalidate the old URL immediately.

Feed Health Monitor

The Feed Health Monitor automatically detects when a configured feed URL stops responding or returns an HTTP error. It watches every real HTTP request made during scheduled imports, so no extra fetch is triggered — zero performance overhead.

How it works

When WordPress fetches a feed (cache miss or forced refresh), the monitor checks the HTTP response status.
A status code ≥ 400 or a connection error counts as one consecutive failure for that feed.
A successful response (status 2xx/3xx) resets the consecutive failure counter to zero.
Once the failure count reaches the configured threshold (default: 3), an alert e-mail is sent to the configured address.
Alert e-mails have a 24-hour per-feed cooldown — you will not be spammed for the same failing feed.

Status indicators

Badge	Meaning
Healthy	Zero consecutive failures — feed is responding normally.
Warning	Some consecutive failures but below the alert threshold — may be temporary.
Critical	Consecutive failures reached the threshold — an alert e-mail was sent.

Configuration

Enable Health Monitor — Toggle monitoring on or off without losing existing health data.
Alert after N consecutive failures — How many consecutive HTTP failures trigger an e-mail. Default: 3. Range: 1–20.
Alert e-mail address — Recipient for alert e-mails. Defaults to the WordPress admin e-mail.

Notes

Health data is only collected when a feed’s cache is cold (cache miss or manual cache clear). A feed served from transient cache does not generate a new data point.
The “Clear” button in the Health tab resets the consecutive failure counter and removes the alert cooldown for a single feed.
“Reset All Health Data” clears every counter and cooldown — useful after fixing a batch of broken feeds.
HTTP 301/302 redirects are followed by WordPress before the health check — only the final response code is evaluated.

Daily Briefing ⭐ PRO

The Daily Briefing feature uses AI to turn today’s imported posts into a concise, newsletter-style article — 4 to 6 topic sections, each with short paragraphs and inline links back to the original sources. It also provides a teaser ticker strip that scrolls a bold “DAILY BRIEFING” call-to-action, drawing visitors to your briefing page.

Requirements

“Save as Posts” must be enabled in NewsSync → Settings (General tab).
“Enable AI Summaries” must be ON in the AI tab.
At least one AI provider key must be configured (OpenAI, GitHub Copilot, or OpenRouter).
Posts must have been imported in the last 24 hours — the briefing is built from today’s content.

Quick setup

Go to the AI tab and scroll to the Daily Briefing section.
Toggle “Enable Daily Briefing” ON and set your Site Name, Topics and Briefing Page URL.
Save settings, then click “Generate Now” to create the first briefing immediately.
Create a WordPress page (e.g. “/daily-briefing”) and place [ newssync_daily_briefing ] in its content.
On any other page or in a widget, place [ newssync_briefing_ticker link="/daily-briefing" ] to show the teaser strip.

Shortcode: [ newssync_briefing_ticker ]

A dark scrolling bar that repeats a bold “DAILY BRIEFING” text (no article titles) to tease visitors into clicking. Uses the same ticker engine as [ newssync layout="ticker" ].

[ newssync_briefing_ticker link="/daily-briefing" accent_color="#e11d48" ]

Attribute	Default	Description
`link`	(from settings)	URL of your Daily Briefing page. Falls back to the URL saved in AI settings. Example: `link="/daily-briefing"`.
`text`	`DAILY BRIEFING`	The repeating label text. Always uppercased automatically.
`separator`	`——`	Visual separator between each repetition of the text.
`label`	(today’s date)	Left badge text. Defaults to the current date in abbreviated format (“APR 17”). Set to `label=""` to hide.
`accent_color`	`#e11d48`	Badge and separator accent colour. Any hex value.
`speed`	`55`	Scroll speed in px/s (10–500). Slightly slower than the news ticker for emphasis.
`repeats`	`10`	Number of times the text is repeated inside the track before cloning (4–30). More repeats = longer strip before looping.

Examples:

[ newssync_briefing_ticker link="/daily-briefing" ]
[ newssync_briefing_ticker link="/daily-briefing" accent_color="#0ea5e9" speed="40" ]
[ newssync_briefing_ticker text="MORNING BRIEFING" separator="•" label="APR 17" ]

Shortcode: [ newssync_daily_briefing ]

Renders the AI-generated briefing as a styled newsletter block. Place it on your dedicated Daily Briefing page. No attributes needed.

[ newssync_daily_briefing ]

The output looks like a broadcast newsletter: a header with your site name and generation time, an intro paragraph, then 4–6 bold headlines each followed by 1–2 short paragraphs. Every paragraph ends with a linked source name that opens the original article in a new tab.

AI tab settings

Setting	Description
Enable Daily Briefing	Master switch. When OFF the shortcodes render nothing (admins see a hint message).
Site Name	Shown in the briefing header and injected into the AI system prompt (e.g. “Welcome to DaazPrime”).
Briefing Page URL	The page where `[ newssync_daily_briefing ]` is placed. The ticker strip links here automatically when no `link` attribute is specified.
Topics to Cover	Comma-separated list of topics the AI will include as separate sections. Example: “Global Markets, Crypto, AI & Robotics, Investments”. The AI tries to match each topic to the day’s articles.
Custom System Prompt	Advanced: overrides the default AI instruction with your own. Leave blank to use the built-in prompt. Useful if you want a specific tone or language.
Generate Now	Triggers an immediate generation from today’s imported posts. Use this to test or regenerate after a batch import. Shows the timestamp of the last successful generation.

How AI generation works

Collects the 30 most recent NewsSync-imported posts from the last 24 hours.
Builds a numbered article list with title, source name, category, original URL and excerpt.
Sends the list to the active AI provider with a structured JSON schema prompt.
AI returns a JSON object with an intro paragraph and 4–6 sections, each with bold headline + short paragraphs + source links.
The JSON is parsed, all values are escaped, and the result is stored as HTML in a WordPress transient for 25 hours.
[ newssync_daily_briefing ] reads the stored HTML and renders it — no live AI call happens on the front end.

Automation

When Daily Briefing is enabled, a WP-Cron event is scheduled to run automatically every day at 00:30 (site time) — 30 minutes after midnight, so the day’s best posts are already imported. No manual action needed after the first setup.

To force regeneration at any time (e.g. after a large import batch), use the “Generate Now” button in the AI tab.

Recommended page setup

Create a dedicated WordPress page (e.g. slug: “daily-briefing”) and place only the shortcode in its body:

[ newssync_daily_briefing ]

On your homepage, news archive, or in a sticky header widget, place the ticker to attract visitors:

[ newssync_briefing_ticker link="/daily-briefing" accent_color="#e11d48" ]

Notes

The briefing is visible to all visitors. It contains no private data — only AI-generated text derived from public news articles.

If no posts are found for today, generation is skipped and a message is logged in the Debug Log tab.

The briefing is generated once per day. Clicking “Generate Now” always overwrites the previous result.

Only the active AI provider and model from AI Summaries settings are used — no extra configuration needed.

Source links always point to the original article URL stored in the post metadata, not to any page on your site.

Multiple [ newssync_briefing_ticker ] shortcodes can appear on the same page — each runs independently.

RSS NewsSync – Complete Documentation

1. Basic Shortcode

2. Main Parameters (work in ALL layouts)

3. List Mode (only when layout=”list”)

4. CUSTOM MODE – Full Control

All available parameters:

5. Complete Examples

Example 1: Grid with 6 items

Example 2: Carousel with autoplay

Example 3: List with specific source

Example 4: Ultra-compact sidebar

Example 5: Custom list without images

Example 6: Hero banner

Example 7: Using imported posts

6. Layout Comparison

NewsSync PRO — Documentation

Shortcodes

Getting Started

General Settings

Shortcode: [ newssync ]

Layout & items

Display controls

PRO-exclusive attributes ⭐ PRO

Exemplos

Shortcode: [ newssync_best ] ⭐ PRO

PRO Layout: split-hero ⭐ PRO

Customisation attributes

Exemplos

Behaviour notes

PRO Layout: ticker ⭐ PRO

Customisation attributes

Exemplos

PRO Layout: masonry ⭐ PRO

Attributes

Exemplos

PRO Layout: magazine ⭐ PRO

Attributes

Notes

Exemplos

Features & Settings

AI Summaries

Full-Text Extraction

Advanced Filtering ⭐ PRO

Global settings (Advanced Filtering tab)

Filtering order

Shortcode attribute: keyword_filter ⭐ PRO

Mode 1 — OR (any keyword)

Mode 2 — AND groups (topic intersection)

Practical example — AI meets Crypto

More examples

Notes

Content Cleanup

Webhook Import Trigger

How to set it up

What the response means

Practical examples

Security notes

Feed Health Monitor

How it works

Status indicators

Configuration

Notes

Daily Briefing ⭐ PRO

Requirements

Quick setup

Shortcode: [ newssync_briefing_ticker ]

Shortcode: [ newssync_daily_briefing ]

AI tab settings

How AI generation works

Automation

Recommended page setup

Notes

Shortcode attribute: `keyword_filter` ⭐ PRO