Linux 软件免费装
Banner图

Nahnu Video For Bunny Stream (Bunny.net)

开发者 Ja1me4
更新时间 2026年10月25日 09:45
PHP版本: 7.4 及以上
WordPress版本: 7.1
版权: GPLv2 or later
版权网址: 版权信息

标签

video block editor video gallery video shortcode bunny stream

下载

1.0.1 1.0.0 1.0.2

详情介绍:

Disclaimer: this is an independent, third-party plugin. It is not made by, affiliated with, endorsed by, or in any way officially connected to Bunny.net. "Bunny Stream" and "Bunny.net" are the trademarks of their own owner, referenced here only to describe what this plugin connects to. Nahnu Video connects your WordPress site to your Bunny Stream video library, so you can drop videos into posts and pages with a shortcode or a block: a plain, real Bunny player, exactly like pasting Bunny's own embed code, without hand-coding an iframe every time. 100% free. No premium version, no upsells, no feature paywall. Every feature described here, sync, shortcodes, blocks, the Video Control screen, the Shortcode Generator, statistics, is included, full stop. The only thing you pay for is your own Bunny Stream account, since that's where your videos are actually hosted. What it does How to use it Once your library is synced (see Installation below), you can drop a video in anywhere you'd normally write a shortcode or use a block: A single video, using the ID shown in Nahnu Video → All Videos: [bunny_video id="128"] The same video with a corner label and a note: [bunny_video id="128" label="NEW" note="Updated for 2026"] A responsive grid of everything tagged "tutorials", 3 columns wide: [bunny_grid tag="tutorials" columns="3"] A playlist: one main player, with a click-to-switch grid of every video in the "webinars" category below it: [bunny_playlist category="webinars"] Videos play in the Nahnu Player by default. To use Bunny's own iframe player for one embed instead, add player="bunny": [bunny_video id="128" player="bunny"] Prefer the block editor? Type /nahnu or /bunny while writing a post to find "Nahnu Video", "Nahnu Video Grid", and "Nahnu Video Playlist", each with a searchable picker and a live preview, no attributes to remember. Don't want to hand-type shortcode attributes either way? Nahnu Video → Shortcode Generator builds the exact shortcode for you with a live preview and a one-click copy button. Requirements You'll need your own Bunny Stream account with a video library already set up. Nahnu Video does not host or transcode video itself. It's a WordPress-side companion to your existing Bunny library. This plugin is not made by, affiliated with, or endorsed by Bunny.net. "Bunny Stream" is a product of Bunny.net; Nahnu Video is an independent, third-party integration.

安装:

  1. Upload the nahnu-video-for-bunny-stream-bunny-net folder to /wp-content/plugins/, or install it through the WordPress Plugins screen.
  2. Activate the plugin.
  3. Go to Nahnu Video → Settings and enter your Bunny Stream Library ID, Stream API Key, and CDN Pull Zone (all found in your Bunny dashboard under Stream → your library → API).
  4. Click Test Connection to confirm your credentials work.
  5. Click Sync Now to pull your existing videos into WordPress.
  6. Tag and categorize videos from Nahnu Video → All Videos using Quick Edit, same as you would with Posts.
  7. Insert videos with the [bunny_video] / [bunny_grid] / [bunny_playlist] shortcodes, or the "Nahnu Video" / "Nahnu Video Grid" / "Nahnu Video Playlist" blocks.

屏幕截图:

  • Shortcode Generator: pick a video, set every option, copy the exact shortcode with a live preview.
  • Videos screen: thumbnails, live search, shortcodes, and inline tagging.

升级注意事项:

1.0.2 Videos now play in the Nahnu Player by default (an on-page player with your brand colors). If you rely on Bunny's view statistics or a Pull Zone that blocks direct file access, switch back to the Bunny player under Settings → Player. Also fixes block editor thumbnail previews. After updating, click Sync Now once. 1.0.1 Adds a developer integration API and an optional Bunny webhook. Sync Now now moves videos you deleted in Bunny to the Trash (restorable).

常见问题:

Does this plugin upload or transcode video?

No. Video hosting, transcoding, and delivery are all handled by Bunny Stream directly. This plugin only connects your WordPress site to a library you already manage in Bunny's dashboard.

Can I embed a video before syncing my whole library?

Yes. [bunny_video id="your-bunny-guid"] works with a raw Bunny video GUID directly, even before that video has been synced into WordPress.

I changed something in Bunny (title, cover photo, replaced the file) but WordPress still shows the old version. What do I do?

Click Sync Now again (Nahnu Video → Settings → Library Sync). Syncing doesn't just pull in new videos, it also refreshes everything about videos you've already synced: title, duration, view count, and the cover photo/thumbnail. Turning on Auto-sync does this for you automatically on a schedule instead, and the optional Bunny webhook (Settings → Bunny Webhook) does it within seconds of the change. Either way, syncing never touches anything you've set yourself in WordPress, like categories, tags, or a video's published/draft status.

What happens to a video I delete in Bunny?

The next full sync moves its WordPress post to the Trash, so it stops showing up on your site. It's never deleted outright, so you can restore it from the Trash if that was a mistake. Developers can turn this off with the nahnu_video_remove_missing_on_sync filter.

Do I need to set up the Bunny webhook?

No, it's optional. Without it, scheduled sync (or Sync Now) still picks everything up. With it, Bunny tells WordPress about new uploads, finished encodes and changes right away. Copy the URL from Nahnu Video → Settings → Bunny Webhook and paste it into Bunny under Stream → your library → API → Webhook URL. The URL contains a secret key, so treat it like a password; you can create a new one at any time.

What is the Nahnu Player, and why is it the default?

Bunny's embed is an iframe from Bunny's servers, so nothing on your site can change how it looks. The Nahnu Player is this plugin's own player, rendered on your page from the same HLS stream your videos already have, and built on Plyr and hls.js, the same two libraries Bunny's player is built on. Because its controls are part of your page, your brand colors apply to it instantly, with no Bunny API involved. It has quality selection, speed, captions (from the captions you've added in Bunny), picture-in-picture, AirPlay and fullscreen. It's the default. We kept Bunny's player as an option, under Settings → Player or per embed with player="bunny", for three reasons: Bunny counts views through its own player, so plays in the Nahnu Player may not show in Bunny's statistics or this plugin's Stats column; the Nahnu Player loads the stream directly, so it can't play from a Pull Zone that blocks direct file access or enforces Token Authentication on every file; and anything set in Bunny's own player settings (watermark, custom controls, heatmap) only exists in Bunny's player. Chromecast works in both (see the next question).

Does the Nahnu Player support Chromecast?

Yes, as an option you turn on: Nahnu Video → Settings → Player → Chromecast → "Nahnu Player: add a Chromecast button". It's off by default, for one reason: casting needs Google's Cast script, and Google only allows that script to be loaded from Google's own server (www.gstatic.com), so it can't be bundled with this plugin the way the player itself is. What happens when it's on:

  • On pages with a Nahnu Player, visitors' browsers download Google's Cast script from www.gstatic.com. Like any file loaded from another site, that means Google receives the visitor's IP address and browser details, under Google's own privacy policy. Nothing is sent from your server, and nothing is loaded when the setting is off.
  • The script is only loaded where casting can work: Chrome and Edge on computers and Android. Safari and every iPhone/iPad browser never load it; they cast with AirPlay instead, which the Nahnu Player always supports.
  • A Cast button appears in the player's control bar only when a Chromecast or Google TV is found on the visitor's network.
  • Clicking it sends the video's stream address, title, poster and captions to the TV, which then plays the video straight from your Bunny Pull Zone through Google's standard media receiver. Playback continues from where the visitor was. While casting, the player shows which device is playing, with Play/pause and Stop buttons, and Stop continues on the page from where the TV left off. In a playlist, picking another video while casting sends that one to the TV.
  • Because the TV fetches the video itself, your Pull Zone has to allow cross-site requests (CORS) and must not require Token Authentication on the video stream. The Nahnu Player itself already needs the same CORS access in the browser, so if it plays on your site, that part is already in place. If a video can't be cast, the player says so.
Bunny's own player has its own, separate Chromecast setting (also under Settings → Player); that one never involves this plugin or Google's script.

Can I change the player's colors?

Yes, for the Nahnu Player. Under Nahnu Video → Settings → Player Branding set the key (accent) color, the controls color and the caption text/background colors; they apply as soon as you save. Bunny's own iframe player can't be styled from your site, so its colors are set in your Bunny dashboard (Stream → your library → Player).

Thumbnails don't load in the block editor preview. What now?

As of 1.0.2 the block editor's preview self-hosts its thumbnails and never loads them from a public URL. When the editor needs a thumbnail, WordPress downloads it from Bunny once on the server (sending your site as the referrer, like a normal page view, and signed with your Token Authentication key if you set one), keeps a small copy in wp-content/uploads/nahnu-video-thumbs/, and sends it to the editor itself through an admin-only address. Pull Zone referrer/hotlink rules, CDN or offload plugins that rewrite uploads URLs, and the editor's own frame can't get in the way. If Bunny refuses the download, the preview shows a dark image saying what Bunny answered (for example "HTTP 403"), which points straight at the Pull Zone's security settings. The copies are refreshed when a cover photo changes in Bunny and once a week otherwise, and are removed if you delete the plugin with "delete all data" on. If a thumbnail still doesn't show in the editor, turn on Settings → Block Editor → Preview diagnostics: the block then shows a notice listing each image's state and URL, which is what to send us. It's off by default and meant for debugging only. The block editor's live preview has been the one part of this plugin that's been hard to make fully reliable, while the published page your visitors see has always worked well, so most sites never need it.

How do Nahnu Video blocks look in the block editor?

The editor preview is there so you can see what your page will look like while you build it (thumbnail, size, layout, labels, grid columns, the playlist), not to watch your videos; use the published page or Preview for that. Blocks preview with the Nahnu Player, whichever player the block itself is set to, because its thumbnails are served by your own site and show reliably inside the editor. Videos never start on their own while you edit, and Chromecast is never loaded in the editor. The published page always uses the player you chose (Settings → Player, or the block's Player option). If you need to see Bunny's own player in the editor, for example while debugging, turn on Settings → Block Editor → "Use Bunny's player in the editor preview". We keep it as an option for debugging and for when we're working on the plugin, but it's best left off.

Does deleting the plugin delete my videos?

Not from Bunny. Your Bunny Stream library is never modified by this plugin, in either direction. By default, deleting the plugin also leaves your synced WordPress data (videos, categories, tags, settings) untouched. There's an opt-in "delete all data on uninstall" toggle under Settings → Advanced if you want a clean removal.

Is this an official Bunny.net plugin?

No. Nahnu Video is an independent, third-party integration built by Nahnu Plugins. It is not made by, affiliated with, or endorsed by Bunny.net.

更新日志:

1.0.2 1.0.1 1.0.0