{"id":342510,"date":"2026-08-20T12:15:19","date_gmt":"2026-08-20T12:15:19","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/the-wp-feeds\/"},"modified":"2026-08-20T12:14:57","modified_gmt":"2026-08-20T12:14:57","slug":"freshet-feeds","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/freshet-feeds\/","author":15137713,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.1","stable_tag":"1.0.1","tested":"7.1","requires":"6.5","requires_php":"8.2","requires_plugins":null,"header_name":"Freshet Feeds","header_author":"Freshet Studio","header_description":"Developer-first external feeds (LinkedIn first) with a shared item model and theme-overridable templates.","assets_banners_color":"3e48d6","last_updated":"2026-08-20 12:14:57","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/freshet.studio\/docs","header_author_uri":"https:\/\/freshet.studio","rating":0,"author_block_rating":0,"active_installs":0,"downloads":59,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.1":{"tag":"1.0.1","author":"kristoffbertram","date":"2026-08-20 12:14:57"}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3656796,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3656796,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256},"icon.svg":{"filename":"icon.svg","revision":3656796,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3656796,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3656796,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":{"freshet-feeds\/feed":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"freshet-feeds\/feed","title":"Feed","category":"widgets","icon":"rss","description":"Display an external feed (RSS, YouTube, Bluesky) using Freshet Feeds templates.","keywords":["feed","rss","social"],"textdomain":"freshet-feeds","attributes":{"feedId":{"type":"integer","default":0},"layout":{"type":"string","default":""},"count":{"type":"integer","default":0}},"supports":{"align":["wide","full"],"spacing":{"margin":true},"html":false},"editorScript":"file:.\/index.js","style":"file:.\/style-index.css","render":"file:.\/render.php"}},"tagged_versions":["1.0.1"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3656796,"resolution":"1","location":"assets","locale":"","width":1280,"height":960}},"screenshots":{"1":"A feed rendered by your own theme \u2014 YouTube, RSS and Bluesky items normalized into one grid."}},"plugin_section":[],"plugin_tags":[223781,1594,850,1610],"plugin_category":[56],"plugin_contributors":[276640],"plugin_business_model":[],"class_list":["post-342510","plugin","type-plugin","status-publish","hentry","plugin_tags-bluesky","plugin_tags-feeds","plugin_tags-rss","plugin_tags-youtube","plugin_category-social-and-sharing","plugin_contributors-kristoffbertram","plugin_committers-kristoffbertram"],"banners":{"banner":"https:\/\/ps.w.org\/freshet-feeds\/assets\/banner-772x250.png?rev=3656796","banner_2x":"https:\/\/ps.w.org\/freshet-feeds\/assets\/banner-1544x500.png?rev=3656796","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/freshet-feeds\/assets\/icon.svg?rev=3656796","icon":"https:\/\/ps.w.org\/freshet-feeds\/assets\/icon.svg?rev=3656796","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/freshet-feeds\/assets\/screenshot-1.png?rev=3656796","caption":"A feed rendered by your own theme \u2014 YouTube, RSS and Bluesky items normalized into one grid."}],"raw_content":"<!--section=description-->\n<p>Freshet Feeds displays external feeds inside WordPress the way developers wish every feed plugin worked: <strong>your theme owns the markup<\/strong>. No vendor styling panels, no iframes, no third-party JavaScript on your pages.<\/p>\n\n<p>Every provider \u2014 RSS\/Atom, YouTube channels, Bluesky profiles \u2014 normalizes into one item model and renders through one template chain, overridable WooCommerce-style from your theme.<\/p>\n\n<p><strong>For developers<\/strong><\/p>\n\n<ul>\n<li>A loop API: <code>freshet_feeds( 'my-feed' )<\/code> returns normalized item objects; <code>freshet_feeds_render( 'my-feed' )<\/code> runs the full template chain.<\/li>\n<li>Template overrides: copy <code>item.php<\/code> into <code>{your-theme}\/freshet-feeds\/<\/code> and edit. An item hierarchy (<code>item-{feed-slug}.php<\/code> \u2192 <code>item-{provider}.php<\/code> \u2192 <code>item.php<\/code>) gives per-feed and per-type markup with clean fallbacks.<\/li>\n<li>Custom layouts by convention: drop <code>layout-carousel.php<\/code> in your theme, pass <code>carousel<\/code> \u2014 no registration.<\/li>\n<li>Hooks for everything: providers, template resolution, cache refresh events.<\/li>\n<\/ul>\n\n<p><strong>Performance &amp; privacy by design<\/strong><\/p>\n\n<ul>\n<li>Rendering never blocks on a remote API (the only exception is a brand-new feed's very first fetch): items are cached server-side, stale content is served instantly while a background refresh runs.<\/li>\n<li>Feed images are stored locally in your uploads dir (some providers serve expiring signed image URLs \u2014 hotlinking them breaks).<\/li>\n<li>Visitors' browsers never contact the source platforms. Content lives in your DOM: real SEO, no consent baggage.<\/li>\n<\/ul>\n\n<p><strong>Providers<\/strong><\/p>\n\n<ul>\n<li><strong>RSS \/ Atom<\/strong> \u2014 any feed URL; also covers Mastodon, subreddits, podcasts.<\/li>\n<li><strong>YouTube (channel)<\/strong> \u2014 keyless public channel feed, no API key required.<\/li>\n<li><strong>Bluesky (profile)<\/strong> \u2014 public API, no authentication.<\/li>\n<li><strong>Mock (fixture data)<\/strong> \u2014 bundled sample posts, no credentials and no network calls, for building and styling templates before a live connection exists. Hidden and blocked in <code>production<\/code>.<\/li>\n<\/ul>\n\n<p>The plugin is fully functional with unlimited feeds. A separately distributed version with a managed source pipeline and direct support is available from <a href=\"https:\/\/freshet.studio\">freshet.studio<\/a>. Full developer documentation: <a href=\"https:\/\/freshet.studio\/docs\">freshet.studio\/docs<\/a>.<\/p>\n\n<h3>External services<\/h3>\n\n<p>This plugin talks to external services only to fetch the feed content you configure:<\/p>\n\n<ul>\n<li><strong>YouTube feed<\/strong> (www.youtube.com\/feeds) \u2014 only for configured YouTube feeds. <a href=\"https:\/\/www.youtube.com\/t\/terms\">Terms<\/a>, <a href=\"https:\/\/policies.google.com\/privacy\">Privacy<\/a>.<\/li>\n<li><strong>Bluesky public API<\/strong> (public.api.bsky.app) \u2014 only for configured Bluesky feeds. <a href=\"https:\/\/bsky.social\/about\/support\/tos\">Terms<\/a>, <a href=\"https:\/\/bsky.social\/about\/support\/privacy-policy\">Privacy<\/a>.<\/li>\n<li><strong>Any RSS\/Atom URL you configure<\/strong> is fetched from your server on your cache schedule.<\/li>\n<\/ul>\n\n<p>All fetching happens server-side on your cache schedule; site visitors never contact these services.<\/p>\n\n<h3>Source code<\/h3>\n\n<p>The complete, unminified source \u2014 including the block editor JavaScript in <code>blocks\/<\/code> and the build setup \u2014 ships with the plugin and is maintained publicly at <a href=\"https:\/\/github.com\/freshetstudio\/freshet-feeds\">github.com\/freshetstudio\/freshet-feeds<\/a>. The compiled bundle in <code>build\/<\/code> is generated from <code>blocks\/<\/code> by running <code>npm install<\/code> and <code>npm run build<\/code> (uses @wordpress\/scripts).<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Install and activate the plugin.<\/li>\n<li>Go to <strong>Feeds \u2192 Add feed<\/strong>, pick a provider, and configure it (a feed URL, channel ID, or handle).<\/li>\n<li>Add the <strong>Feed<\/strong> block to a page, or call <code>freshet_feeds_render( 'your-feed-slug' )<\/code> in your theme.<\/li>\n<\/ol>\n\n<p>No credentials yet? Pick the <strong>Mock (fixture data)<\/strong> provider in step 2 and start building templates immediately \u2014 see the FAQ below.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id=\"can%20i%20build%20templates%20before%20i%20have%20a%20live%20feed%20set%20up%3F\"><h3>Can I build templates before I have a live feed set up?<\/h3><\/dt>\n<dd><p>Yes \u2014 that is what the <strong>Mock (fixture data)<\/strong> provider is for. Create a feed with it and you get a bundled set of realistic sample posts (single image, multi-image, shared article, text-only, an image-only post with no text, and a long multi-paragraph one) without any credentials or network call. It is also the fastest way to evaluate the plugin.<\/p>\n\n<p>Mock posts run through exactly the same normalizer, item model and template chain as live posts, so everything you build against them works unchanged on real data \u2014 you switch the feed's provider and nothing else.<\/p>\n\n<p>The provider is hidden in the provider dropdown on sites reporting a <code>production<\/code> environment type, and refuses to fetch there even for a feed created earlier, so fixture posts cannot end up on a live site.<\/p><\/dd>\n<dt id=\"why%20is%20there%20no%20x%20%28twitter%29%20provider%3F\"><h3>Why is there no X (Twitter) provider?<\/h3><\/dt>\n<dd><p>X has no free read API and no RSS. We don't build on scraping. If that changes, we'll add it.<\/p><\/dd>\n<dt id=\"how%20do%20i%20change%20the%20markup%3F\"><h3>How do I change the markup?<\/h3><\/dt>\n<dd><p>Copy any template from the plugin's <code>templates\/<\/code> folder into <code>{your-theme}\/freshet-feeds\/<\/code> and edit it. See the <a href=\"https:\/\/freshet.studio\/docs\/templates\">template docs<\/a>.<\/p><\/dd>\n<dt id=\"does%20it%20slow%20my%20site%20down%3F\"><h3>Does it slow my site down?<\/h3><\/dt>\n<dd><p>No. Feeds are fetched in the background and served from a local cache; pages never wait on a remote API (except the one-time first fetch of a newly created feed). Images are served from your own uploads directory.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>First release published on WordPress.org.<\/li>\n<li>Fixed cached feed items being corrupted, and in some cases discarded entirely, when an item contained a quote or a non-ASCII character.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release: RSS\/Atom, YouTube, and Bluesky providers.<\/li>\n<li>Template override chain with item hierarchy, custom layouts, loop API.<\/li>\n<li>Server-rendered Feed block, stale-while-revalidate caching, local image storage.<\/li>\n<li>WP-CLI commands (<code>wp freshet-feeds fetch<\/code>, <code>wp freshet-feeds status<\/code>).<\/li>\n<\/ul>","raw_excerpt":"Developer-first external feeds \u2014 RSS\/Atom, YouTube channels and Bluesky profiles \u2014 rendered with templates your theme owns.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/342510","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=342510"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/kristoffbertram"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=342510"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=342510"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=342510"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=342510"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=342510"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=342510"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}