Post Kinds for IndieWeb in Block Themes
| 开发者 | courane01 |
|---|---|
| 更新时间 | 2026年8月24日 22:48 |
| PHP版本: | 8.2 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- 27 custom blocks — 23 editor blocks (card blocks for most kinds, plus utilities like Star Rating, Media Lookup, Check-in Dashboard, Check-ins Feed, and Venue Detail), 3 server-rendered blocks (Now Playing, Media Stats, Recent Kinds), and the Stream Card, which is registered in PHP, hidden from the inserter, and stands in for Post Content inside the Stream query loop
- 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.
- Automatic featured images — album art, posters, and book covers from your media posts become the featured image when a post has none.
- A firehose feed at /firehose — your site's RSS plus the bulk-imported posts that normal feeds leave out.
- Standard.site records — when a page you bookmark publishes its metadata to AT Protocol, read the author's own title, description, and tags instead of guessing from the page. No account or setup needed.
- Standard.site publishing — add the optional ATmosphere companion plugin (2.1.0+) and your own posts publish as Standard.site documents on AT Protocol. Post Kinds adds what ATmosphere can't know: which kinds publish by default, readable titles for untitled posts ("Listened to … by …", "Checked in at …"), the kind as a tag, and check-in privacy rules. Everything else in Post Kinds works without it.
- 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)
- Event — events with date, time, and location; the Event Card can pull details from The Events Calendar or My Calendar
- Like, Reply, Repost, Bookmark — IndieWeb interactions
- Favorite, Wish, Mood, Acquisition — personal tracking
- Follow, Tag, Quote, Issue, Question — more IndieWeb response types
- Audio, Weather, Exercise, Sleep, Trip, Itinerary, Craft — logs and experimental kinds
/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 classifies every incoming post as its kind — all registered kinds, not just the common ones — and converts it into the right card block or microformats paragraph. Clients that know their kind can name it outright with a
pkiw-kindproperty; Outpost does. - 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.
- ATmosphere — optional companion (2.1.0+) for Standard.site publishing on AT Protocol. ATmosphere owns the connection and the records; this plugin decides which kinds publish, derives readable titles for untitled posts, and applies check-in privacy rules. Everything else works without it.
- Link Extension for XFN — detected on the Integrations settings tab. Adds XFN relationship options to the block editor's link popover, so a reply or mention can say how you know the person.
- The Events Calendar and My Calendar — either one feeds the Event card. Event name, start, end, location, and URL are read from whichever is installed; with neither, the card falls back to its own fields.
- WP Recipe Maker — a post containing a WPRM recipe is detected, and the recipe kind is suggested for it.
- ActivityPub — a recommendation only; this plugin contains no ActivityPub integration.
- RSS Chat — a recommendation only; this plugin contains no rss.chat integration, and RSS Chat is on GitHub rather than WordPress.org. It syndicates posts carrying the core chat post format, which is separate from kinds, so a note or a reply is not sent to rss.chat unless you also set that format on it. Whether that check could become filterable, so a kind could decide instead, is open upstream: issue #6.
- 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-in-block-themes/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.
What is the "Standard.site record" panel on my bookmark cards?
Some sites publish their posts' metadata to AT Protocol using the standard.site schemas. When a page you cite does, that panel reads the author's own title, description, and tags rather than guessing from the page, and tells you which publication it came from. Choose "Check this URL" to look. Most of the web publishes no such record, and the panel says so plainly when that happens — it isn't an error. Nothing is checked until you ask, and the panel stays hidden until the card has a URL.
Does the Standard.site panel publish my posts to AT Protocol?
The panel itself only reads — checking a URL sends nothing about you or your site. Publishing your own posts is separate and optional: install the ATmosphere companion plugin, connect an AT Protocol account there, and eligible posts publish as Standard.site documents when you publish them. Without ATmosphere, or until you connect, nothing is ever sent.
Which posts publish to Standard.site?
Public content and public logs publish by default once ATmosphere is connected — notes, articles, photos, videos, reviews, recipes, events, and your listens, watches, reads, plays, eats, drinks, and jams, plus replies, bookmarks, and RSVPs. Thin signals (likes, reposts, favorites, follows) and privacy-sensitive kinds (check-ins, moods, wishes, acquisitions, and the health and travel logs) stay off by default; turn any kind on under Settings → Post Kinds → Integrations, or per post with ATmosphere's sharing toggle in the editor, which always has the final say. Posts published before you change a setting are never removed by it.
Do my posts also go to Bluesky?
That's ATmosphere's choice, not this plugin's: Bluesky cross-posting follows ATmosphere's own settings unchanged. Standard.site documents and Bluesky posts are related but separate — see the plugin documentation for publishing documents without Bluesky companions.
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 assigns the kind and builds the content for every incoming Micropub post — each registered kind is reachable, whether the client sends the kind's canonical property or names the kind directly with the pkiw-kind property.
For one-tap posting and bookmarklet-style sharing from any page or your phone's share sheet, Outpost is a companion progressive web app that posts to your site over Micropub. This plugin doesn't ship its own bookmarklet — Micropub and Outpost cover that.
Can I browse or subscribe to one kind at a time?
Yes — every kind gets its own archive and RSS feed automatically. Visit /kind/listen/ (swap listen for any kind) to see all posts of that kind, and /kind/listen/feed/ — or /feed/?kind=listen — to subscribe to just that kind in a feed reader. This works as soon as the plugin is active and your permalinks are refreshed (visit Settings → Permalinks once if the links 404).
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 classic themes or the Classic Editor?
No. This plugin is built for block themes and the block editor — its card blocks and templates rely on them and won't work as intended on a classic (non-block) theme or in the Classic Editor. If you're on a classic theme or the Classic Editor, use the original Post Kinds plugin instead.
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.
更新日志:
- Fixed: long mood posts lost their emoji on the Stream. The compact card now shows the emoji from the post's mood card.
- Fixed: mood posts read as a stack of stray lines in feed readers. Feeds now show the emoji inline with the post text instead of the flattened card markup.
- Fixed: choosing the quote post format now maps to the quote kind instead of repost.
- Fixed: a search that found nothing kept saying "no results found" for a full day, even after the service recovered. Empty lookups now retry after five minutes.
- Fixed: the plugin download no longer includes the directory-listing artwork, making it noticeably smaller.
- Added: four more kinds — chicken, comics, collection, and presentation — bringing the total to 40.
- Added: the Play Card has six looks to choose from in the editor's Styles panel — board game, console game, computer game, card game, dice game, and tabletop RPG. It picks one for you based on what it knows about the game, and leaves your choice alone if you've made one.
- Added: sites can now give their own custom kinds an icon in the kind picker, instead of every custom kind showing the generic note icon. Developers: the new
postKindsIndieweb.kindIconsJavaScript filter. - Added: the Micropub bridge understands every registered kind, not just the original 16, and clients can name a kind outright with the new
pkiw-kindproperty. - Fixed: publishing a book post after a lookup failed with "meta._pkiw_read_isbn is not of type string". Lookup services return ISBNs, IDs, and years as numbers where the plugin stores text, which made WordPress reject the whole save. Values are now converted where they're stored, so every lookup field is covered rather than just the ones reported.
- Added: Standard.site publishing through the optional ATmosphere companion plugin (2.1.0 or later). Public content and public logs — notes, articles, photos, videos, reviews, recipes, events, listens, watches, reads, plays, eats, drinks, jams, replies, bookmarks, and RSVPs — publish as Standard.site documents by default once ATmosphere is connected; likes, reposts, favorites, follows, check-ins, moods, and the other privacy-sensitive kinds stay off until you turn them on, per kind or per post. Untitled posts get readable derived titles ("Listened to … by …", "Checked in at …" — or just "Checked in" for a private check-in), the kind rides along as a tag, and a post's own sharing toggle always has the final say. Posts that already published are never removed by a settings change, and nothing backfills automatically. Post Kinds works fully without ATmosphere.
- Added: a Standard.site column on the posts list showing each post's publish state, and per-kind publishing controls on the Integrations settings tab.
- Fixed: hidden microformats markers no longer appear in ATmosphere's record previews, so what you preview is exactly what publishes.
- Fixed: the Check-in Dashboard block crashed in the editor for everyone who inserted it, with any settings. It read its data feed in the wrong shape.
- Fixed: the Play Card crashed in the editor whenever its status differed from the default — pasted, imported, or pattern-inserted cards hit this every time.
- Fixed: Event and RSVP cards crashed in the editor on a date they couldn't parse, and a similar problem in several cards' saving code could block a post from saving at all. Every date now degrades gracefully instead.
- Fixed: the Check-in Dashboard's "Check-ins" and "Countries" stats always showed 0 regardless of your data.
- Fixed: the cover image's remove control was a button nested inside another button in all eleven card blocks — invalid HTML that confuses screen readers, and it was invisible to keyboard users. It's now a proper sibling control that appears on keyboard focus too.
- Changed: the plugin download shrinks from 4.8M to 0.6M — a folder of marketing imagery that the plugin never loads no longer ships.
- Fixed: the /firehose feed added in 1.5.0 returned 404 on any site that updated rather than installed fresh, and stayed that way. Rewrite rules were only rebuilt on activation, which WordPress doesn't run on update, so the feed's address was never registered. Updating now rebuilds them.
- Fixed: kinds added in a previous update now show up right away. They were only filled in on a wp-admin page load, so a freshly-updated site briefly showed 24 kinds instead of 36 and 404'd the newer kind archives for visitors.
- Fixed: a kind post's microformats2 property (u-like-of, u-listen-of, and the rest) now attaches to an h-entry at the post's own URL — the page webmention receivers actually fetch. Block themes whose single template never calls post_class() (Twenty Twenty-Five, Twenty Twenty-Four) left the card parsing as an orphan citation; the plugin now supplies its own h-entry wrapper there, with the permalink and publish date included, and steps aside on themes that already provide one.
- Fixed: the Stream Card registers with block API version 3 like every other block.
- Fixed: the plugin package includes its stylesheet and admin assets again — a packaging manifest had gone stale, so the downloaded zip was missing the card design tokens and the whole admin interface.
- Fixed: card links show a visible focus outline again for keyboard users — the style referenced a color token the plugin never defines, which silently removed the outline entirely.
- Fixed: favorite, eat, drink, play, jam, mood, acquisition, and wish posts now carry their microformats root at the post's own URL, like every other kind.
- Tested up to WordPress 7.1, with the CI test matrix now covering 7.0 and 7.1 on PHP 8.2–8.4.
- Added: an Event Card block with h-event microformats. The event's start date renders under the title so themes can feature the event date instead of the publish date.
- Added: the Event Card can pull its details from The Events Calendar or My Calendar at render time — optional, feature-detected, and only publicly viewable events resolve.
- Added: the 12 remaining IndieWeb post kinds — audio, quote, tag, weather, exercise, trip, itinerary, follow, issue, question, sleep, and craft — completing the full 36-kind vocabulary of the classic Post Kinds plugin. Each appears in the kind pickers with its own icon and carries kind-appropriate microformats2 markup.
- Added: read standard.site records from pages you cite. When a bookmarked page publishes its metadata to AT Protocol, the block sidebar can show the author's own title, description, tags, and publication instead of guessing from the page. Read-only and unauthenticated — no account, no setup, and your posts are never published to AT Protocol. A record is only stored on your post once it points back at the page it was found on, so a page cannot claim someone else's writing.
- Added: a firehose RSS feed at /firehose that includes bulk-imported posts.
- Added: a pkiw_kind_label filter so themes can swap each card's visible kind label, and a pk-caption wrapper grouping each card's title, date, and sub lines for styling.
- Fixed: posts without a title no longer disappear from the Stream — the kind label stands in as the linked title, and any kind renders a complete card.
- Fixed: the plugin's abilities (Abilities API) now actually register; their old underscore names were rejected by WordPress core.
- Fixed: a bookmark post built with the Bookmark Card no longer gets an empty Embed block inserted above it in the editor.
- Fixed: no more "doing it wrong" notice when Post Formats for Block Themes also registers the shared block-bindings source.
- Added: media artwork (album covers, posters, book covers) becomes the post's featured image when none is set, with a pkiw_set_featured_from_artwork filter to opt out and a wp postkind featured-artwork backfill command for existing posts.
- Added: kind artwork reaches Yoast SEO's schema graph as the primary image when Yoast finds none itself.
- Added: listen, watch, jam, and play card fields mirror into post meta on save, so themes and plugins can read them without parsing blocks.
- 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.