Post Kinds for IndieWeb in Block Themes
| 开发者 | courane01 |
|---|---|
| 更新时间 | 2026年7月21日 04:43 |
| PHP版本: | 8.2 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- 25 custom blocks — 22 editor blocks (card blocks for most kinds, plus utilities like Star Rating, Media Lookup, Check-in Dashboard, Check-ins Feed, and Venue Detail) and 3 server-rendered blocks (Now Playing, Media Stats, Recent Kinds)
- API-powered search — find music, movies, books, games, and venues directly from the editor
- Bulk import — pull in your history from Last.fm, Trakt, Hardcover, and more
- Real-time scrobbling — webhooks for Plex, Jellyfin, Trakt, and ListenBrainz. Scrobbling means automatically logging each song or show as you play it.
- microformats2 markup on every post. Microformats are standard HTML classes that let other IndieWeb sites and tools read your posts as structured data — a listen, an RSVP, a check-in — instead of plain text.
- Listen — music, podcasts, and audio (MusicBrainz, ListenBrainz, Last.fm)
- Watch — movies, TV shows, and videos (TMDB, Trakt, Simkl, TVMaze)
- Read — books and articles (Open Library, Google Books, Hardcover)
- Checkin — places and venues (Foursquare, OpenStreetMap), with per-post location privacy
- Play — video games and board games (RAWG, BoardGameGeek)
- Eat / Drink — food and beverages
- Jam — music you love, with oEmbed previews
- RSVP — event responses (yes, no, maybe, interested, remote)
- Like, Reply, Repost, Bookmark — IndieWeb interactions
- Favorite, Wish, Mood, Acquisition — personal tracking
/kind/listen/), and the kind is set automatically from the first card block in a post — or pick it yourself in the Post Kind editor panel.
Import and sync
- Bulk import from ListenBrainz, Last.fm, Trakt, Simkl, and Hardcover
- Webhooks for Plex, Jellyfin, Trakt, and ListenBrainz
- Background processing via WP-Cron for large imports, with duplicate prevention on re-imports
- Optional syndication (POSSE) — post on your own site first, then send a copy to Last.fm, Trakt, or Foursquare. Off by default; nothing is sent unless you enable it.
- Micropub — required for posting from Micropub apps. This plugin doesn't implement the Micropub endpoint itself; install the Micropub plugin (plus IndieAuth for authentication), and this plugin converts incoming posts into the right card block and kind.
- IndieBlocks — detected and recommended, not required. It provides companion blocks (Facepile, Location, Syndication, Link Preview); this plugin doesn't implement those features itself.
- Webmention — detected on the Integrations settings tab. Cross-site conversations come from that plugin, not this one.
- Syndication Links, Post Formats for Block Themes, Bookmark Card — detected and enhanced when present.
- ActivityPub — a recommendation only; this plugin contains no ActivityPub integration.
- Post Kinds (indieweb-post-kinds) — hard conflict. Both plugins register the same
kindtaxonomy, so this plugin refuses to run while the classic Post Kinds plugin is active and shows an admin notice instead. Deactivate one of them.
安装:
- WordPress 7.0 or later
- PHP 8.2 or later
- Go to Plugins > Add New
- Search for Post Kinds for IndieWeb in Block Themes
- Click Install Now, then Activate
- Clone or download from GitHub
- Run
composer installandnpm run build - Upload to
/wp-content/plugins/post-kinds-for-indieweb/and activate
- Go to Reactions > Settings to review defaults
- Add API keys under Reactions > API Connections for the services you want (TMDB, Last.fm, etc.)
- MusicBrainz and Open Library work without API keys
- Create a post and add a card block — the post kind is assigned automatically
屏幕截图:
常见问题:
Can I use this alongside the original Post Kinds plugin?
No. Both plugins register the same kind taxonomy, so this plugin refuses to initialize while the classic Post Kinds plugin is active and shows an error notice. Deactivate the original before activating this one.
Do I need IndieBlocks installed?
No, but it's recommended and the plugin shows an admin notice suggesting it. IndieBlocks provides companion blocks for bookmarks, likes, replies, and reposts; this plugin detects it but doesn't implement its features.
How do I post from my phone or a Micropub app?
Install the separate Micropub plugin and an IndieAuth setup (for example the IndieAuth plugin). Micropub is a standard API that lets mobile and third-party apps publish to your site. Once it's active, this plugin converts incoming Micropub posts into the right card block and assigns the kind.
Why isn't the media search finding anything?
Check your API keys under Reactions > API Connections — each service has a link to register for one, and MusicBrainz and Open Library need no key. Verify your server can make outbound HTTPS requests. Try different search terms.
Can I import my existing data?
Yes. Go to Reactions > Import to import from Last.fm, Trakt, Hardcover, and more. Large imports run in the background via WP-Cron, with duplicate prevention on re-imports.
Are my check-ins private?
Each check-in has a location privacy level: public (full address and coordinates), approximate (city and region only), or private (no location shown). The published markup redacts location details to match, and you can set a site-wide default in settings.
What data leaves my site?
Media lookups and imports contact the services you use them with (MusicBrainz, TMDB, Open Library, and so on — see the Privacy Policy section below). Syndication sends posts to Last.fm, Trakt, or Foursquare only when you enable those toggles. Nothing else is sent.
Does this work with the Classic Editor?
The custom blocks require the block editor. With the Classic Editor you can still assign kinds through the taxonomy box, but with limited UI and no card blocks.
Where can I read the full documentation?
Long-form guides — installation, settings, common tasks, troubleshooting, privacy — live at courtneyr-dev.github.io/post-kinds-for-indieweb.
更新日志:
- Initial WordPress.org release: 24 post kinds with card blocks, media lookup, imports and webhook scrobbling, microformats2 markup, syndication, and Micropub support. Development history for the pre-release builds lives in CHANGELOG.md in the GitHub repository.
- Security: syndication handlers require the per-post
edit_postcapability, closing an IDOR where a user with genericedit_postscould syndicate another user's post. - Security: Letterboxd lookups use
wp_safe_remote_getwithreject_unsafe_urls, so a redirect target can't reach private or loopback hosts. - Fixed: like, reply, repost, bookmark, favorite, listen, watch, and read posts expose the correct microformats2 markup, so webmention receivers and feed readers recognize them as their kind.