{"id":2869,"date":"2026-02-06T17:51:04","date_gmt":"2026-02-06T17:51:04","guid":{"rendered":"https:\/\/daazlabs.com\/?page_id=2869"},"modified":"2026-05-04T07:21:13","modified_gmt":"2026-05-04T07:21:13","slug":"newssync-installation","status":"publish","type":"page","link":"https:\/\/daazlabs.com\/pt\/newssync-installation\/","title":{"rendered":"NewsSync Installation"},"content":{"rendered":"\n<div style=\"height:40px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h1 class=\"wp-block-heading\" id=\"newssync-installation-setup-guide\">NewsSync Installation &amp; Setup Guide<\/h1>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"-welcome-\">\ud83c\udfaf Welcome!<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">This guide will help you install and configure NewsSync (FREE version) on your WordPress site. Whether you&#8217;re a beginner or experienced developer, we&#8217;ve got you covered.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>What you&#8217;ll learn:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\u2705 Basic plugin installation<\/li>\n\n\n\n<li>\u2705 First feed setup (5 minutes)<\/li>\n\n\n\n<li>\u2705 Optional performance optimization (for large sites)<\/li>\n\n\n\n<li>\u2705 Troubleshooting common issues<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"-installation-3-methods-\">\ud83d\udce6 Installation (3 Methods)<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"method-1-wordpress-admin-easiest-\">Method 1: WordPress Admin (Easiest) \u2b50<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Step-by-step:<\/strong><\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Go to&nbsp;<strong>WordPress Admin \u2192 Plugins \u2192 Add New<\/strong><\/li>\n\n\n\n<li>Search for&nbsp;<strong>&#8220;RSS NewsSync&#8221;<\/strong> ou &#8220;<strong>DaazSync &#8211; RSS News Aggregator<\/strong>&#8220;<\/li>\n\n\n\n<li>Click&nbsp;<strong>&#8220;Install Now&#8221;<\/strong>&nbsp;\u2192&nbsp;<strong>&#8220;Activate&#8221;<\/strong><\/li>\n\n\n\n<li>\u2705 Done! Plugin is ready to use<\/li>\n<\/ol>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"method-2-upload-zip-file\">Method 2: Upload ZIP File<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>When to use:<\/strong>&nbsp;Downloaded plugin from WordPress.org or received custom version.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Step-by-step:<\/strong><\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Download plugin ZIP file from&nbsp;<a href=\"https:\/\/wordpress.org\/plugins\/rss-newssync\/\" target=\"_blank\" rel=\"noopener\">WordPress.org<\/a><\/li>\n\n\n\n<li>Go to&nbsp;<strong>WordPress Admin \u2192 Plugins \u2192 Add New \u2192 Upload Plugin<\/strong><\/li>\n\n\n\n<li>Click&nbsp;<strong>&#8220;Choose File&#8221;<\/strong>&nbsp;\u2192 Select ZIP<\/li>\n\n\n\n<li>Click&nbsp;<strong>&#8220;Install Now&#8221;<\/strong>&nbsp;\u2192&nbsp;<strong>&#8220;Activate&#8221;<\/strong><\/li>\n\n\n\n<li>\u2705 Done!<\/li>\n<\/ol>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"method-3-ftp-sftp-manual-\">Method 3: FTP\/SFTP (Manual)<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>When to use:<\/strong>&nbsp;Prefer manual installation, troubleshooting install issues.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Step-by-step:<\/strong><\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Download and extract plugin ZIP<\/li>\n\n\n\n<li>Connect to your site via FTP\/SFTP<\/li>\n\n\n\n<li>Upload&nbsp;<code>newssync<\/code>&nbsp;folder to&nbsp;<code>\/wp-content\/plugins\/<\/code><\/li>\n\n\n\n<li>Go to&nbsp;<strong>WordPress Admin \u2192 Plugins<\/strong><\/li>\n\n\n\n<li>Find &#8220;RSS NewsSync&#8221; and click&nbsp;<strong>&#8220;Activate&#8221;<\/strong><\/li>\n\n\n\n<li>\u2705 Done!<\/li>\n<\/ol>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"-quick-start-your-first-feed-5-minutes-\">\ud83d\ude80 Quick Start: Your First Feed (5 minutes)<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"step-1-add-a-shortcode-to-any-page-post\">Step 1: Add a shortcode to any page\/post<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Easy method (Gutenberg block editor):<\/strong><\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Create or edit a page\/post<\/li>\n\n\n\n<li>Add a&nbsp;<strong>Shortcode block<\/strong><\/li>\n\n\n\n<li>Paste this example: <code>[ newssync feed_url=\"https:\/\/techcrunch.com\/feed\/\" ]<\/code> <\/li>\n\n\n\n<li>Click&nbsp;<strong>&#8220;Publish&#8221;<\/strong>&nbsp;or&nbsp;<strong>&#8220;Update&#8221;<\/strong><\/li>\n\n\n\n<li>View the page \u2192 You should see TechCrunch articles! \u2705<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Alternative feeds to try:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>BBC News:<\/strong>&nbsp;<code>https:\/\/feeds.bbci.co.uk\/news\/rss.xml<\/code><\/li>\n\n\n\n<li><strong>The Verge:<\/strong>&nbsp;<code>https:\/\/www.theverge.com\/rss\/index.xml<\/code><\/li>\n\n\n\n<li><strong>WordPress News:<\/strong>&nbsp;<code>https:\/\/wordpress.org\/news\/feed\/<\/code><\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"step-2-customize-your-feed-display\">Step 2: Customize your feed display<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Basic customization options:<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>&#91;newssync\n  feed_url=\"https:\/\/techcrunch.com\/feed\/\"\n  posts_per_page=\"5\"\n  show_excerpt=\"yes\"\n  show_date=\"yes\"\n  layout=\"grid\"\n]\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>What each option does:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>posts_per_page=\"5\"<\/code>&nbsp;\u2014 Show 5 items (default: 10)<\/li>\n\n\n\n<li><code>show_excerpt=\"yes\"<\/code>&nbsp;\u2014 Display article excerpt<\/li>\n\n\n\n<li><code>show_date=\"yes\"<\/code>&nbsp;\u2014 Show publication date<\/li>\n\n\n\n<li><code>layout=\"grid\"<\/code>&nbsp;\u2014 Grid layout (options: grid, list, minimal)<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\ud83d\udcd6 Full shortcode reference:<\/strong>&nbsp;See&nbsp;<a href=\"https:\/\/daazlabs.com\/newssync\/docs\/shortcodes\/\">Shortcode Documentation<\/a><\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"-settings-configuration\">\u2699\ufe0f Settings &amp; Configuration<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"global-settings\">Global Settings<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Go to&nbsp;<strong>WordPress Admin \u2192 Settings \u2192 NewsSync<\/strong>&nbsp;to configure:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Display Options:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Default layout<\/strong>&nbsp;\u2014 Grid, List, or Minimal<\/li>\n\n\n\n<li><strong>Excerpt length<\/strong>&nbsp;\u2014 Number of words (default: 150)<\/li>\n\n\n\n<li><strong>Date format<\/strong>&nbsp;\u2014 How dates are displayed<\/li>\n\n\n\n<li><strong>Cache duration<\/strong>&nbsp;\u2014 How long feeds are cached (default: 1 hour)<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Content Options:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Open links in new tab<\/strong>&nbsp;\u2014 Yes\/No<\/li>\n\n\n\n<li><strong>Show featured images<\/strong>&nbsp;\u2014 Yes\/No<\/li>\n\n\n\n<li><strong>Default thumbnail<\/strong>&nbsp;\u2014 Fallback image for items without images<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Advanced Options:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Debug mode<\/strong>&nbsp;\u2014 Enable detailed logging (for troubleshooting)<\/li>\n\n\n\n<li><strong>Force refresh<\/strong>&nbsp;\u2014 Clear all feed caches<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"-performance-optimization-optional-\">\ud83d\udd27 Performance Optimization (Optional)<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"-do-i-need-this-\">\ud83e\udd14 Do I Need This?<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The plugin works great&nbsp;<strong>out of the box<\/strong>&nbsp;for most sites. Consider optimization if:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\u2705 You import&nbsp;<strong>100+ feed items per day<\/strong><\/li>\n\n\n\n<li>\u2705 Your site has&nbsp;<strong>high traffic<\/strong>&nbsp;(10,000+ visits\/day)<\/li>\n\n\n\n<li>\u2705 You notice&nbsp;<strong>slow page loads<\/strong>&nbsp;when displaying feeds<\/li>\n\n\n\n<li>\u2705 You have&nbsp;<strong>multiple feeds<\/strong>&nbsp;(5+ different sources)<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>If you&#8217;re just starting:<\/strong>&nbsp;\ud83d\udc49&nbsp;<strong>Skip this section!<\/strong>&nbsp;Come back later if needed.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"-performance-indexed-database-table\">\u26a1 Performance: Indexed Database Table<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">By default, NewsSync uses WordPress&nbsp;<code>postmeta<\/code>&nbsp;to track imported items. For large sites, an&nbsp;<strong>indexed database table<\/strong>&nbsp;is much faster.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Benefits:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\ud83d\ude80&nbsp;<strong>10-100x faster<\/strong>&nbsp;duplicate detection (large datasets)<\/li>\n\n\n\n<li>\ud83d\ude80&nbsp;<strong>Reduced memory usage<\/strong>&nbsp;(less overhead)<\/li>\n\n\n\n<li>\ud83d\ude80&nbsp;<strong>Better scalability<\/strong>&nbsp;(handles 10,000+ items easily)<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>When it matters:<\/strong><\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Site Size<\/th><th>Postmeta (default)<\/th><th>Indexed Table<\/th><\/tr><\/thead><tbody><tr><td><strong>&lt; 100 items<\/strong><\/td><td>\u2705 Fast (&lt; 0.1s)<\/td><td>\u2705 Fast (&lt; 0.01s) \u2014 Overkill<\/td><\/tr><tr><td><strong>100-1000 items<\/strong><\/td><td>\u26a0\ufe0f OK (0.5-1s)<\/td><td>\u2705 Fast (&lt; 0.1s) \u2014 Recommended<\/td><\/tr><tr><td><strong>1000+ items<\/strong><\/td><td>\u274c Slow (2-5s)<\/td><td>\u2705 Fast (&lt; 0.2s) \u2014&nbsp;<strong>Essential<\/strong><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"-creating-the-database-table\">\ud83d\udee0\ufe0f Creating the Database Table<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"option-a-automatic-plugin-admin-recommended-\">Option A: Automatic (Plugin Admin) \u2b50&nbsp;<strong>Recommended<\/strong><\/h4>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Coming in v1.1:<\/strong>&nbsp;Auto-create button in Settings.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Current workaround:<\/strong>&nbsp;Use Option B or C below.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"option-b-wp-cli-developers-ssh-access-\">Option B: WP-CLI (Developers\/SSH Access)<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Requirements:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>SSH access to your server<\/li>\n\n\n\n<li>WP-CLI installed (<a href=\"https:\/\/wp-cli.org\/\" target=\"_blank\" rel=\"noopener\">Installation guide<\/a>)<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Commands:<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code># Navigate to your WordPress root\ncd \/var\/www\/html\/your-site\n\n# Activate plugin (if not already)\nwp plugin activate rss-newssync\n\n# Create the database table\nwp eval 'newssync_create_item_map_table();'\n\n# Verify table exists (replace wp_ with your prefix)\nwp db query \"SHOW TABLES LIKE 'wp_newssync_item_map';\"\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Expected output:<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>+--------------------------------+\n| Tables_in_database (wp_newssync_item_map) |\n+--------------------------------+\n| wp_newssync_item_map           |\n+--------------------------------+\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\u2705&nbsp;<strong>Success!<\/strong>&nbsp;Table created.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"option-c-manual-sql-no-ssh-access-\">Option C: Manual SQL (No SSH Access)<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Requirements:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Access to phpMyAdmin or similar database tool<\/li>\n\n\n\n<li>Your WordPress database name and table prefix (usually&nbsp;<code>wp_<\/code>)<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Step-by-step:<\/strong><\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Login to phpMyAdmin<\/strong>&nbsp;(usually via hosting control panel)<\/li>\n\n\n\n<li><strong>Select your WordPress database<\/strong>&nbsp;(left sidebar)<\/li>\n\n\n\n<li><strong>Click &#8220;SQL&#8221; tab<\/strong>&nbsp;(top menu)<\/li>\n\n\n\n<li><strong>Paste this SQL<\/strong>&nbsp;(replace&nbsp;<code>wp_<\/code>&nbsp;with your table prefix):<\/li>\n<\/ol>\n\n\n\n<pre class=\"wp-block-code\"><code>CREATE TABLE IF NOT EXISTS `wp_newssync_item_map` (\n  `id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,\n  `guid` VARCHAR(191) NOT NULL,\n  `post_id` BIGINT UNSIGNED NOT NULL,\n  `feed_slug` VARCHAR(128) NULL,\n  `created_at` DATETIME DEFAULT CURRENT_TIMESTAMP,\n  PRIMARY KEY (`id`),\n  UNIQUE KEY `guid` (`guid`),\n  KEY `post_id` (`post_id`)\n) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;\n<\/code><\/pre>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Click &#8220;Go&#8221;<\/strong>&nbsp;(bottom right)<\/li>\n\n\n\n<li><strong>Verify:<\/strong>&nbsp;Look for &#8220;Query OK&#8221; message \u2705<\/li>\n<\/ol>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"-migrating-existing-data-optional-\">\ud83d\udcca Migrating Existing Data (Optional)<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>If you already have imported items:<\/strong>&nbsp;Migrate them to the new table for consistency.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>WP-CLI command:<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>wp newssync migrate-item-map --batch=200\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>What it does:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Reads existing&nbsp;<code>_newssync_guid<\/code>&nbsp;postmeta entries<\/li>\n\n\n\n<li>Copies them to the&nbsp;<code>newssync_item_map<\/code>&nbsp;table<\/li>\n\n\n\n<li>Processes in batches (safer for large datasets)<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Parameters:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>--batch=200<\/code>&nbsp;\u2014 Process 200 items at a time (adjust based on server)<\/li>\n\n\n\n<li><code>--dry-run<\/code>&nbsp;\u2014 Preview changes without writing (test first!)<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Example output:<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>Processing batch 1\/10 (200 items)... Done.\nProcessing batch 2\/10 (200 items)... Done.\n...\nMigration complete: 2000 items migrated.\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\u26a0\ufe0f&nbsp;<strong>Backup first!<\/strong>&nbsp;Always backup your database before migrations.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"-troubleshooting\">\u274c Troubleshooting<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"installation-issues\">Installation Issues<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"-plugin-could-not-be-activated-\">&#8220;Plugin could not be activated&#8221;<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Causes:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>PHP version too old (requires 7.4+)<\/li>\n\n\n\n<li>Missing WordPress requirements<\/li>\n\n\n\n<li>File permissions incorrect<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Fixes:<\/strong><\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>\u2705&nbsp;<strong>Check PHP version:<\/strong>&nbsp;Settings \u2192 Site Health \u2192 Info \u2192 Server\n<ul class=\"wp-block-list\">\n<li>If &lt; 7.4, contact hosting to upgrade<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>\u2705&nbsp;<strong>Check file permissions:<\/strong>&nbsp;Files should be&nbsp;<code>644<\/code>, folders&nbsp;<code>755<\/code><\/li>\n\n\n\n<li>\u2705&nbsp;<strong>Check error log:<\/strong>&nbsp;Enable WP_DEBUG (see below)<\/li>\n<\/ol>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"-upload-failed-or-destination-folder-already-exists-\">&#8220;Upload failed&#8221; or &#8220;Destination folder already exists&#8221;<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Fixes:<\/strong><\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>\u2705&nbsp;<strong>Delete old version:<\/strong>&nbsp;Plugins \u2192 Deactivate \u2192 Delete \u2192 Try again<\/li>\n\n\n\n<li>\u2705&nbsp;<strong>Use FTP method:<\/strong>&nbsp;Upload manually to&nbsp;<code>\/wp-content\/plugins\/<\/code><\/li>\n\n\n\n<li>\u2705&nbsp;<strong>Check disk space:<\/strong>&nbsp;Contact hosting if server full<\/li>\n<\/ol>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"feed-display-issues\">Feed Display Issues<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"feed-shows-no-items-found-\">Feed shows &#8220;No items found&#8221;<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Causes:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Invalid feed URL<\/li>\n\n\n\n<li>Feed is empty\/private<\/li>\n\n\n\n<li>Caching issue<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Fixes:<\/strong><\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>\u2705&nbsp;<strong>Test feed URL:<\/strong>&nbsp;Open in browser (should show XML)<\/li>\n\n\n\n<li>\u2705&nbsp;<strong>Validate feed:<\/strong>&nbsp;Use&nbsp;<a href=\"https:\/\/validator.w3.org\/feed\/\" target=\"_blank\" rel=\"noopener\">W3C Feed Validator<\/a><\/li>\n\n\n\n<li>\u2705&nbsp;<strong>Clear cache:<\/strong>&nbsp;Settings \u2192 NewsSync \u2192 Force Refresh<\/li>\n\n\n\n<li>\u2705&nbsp;<strong>Try different feed:<\/strong>&nbsp;Test with&nbsp;<code>https:\/\/wordpress.org\/news\/feed\/<\/code><\/li>\n<\/ol>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"feed-items-look-broken-unstyled\">Feed items look broken\/unstyled<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Causes:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Theme CSS conflicts<\/li>\n\n\n\n<li>JavaScript errors<\/li>\n\n\n\n<li>Plugin conflict<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Fixes:<\/strong><\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>\u2705&nbsp;<strong>Switch to default theme:<\/strong>&nbsp;Test with Twenty Twenty-Four<\/li>\n\n\n\n<li>\u2705&nbsp;<strong>Disable other plugins:<\/strong>&nbsp;Test with only NewsSync active<\/li>\n\n\n\n<li>\u2705&nbsp;<strong>Check browser console:<\/strong>&nbsp;Look for JavaScript errors (F12)<\/li>\n<\/ol>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"images-not-showing\">Images not showing<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Causes:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Feed doesn&#8217;t include images<\/li>\n\n\n\n<li>Image URLs broken\/expired<\/li>\n\n\n\n<li>Hotlink protection on source site<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Fixes:<\/strong><\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>\u2705&nbsp;<strong>Check feed has images:<\/strong>&nbsp;View feed XML, look for&nbsp;<code>&lt;enclosure&gt;<\/code>&nbsp;or&nbsp;<code>&lt;media:content&gt;<\/code><\/li>\n\n\n\n<li>\u2705&nbsp;<strong>Set default thumbnail:<\/strong>&nbsp;Settings \u2192 NewsSync \u2192 Default Image<\/li>\n\n\n\n<li>\u2705&nbsp;<strong>Upgrade to PRO:<\/strong>&nbsp;Full-text extraction includes article images<\/li>\n<\/ol>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"performance-issues\">Performance Issues<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"-fatal-error-maximum-execution-time-exceeded-\">&#8220;Fatal error: Maximum execution time exceeded&#8221;<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Causes:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Processing too many feed items at once<\/li>\n\n\n\n<li>Slow external feed server<\/li>\n\n\n\n<li>Low PHP timeout limit (default 30 seconds)<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Fixes:<\/strong><\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>\u2705&nbsp;<strong>Reduce items:<\/strong>&nbsp;Set&nbsp;<code>posts_per_page=\"10\"<\/code>&nbsp;(not 100+)<\/li>\n\n\n\n<li>\u2705&nbsp;<strong>Increase timeout:<\/strong>&nbsp;Contact hosting or add to&nbsp;<code>wp-config.php<\/code>:<code>set_time_limit(300); \/\/ 5 minutes<\/code><\/li>\n\n\n\n<li>\u2705&nbsp;<strong>Enable caching:<\/strong>&nbsp;Settings \u2192 Cache Duration = 1 hour minimum<\/li>\n<\/ol>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"-fatal-error-allowed-memory-size-exhausted-\">&#8220;Fatal error: Allowed memory size exhausted&#8221;<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Causes:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Too many items processed<\/li>\n\n\n\n<li>Low PHP memory limit (default 256MB)<\/li>\n\n\n\n<li>Large images in feed<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Fixes:<\/strong><\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>\u2705&nbsp;<strong>Increase memory:<\/strong>&nbsp;Add to&nbsp;<code>wp-config.php<\/code>:<code>define('WP_MEMORY_LIMIT', '512M');<\/code><\/li>\n\n\n\n<li>\u2705&nbsp;<strong>Reduce items:<\/strong>&nbsp;Use smaller&nbsp;<code>posts_per_page<\/code>&nbsp;value<\/li>\n\n\n\n<li>\u2705&nbsp;<strong>Create database table:<\/strong>&nbsp;See Performance Optimization above<\/li>\n<\/ol>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"pages-load-slowly-with-feeds\">Pages load slowly with feeds<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Fixes:<\/strong><\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>\u2705&nbsp;<strong>Enable caching:<\/strong>&nbsp;Settings \u2192 Cache Duration = 1 hour+<\/li>\n\n\n\n<li>\u2705&nbsp;<strong>Use CDN:<\/strong>&nbsp;Cloudflare or similar for images<\/li>\n\n\n\n<li>\u2705&nbsp;<strong>Reduce items:<\/strong>&nbsp;Show 5-10 items, add &#8220;Load More&#8221; button<\/li>\n\n\n\n<li>\u2705&nbsp;<strong>Use lazy loading:<\/strong>&nbsp;Images load as user scrolls<\/li>\n<\/ol>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"database-table-issues\">Database Table Issues<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"-table-creation-failed-\">&#8220;Table creation failed&#8221;<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Causes:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Database user lacks CREATE privileges<\/li>\n\n\n\n<li>Database is full\/quota exceeded<\/li>\n\n\n\n<li>MySQL version too old (requires 5.6+)<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Fixes:<\/strong><\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>\u2705&nbsp;<strong>Check privileges:<\/strong>&nbsp;Contact hosting to grant CREATE permission<\/li>\n\n\n\n<li>\u2705&nbsp;<strong>Use manual SQL:<\/strong>&nbsp;See Option C above (phpMyAdmin)<\/li>\n\n\n\n<li>\u2705&nbsp;<strong>Don&#8217;t worry:<\/strong>&nbsp;Plugin works without table (just slower)<\/li>\n<\/ol>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"-migration-failed-or-timeouts-during-migration\">&#8220;Migration failed&#8221; or timeouts during migration<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Fixes:<\/strong><\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>\u2705&nbsp;<strong>Reduce batch size:<\/strong>&nbsp;<code>--batch=50<\/code>&nbsp;instead of 200<\/li>\n\n\n\n<li>\u2705&nbsp;<strong>Increase timeout:<\/strong>&nbsp;See PHP timeout fixes above<\/li>\n\n\n\n<li>\u2705&nbsp;<strong>Run in chunks:<\/strong>&nbsp;Migrate 500 items, wait, repeat<\/li>\n\n\n\n<li>\u2705&nbsp;<strong>Skip migration:<\/strong>&nbsp;New imports will use table automatically<\/li>\n<\/ol>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"-enabling-debug-mode\">\ud83d\udc1b Enabling Debug Mode<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>When support asks for logs:<\/strong><\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Edit wp-config.php<\/strong>&nbsp;(via FTP or hosting file manager)<\/li>\n\n\n\n<li><strong>Add before&nbsp;<code>\/* That's all, stop editing! *\/<\/code>:<\/strong><code>define('WP_DEBUG', true); define('WP_DEBUG_LOG', true); define('WP_DEBUG_DISPLAY', false);<\/code><\/li>\n\n\n\n<li><strong>Save file<\/strong><\/li>\n\n\n\n<li><strong>Reproduce the issue<\/strong><\/li>\n\n\n\n<li><strong>Get log:<\/strong>&nbsp;Download&nbsp;<code>\/wp-content\/debug.log<\/code><\/li>\n\n\n\n<li><strong>Share with support<\/strong><\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">\u26a0\ufe0f&nbsp;<strong>Disable debug mode after troubleshooting<\/strong>&nbsp;\u2014 logs can grow large!<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"-getting-help\">\ud83c\udd98 Getting Help<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"before-asking-for-help-\">Before asking for help:<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li>\u2705&nbsp;<strong>Check this guide<\/strong>&nbsp;\u2014 Most issues covered above<\/li>\n\n\n\n<li>\u2705&nbsp;<strong>Test with default theme<\/strong>&nbsp;\u2014 Rule out theme conflicts<\/li>\n\n\n\n<li>\u2705&nbsp;<strong>Disable other plugins<\/strong>&nbsp;\u2014 Rule out plugin conflicts<\/li>\n\n\n\n<li>\u2705&nbsp;<strong>Enable debug mode<\/strong>&nbsp;\u2014 Get error logs<\/li>\n<\/ol>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"support-channels\">Support Channels<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Free Support:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\ud83d\udcd6&nbsp;<strong>Documentation:<\/strong>&nbsp;<a href=\"https:\/\/daazlabs.com\/newssync\/docs\/\">https:\/\/daazlabs.com\/newssync\/docs\/<\/a><\/li>\n\n\n\n<li>\ud83d\udcac&nbsp;<strong>WordPress Forums:<\/strong>&nbsp;<a href=\"https:\/\/wordpress.org\/support\/plugin\/rss-newssync\/\" target=\"_blank\" rel=\"noopener\">WordPress.org Support<\/a><\/li>\n\n\n\n<li>\ud83d\udc1b&nbsp;<strong>Bug Reports:<\/strong>&nbsp;GitHub Issues (link in plugin)<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>When posting for help, include:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>WordPress version (Dashboard \u2192 Updates)<\/li>\n\n\n\n<li>PHP version (Settings \u2192 Site Health)<\/li>\n\n\n\n<li>NewsSync version (Plugins page)<\/li>\n\n\n\n<li>Feed URL you&#8217;re trying to use<\/li>\n\n\n\n<li>Error message (if any)<\/li>\n\n\n\n<li>Debug log (if available)<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"-next-steps\">\ud83d\ude80 Next Steps<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Now that NewsSync is installed:<\/strong><\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>\u2705&nbsp;<strong>Try different layouts<\/strong>&nbsp;\u2014 Grid, List, Minimal<\/li>\n\n\n\n<li>\u2705&nbsp;<strong>Combine multiple feeds<\/strong>&nbsp;\u2014 Use comma-separated URLs<\/li>\n\n\n\n<li>\u2705&nbsp;<strong>Customize styling<\/strong>&nbsp;\u2014 Add custom CSS<\/li>\n\n\n\n<li>\u2705&nbsp;<strong>Explore PRO features:<\/strong>\n<ul class=\"wp-block-list\">\n<li>\ud83e\udd16 AI-powered summaries<\/li>\n\n\n\n<li>\ud83d\udcc4 Full-text extraction<\/li>\n\n\n\n<li>\ud83d\udd0d Advanced filtering (regex, keywords)<\/li>\n\n\n\n<li>\ud83d\udcca Managed feeds (per-feed settings)<\/li>\n\n\n\n<li>\ud83d\udcc8 Usage analytics<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Upgrade to PRO:<\/strong>&nbsp;<a href=\"https:\/\/daazlabs.com\/newssync\/pro\/\">https:\/\/daazlabs.com\/newssync\/pro\/<\/a><\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"-related-documentation\">\ud83d\udcda Related Documentation<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong><a href=\"https:\/\/daazlabs.com\/news-shortcodes\/\">Shortcode Reference<\/a><\/strong>\u00a0\u2014 All available options<\/li>\n\n\n\n<li><strong><a href=\"https:\/\/daazlabs.com\/newssync\/docs\/styling\/\">Styling Guide<\/a><\/strong>&nbsp;\u2014 Customize appearance<\/li>\n\n\n\n<li><strong><a href=\"https:\/\/daazlabs.com\/newssync\/docs\/\">PRO Features<\/a><\/strong>&nbsp;\u2014 Advanced capabilities<\/li>\n\n\n\n<li><strong><a href=\"https:\/\/daazlabs.com\/newssync\/docs\/developers\/\">Developer Guide<\/a><\/strong>&nbsp;\u2014 Hooks, filters, API<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\ud83c\udf89 Congratulations!<\/strong>&nbsp;You&#8217;ve successfully installed NewsSync. Start aggregating RSS feeds and building amazing content! \ud83d\ude80<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Last updated:<\/strong>&nbsp;February 6, 2026&nbsp;<strong>Plugin Version:<\/strong>&nbsp;1.0.0+&nbsp;<strong>Requires:<\/strong>&nbsp;WordPress 5.8+, PHP 7.4+<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<div class=\"wp-block-buttons alignwide is-content-justification-center is-layout-flex wp-container-core-buttons-is-layout-fe0a7de2 wp-block-buttons-is-layout-flex\">\n<div class=\"wp-block-button is-style-fill\"><a class=\"wp-block-button__link has-text-align-center wp-element-button\" href=\"https:\/\/daazlabs.com\/docs\/\"><strong>Back to Documentation<\/strong><\/a><\/div>\n<\/div>\n\n\n\n<div style=\"height:100px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n","protected":false},"excerpt":{"rendered":"<p>NewsSync Installation &amp; Setup Guide \ud83c\udfaf Welcome! This guide will help you install and configure NewsSync (FREE version) on your WordPress site. Whether you&#8217;re a beginner or experienced developer, we&#8217;ve got you covered. What you&#8217;ll learn: \ud83d\udce6 Installation (3 Methods) Method 1: WordPress Admin (Easiest) \u2b50 Step-by-step: Method 2: Upload ZIP File When to use:&nbsp;Downloaded [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-2869","page","type-page","status-publish","hentry"],"blocksy_meta":[],"_links":{"self":[{"href":"https:\/\/daazlabs.com\/pt\/wp-json\/wp\/v2\/pages\/2869","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/daazlabs.com\/pt\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/daazlabs.com\/pt\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/daazlabs.com\/pt\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/daazlabs.com\/pt\/wp-json\/wp\/v2\/comments?post=2869"}],"version-history":[{"count":9,"href":"https:\/\/daazlabs.com\/pt\/wp-json\/wp\/v2\/pages\/2869\/revisions"}],"predecessor-version":[{"id":4669,"href":"https:\/\/daazlabs.com\/pt\/wp-json\/wp\/v2\/pages\/2869\/revisions\/4669"}],"wp:attachment":[{"href":"https:\/\/daazlabs.com\/pt\/wp-json\/wp\/v2\/media?parent=2869"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}