show.fm Podcast Player
| 开发者 | danmaby |
|---|---|
| 更新时间 | 2026年10月17日 18:56 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- Player: one episode, or always the latest, in standard or compact size, with a waveform, an optional transcript, and an optional mini-player that keeps it playing at the bottom of the page when the visitor scrolls away.
- Episode list: a show's episodes as cards or a minimal list, filtered by season, with or without trailers and bonus episodes. The playing episode has a Transcript button when its transcript is on show.fm.
- Play button: a button or a link in a sentence that plays an episode in a mini-player along the bottom of the page.
- Transcript: a follow-along transcript that highlights the words as they are spoken.
[showfm] shortcode, and a pasted show.fm link becomes a player.
Publish to WordPress, for show.fm accounts
Connect the site to show.fm in Settings > show.fm and each new episode becomes a post: scheduled episodes are scheduled, unpublished ones go back to draft and deleted ones go to the bin. You choose the post type, category, author and template, and whether to add the transcript and use the episode artwork as the featured image. Posts you edit in WordPress keep your edits.
Move from another podcast host
The Migrate tab finds players from Buzzsprout, Libsyn, Captivate, Transistor, Spotify, Podbean, PowerPress and Seriously Simple Podcasting in your posts and pages. It shows a dry run first, and swaps them for show.fm blocks only when you confirm. WordPress keeps a revision of every post it changes.
Built for WordPress
- Players render on the server from a local cache, so pages never wait for show.fm.
- The player scripts ship with the plugin. Nothing loads from a CDN.
- The "Powered by show.fm" credit is off for every show unless you turn it on.
- WP-CLI:
wp showfm connect,status,disconnect,sync,cache flushandmigrate-embeds. - Multisite: each site connects separately.
build/ are compiled from src/ there with @wordpress/scripts. The player scripts in assets/showfm-embed/ are copied unchanged from the MIT-licensed @showfm/embed 1.6.2 package, and a test checks every file byte for byte. The package's MIT licence is in assets/showfm-embed-license.txt. With "Load players only after a visitor clicks" on, the plugin loads the package's self-hosting click loader (click-loader-local.js) instead of the player script. It names no host: it loads only the bundled v1.js the plugin gives it, after a visitor presses a block, and without that it does nothing. The package's CDN click loader is not in the plugin, and a release check fails if any script in the plugin names embed.cdn.media.
安装:
屏幕截图:
常见问题:
How do I add an episode to a post?
Add a show.fm Player, Episode list, Play button or Transcript block. Type the show's address (such as the-long-table.show.fm) or its slug, then choose an episode or "Latest episode". On a connected site you pick from your own shows instead, including scheduled episodes, which the editor marks with the date they go live. Visitors see nothing for an episode until it is public.
Who can see scheduled episodes in the editor?
On a connected site, only people who can publish posts (Authors, Editors and Administrators) see the account's shows and scheduled episodes. Contributors can add public shows and episodes by address. A scheduled episode's title is never saved in the post.
Can I use a shortcode?
Yes. [showfm type="player" episode="<episode ID>"] adds a player. type can be player, episodes, play or transcript, and the other attributes match the blocks' settings.
Where are the settings?
Settings > show.fm. The Connection tab connects the site and shows the account, the connected shows and when the key expires. The Display tab has four site-wide switches: the "Powered by show.fm" credit (off), loading players only after a visitor clicks (off), episode structured data for search engines (on) and using your theme's colours and fonts (on). Publishing and Migrate appear once the site is connected.
How do I choose how episodes are posted?
Settings > show.fm > Publishing. Choose whether new episodes are posted automatically, the post type, category, author and template, and whether to include the transcript and use the episode artwork as the featured image. These settings shape new posts only. The tab also lists the last 20 things the sync did, with a link to each post.
Can I move my old podcast players to show.fm?
Yes, on a connected site. In Settings > show.fm > Migrate, choose Scan posts. You then see a dry run: players ready to swap and how each was matched, players where you pick the episode, players with no match, and posts that already use show.fm. Nothing changes until you confirm. The results link to the revision WordPress keeps of each changed post, so you can restore any of them. From the command line, run wp showfm migrate-embeds --dry-run --user=<administrator>, then wp showfm migrate-embeds --resume --yes --user=<administrator>.
What do the admin notices mean?
The plugin shows at most one notice, on the Dashboard, Plugins and show.fm screens only, and only to administrators. It warns 30 and 7 days before the site key expires, when show.fm stops accepting the key, when the shows' plan pauses auto-posting, and when a publishing setting stops new episodes being posted. Each notice has one button that fixes the problem, and you can dismiss it.
Can I connect from the command line?
Yes. Create a site key in show.fm under Connected sites, then run wp showfm connect. It asks for the key with the input hidden, or reads it from the SHOWFM_KEY environment variable or standard input (--key=-). On a multisite network, add --url= to pick the site.
How do I clear the plugin's cache?
Run wp showfm cache flush. It clears the show and episode details the blocks render from and the block editor's lookups, and says how many stored entries it removed. Pages show each block's saved copy until the background refresh fetches the data again. On a multisite network, wp showfm cache flush --network does it for every site. Nothing else in your site's cache is touched.
How is the connection stored?
The site key and ping secret are encrypted with a key derived from your WordPress salts, and are never shown in full, logged or sent to the browser. Set the salts in wp-config.php. If they change, connect again.
Does disconnecting cancel the site key?
Yes, when show.fm can be reached. Disconnect asks show.fm to revoke the key, then removes it from the site whatever the answer. If show.fm didn't confirm, the message links to Connected sites in show.fm, where you can revoke it by hand. Posts already created stay.
What does uninstalling remove?
The plugin's settings, cache, scheduled events and its own post meta. Your posts and media stay.
更新日志:
- The plugin's licence and the bundled player's MIT licence are now
license.txtandassets/showfm-embed-license.txt, so every file in the plugin has a standard file type. Nothing else changes.
- Renames a block editor CSS class whose selector text was read as a remote file host. The editor looks and works the same, and the plugin still loads no files from other sites.
- The plugin's built-in hosts are show.fm's production services only. A site's own code can select another show.fm environment for testing with the
showfm_environmentfilter, which replaces theSHOWFM_API_URLandSHOWFM_APP_URLconstants. The block editor gets the same hosts from the site. - Bundles @showfm/embed 1.6.2, which names only production hosts.
- A connection is tied to the show.fm API that issued its key. If the site's environment changes, the plugin asks to reconnect and never sends the old key to the new one.
- Posts created by Publish to WordPress save the episode's title, listen page and audio in their blocks, as the editor does, so their first view has a readable fallback. The plugin also fills its cache for the episode during the sync and clears the post's cache whenever that changes, so page caches don't keep an empty first render.
- The Connection tab shows each show's address from show.fm.
wp showfm cache flushreports the new cache version when the site uses a persistent object cache.- With "Load players only after a visitor clicks" on, a Transcript block for an episode without a transcript shows nothing instead of a "Load transcript" box, and a Transcript block with its own height reserves that height before it loads.
- "Include the transcript" (Settings > show.fm > Publishing) starts the way the connection was approved: on with "Include transcripts in posts", off without it. For a connection made before 1.0.1 it starts on until show.fm tells the site, which the plugin asks soon after you open the Publishing tab.
- Disconnecting, or reconnecting to another site, clears the last sync time and the sync errors, so the new connection shows "never" until it first syncs. Reconnecting the same site keeps them.
- First public release.
- Player, Episode list, Play button and Transcript blocks, the
[showfm]shortcode and show.fm oEmbed, rendered on the server from a local cache with no request on page view. - Block editor pickers for shows and episodes, block settings, the heading level control and in-block messages for scheduled, unavailable, paused and unreachable episodes.
- Settings > show.fm with Connection, Publishing, Display and Migrate tabs, and admin notices for key expiry, a refused key, a plan pause and a publishing problem.
- Connect a site to show.fm in the browser or with WP-CLI. The site key is stored encrypted.
- Publish to WordPress: new episodes become posts that follow the episode when it is rescheduled, unpublished or deleted, and keep any edits made in WordPress.
- Embed migration from eight podcast hosts, with a dry run, episode picks and revisions to undo.
wp showfm cache flush(with--networkon multisite) clears the plugin's cache of show.fm data.- show.fm embeds in pasted links are always replaced with the plugin's local player, or a plain link when it can't play them locally.
- The Player, Episode list and Play button can open a mini-player, with a choice of corner. The Player's is off by default and takes over when a visitor scrolls past it while it plays.
- Bundles @showfm/embed 1.6.1. Every element carries
platform="wordpress", so with the credit setting off, no show displays "Powered by show.fm".