Freshet Feeds
| 开发者 | kristoffbertram |
|---|---|
| 更新时间 | 2026年8月20日 20:14 |
| PHP版本: | 8.2 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- A loop API:
freshet_feeds( 'my-feed' )returns normalized item objects;freshet_feeds_render( 'my-feed' )runs the full template chain. - Template overrides: copy
item.phpinto{your-theme}/freshet-feeds/and edit. An item hierarchy (item-{feed-slug}.php→item-{provider}.php→item.php) gives per-feed and per-type markup with clean fallbacks. - Custom layouts by convention: drop
layout-carousel.phpin your theme, passcarousel— no registration. - Hooks for everything: providers, template resolution, cache refresh events.
- 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.
- Feed images are stored locally in your uploads dir (some providers serve expiring signed image URLs — hotlinking them breaks).
- Visitors' browsers never contact the source platforms. Content lives in your DOM: real SEO, no consent baggage.
- RSS / Atom — any feed URL; also covers Mastodon, subreddits, podcasts.
- YouTube (channel) — keyless public channel feed, no API key required.
- Bluesky (profile) — public API, no authentication.
- Mock (fixture data) — bundled sample posts, no credentials and no network calls, for building and styling templates before a live connection exists. Hidden and blocked in
production.
安装:
- Install and activate the plugin.
- Go to Feeds → Add feed, pick a provider, and configure it (a feed URL, channel ID, or handle).
- Add the Feed block to a page, or call
freshet_feeds_render( 'your-feed-slug' )in your theme.
常见问题:
Can I build templates before I have a live feed set up?
Yes — that is what the Mock (fixture data) 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.
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 — you switch the feed's provider and nothing else.
The provider is hidden in the provider dropdown on sites reporting a production environment type, and refuses to fetch there even for a feed created earlier, so fixture posts cannot end up on a live site.
Why is there no X (Twitter) provider?
X has no free read API and no RSS. We don't build on scraping. If that changes, we'll add it.
How do I change the markup?
Copy any template from the plugin's templates/ folder into {your-theme}/freshet-feeds/ and edit it. See the template docs.
Does it slow my site down?
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.
更新日志:
- First release published on WordPress.org.
- Fixed cached feed items being corrupted, and in some cases discarded entirely, when an item contained a quote or a non-ASCII character.
- Initial release: RSS/Atom, YouTube, and Bluesky providers.
- Template override chain with item hierarchy, custom layouts, loop API.
- Server-rendered Feed block, stale-while-revalidate caching, local image storage.
- WP-CLI commands (
wp freshet-feeds fetch,wp freshet-feeds status).