內容簡介
Nahnu Video For Bunny Stream 外掛可將您的 WordPress 網站與 Bunny Stream 影片庫連接，讓您能夠輕鬆地在文章和頁面中插入影片，無需手動編碼，並提供多種短碼和區塊選項，提升使用便利性。
【主要功能】
• 手動或定期同步 Bunny Stream 影片庫
• 使用 WordPress 分類和標籤組織影片
• 提供多種短碼：[bunny_video]、[bunny_grid]、[bunny_playlist]
• 區塊編輯器支援 Nahnu Video 區塊
• 影片控制管理介面，便於管理和編輯
• 短碼生成器，實時預覽和複製功能
外掛標籤
開發者團隊
② 後台搜尋「Nahnu Video For Bunny Stream (Bunny.net)」→ 直接安裝（推薦）
原文外掛簡介
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
Syncs your Bunny Stream library into WordPress, either manually or on a schedule.
Organizes videos with real WordPress categories and tags, so you get related-video filtering and grid shortcodes for free.
[bunny_video] shortcode: a single video, Bunny’s own player with optional label/note overlays.
[bunny_grid] shortcode: a 1 to 6 column responsive grid, filterable by category or tag.
[bunny_playlist] shortcode: one live main player with a click-to-switch thumbnail grid below it, like a YouTube playlist.
A “Nahnu Video”, “Nahnu Video Grid”, and “Nahnu Video Playlist” block for the block editor, with a searchable video picker and live preview, no shortcode syntax to remember.
A Video Control admin screen: thumbnails, live search, one-click shortcode copy, and category/tag editing.
A dedicated Shortcode Generator page: pick a video (or videos, for a grid or playlist), set every option, live preview, copy.
Autoplay, loop, muted, and preload are real site-wide settings, overridable per embed. Bunny’s own player handles everything else natively.
Two players: the Nahnu Player (the default), rendered on your page from the same HLS stream and built on Plyr and hls.js like Bunny’s player, with your brand colors; or Bunny’s own iframe embed. Choose per site, per shortcode, or per block.
Player Branding: your key color, control color and caption colors apply to the Nahnu Player instantly.
An optional Bunny webhook, so new uploads, finished encodes and changes show up within seconds instead of at the next sync.
A developer integration API: other plugins that upload videos to Bunny Stream (an offload plugin, an upload form, a course builder) can import, refresh, or remove one video by its GUID right away. See “For Developers” below.
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.
External services
This plugin connects your WordPress site to Bunny.net‘s Stream product, a paid, third-party video hosting and delivery service. Bunny.net is required for this plugin to function; you’ll need your own Bunny Stream account and video library.
What is sent, and when
When you enter your Library ID, Stream API Key, and Pull Zone under Nahnu Video → Settings and click Test Connection, those credentials are sent to Bunny’s API (video.bunnycdn.com) to confirm they’re valid.
When you click Sync Now (or an automatic sync runs, if enabled), your Library ID and API Key are sent to Bunny’s API to retrieve your video list (titles, durations, thumbnails, view counts, and Bunny’s internal video IDs), which is then stored in your WordPress database.
If you enable watch-time Statistics, refreshing stats sends your Library ID, API Key, and a specific video’s ID to Bunny’s statistics API to retrieve view/watch-time data.
When another plugin on your site uses this plugin’s integration API to import or refresh a specific video (for example right after it uploads that video to Bunny), your Library ID, API Key, and that video’s ID are sent to Bunny’s API to fetch that one video’s details. While the video is still encoding, the same request is repeated a few times over the following hour until it’s ready.
For the block editor’s preview, your server downloads each video’s thumbnail from your Pull Zone once, when an editor first needs it (sending your site’s address as the referrer, and using the Token Authentication key if you set one), and keeps a small copy in wp-content/uploads/nahnu-video-thumbs/. Only signed-in editors are served these copies.
With the Nahnu Player, a visitor’s browser loads the HLS stream, captions and thumbnail directly from your *.b-cdn.net Pull Zone, the same as Bunny’s player does; the player itself (Plyr and hls.js, bundled with this plugin) is served from your own site, never from a third-party CDN.
If you add this plugin’s webhook URL in your Bunny dashboard, Bunny sends a small notification to your site (the library ID, the video’s ID, and a status number) whenever a video changes. Your site then fetches that video’s details from Bunny’s API as above. Nothing is sent to Bunny by setting this up; you add the URL in Bunny yourself, and can remove it there at any time.
None of the above happens unless you’ve entered credentials and explicitly triggered the action (or turned on auto-sync, set up the webhook, or installed a plugin that uses the integration API yourself). This plugin never sends your site’s content, user data, or visitor data to Bunny.
What visitors’ browsers connect to directly
When a site visitor views a page containing an embedded video (via [bunny_video], [bunny_grid], [bunny_playlist], or the block editor equivalents), their own browser loads the video player and thumbnails directly from Bunny’s servers (player.mediadelivery.net and your *.b-cdn.net Pull Zone), the same as it would for any embedded video from any provider. This means the visitor’s IP address and standard browser request data reach Bunny directly, not through this plugin or your server.
Bunny.net’s own terms and privacy policy govern how they handle this data:
Bunny.net Terms of Service
Bunny.net Privacy & Data Policy
Google Cast (optional, off by default)
Only if you turn on Settings → Player → “Nahnu Player: add a Chromecast button”: on pages with a Nahnu Player, visitors’ browsers (Chrome and Edge on computers and Android only) load Google’s Cast sender script from https://www.gstatic.com/cv/js/sender/v1/cast_sender.js. Google requires this script to be loaded from its own server, so it can’t be bundled with the plugin. Loading it sends the visitor’s IP address and standard browser request data to Google. When a visitor chooses to cast, their browser sends the video’s stream URL, title, poster image URL and caption URLs to their own Cast device, which then loads the video directly from your Bunny Pull Zone. Your server sends nothing to Google. With the setting off (the default), nothing is loaded from Google.
Google Cast SDK Additional Developer Terms of Service
Google Privacy Policy
Google Terms of Service
For Developers
Everything below is also documented, with copyable examples, under Nahnu Video → Usage in your dashboard.
Integration API, for plugins that put videos into Bunny Stream
If your plugin uploads videos to Bunny Stream itself (an offload plugin, an upload form, a course builder), tell Nahnu Video about each one by its Bunny GUID and it shows up right away instead of at the next sync. Every call fetches the video’s real data from Bunny with Nahnu Video’s own API key, so your plugin only says which video to look at. Nahnu Video never deletes or changes anything in Bunny.
Check it’s available (and pointed at the same library) first:
if ( function_exists( 'nahnu_video_api_version' ) && version_compare( nahnu_video_api_version(), '1.0', '>=' ) && nahnu_video_library_id() === $my_library_id ) { ... }
Right after uploading a video to Bunny:
$post_id = nahnu_video_import( $guid, array( 'library_id' => $library_id, 'source' => 'my-plugin', 'attachment_id' => $attachment_id ) );
Returns the Nahnu Video post ID or a WP_Error. All arguments after $guid are optional; source and attachment_id are saved on the post so both plugins can link to each other. While Bunny is still encoding, Nahnu Video checks back automatically (after 1, 2, 5, 10, 15, 30 and 60 minutes) until the thumbnail and duration are final.
Functions:
nahnu_video_import( $guid, $args ): import or update one video now. Returns post ID or WP_Error.
nahnu_video_refresh( $guid, $args ): re-pull one already-imported video. Pass 'import_if_missing' => true to import it if it isn’t there yet.
nahnu_video_remove( $guid, $args ): move a video’s post to the Trash after you deleted it from Bunny.
nahnu_video_get_post_id( $guid ): post ID for a GUID, 0 if not imported. Imports nothing.
nahnu_video_get_guid( $post_id ): the GUID stored on a post.
nahnu_video_get_post_id_by_attachment( $attachment_id ): the post imported with that attachment_id.
nahnu_video_library_id(): the Bunny Library ID Nahnu Video is connected to.
nahnu_video_api_version(): the integration API version (currently 1.0), separate from the plugin version.
nahnu_video_webhook_url(): the Bunny webhook URL. It contains a secret key, so only show it to administrators.
nahnu_video_render( $guid_or_post_id, $args ): the same HTML as [bunny_video]. Also accepts the full attribute array, as before.
Fire-and-forget actions (they do nothing if Nahnu Video isn’t active, so your plugin doesn’t need to depend on it):
do_action( 'nahnu_video_import_guid', $guid, $args )
do_action( 'nahnu_video_refresh_guid', $guid, $args )
do_action( 'nahnu_video_remove_guid', $guid, $args )
When you pass library_id in $args, any GUID from a different library is refused instead of silently failing later.
Actions Nahnu Video fires
nahnu_video_loaded( $api_version ): everything is loaded and ready.
nahnu_video_synced( $post_id, $bunny_video, $is_new, $args ): one video was created/updated by a sync, import or refresh. $args['context'] says which.
nahnu_video_sync_completed( $result ): a full sync finished (created, updated, skipped, removed, total, manual).
nahnu_video_removed( $post_id, $guid, $context ): a post was moved to the Trash because its video is gone from Bunny.
nahnu_video_deleted( $guid, $post_id, $attachment_id ): a post is about to be permanently deleted. Nahnu Video never deletes the video in Bunny; that choice is yours.
nahnu_video_webhook_received( $guid, $status, $payload ): an authenticated Bunny webhook arrived for this library.
Also: nahnu_video_stats_refreshed, nahnu_video_term_added, nahnu_video_term_removed, nahnu_video_before_render.
Filters
nahnu_video_bunny_credentials( $credentials ): supply the Library ID and API key from another plugin so they aren’t entered twice. Only fill in empty values, so what’s typed into Settings still wins.
nahnu_video_should_import( $should, $bunny_video, $existing_id, $args ): return false to skip a video.
nahnu_video_insert_post_args( $post_args, $bunny_video, $is_new, $args ): change the post data before it’s saved, e.g. use the Media Library attachment’s title instead of Bunny’s file name.
nahnu_video_remove_missing_on_sync( $enabled ): return false to keep videos that no longer exist in Bunny.
nahnu_video_refresh_retry_delays( $delays, $guid ): seconds between “still encoding?” checks. An empty array turns them off.
nahnu_video_webhook_imports_new( $import, $guid ): return false so the webhook only refreshes existing videos.
nahnu_video_player_mode( $mode, $atts ): force ‘nahnu’ or ‘bunny’ for an embed.
nahnu_video_local_player_options( $options, $video ): change what one Nahnu Player receives (HLS URL, poster, captions, playback flags).
nahnu_video_cast_sdk_url( $url ): change where Google’s Cast script is loaded from (when Chromecast is on).
nahnu_video_editor_local_thumbnails( $enabled ): return false to make the editor preview load thumbnails from the CDN again.
nahnu_video_is_editor_preview( $is_preview ): whether a render is treated as a block editor preview (no lazy-loading, no hover video).
nahnu_video_html( $html, $video, $atts ): change the final embed HTML for a video.
Also: nahnu_video_render_args, nahnu_video_grid_render_args, nahnu_video_grid_html, nahnu_video_embed_params, nahnu_video_cdn_urls, nahnu_video_query_args, nahnu_video_stats, nahnu_video_can_edit_terms, nahnu_video_default_settings.
REST endpoints
GET /wp-json/nahnu-video/v1/stats/{id} and GET /wp-json/nahnu-video/v1/stats: public, read-only play count and watch time.
POST /wp-json/nahnu-video/v1/bunny-webhook?key=...: receives Bunny Stream webhooks. Requires the secret key from Settings. The payload is only used to learn which video changed; that video’s data is always re-fetched from Bunny.
Other functions
nahnu_video_render_grid(), `nahnu_video_get_video_data()`, `nahnu_video_query()`, `nahnu_video_get_related()`, `nahnu_video_get_stats()`, `nahnu_video_get_top_videos()`, `nahnu_video_refresh_stats()`.
Known Limitations
* Block editor previews: in 1.0.0 and 1.0.1, thumbnails in the Nahnu Video / Grid (with Hover Preview on) and Playlist blocks could fail to load in the editor’s live preview. From 1.0.2 the preview uses local copies of the thumbnails instead of the CDN (see the FAQ), and an optional diagnostics notice (Settings → Block Editor) shows exactly why if one still fails. The published page was never affected.
* It needs direct access to the HLS stream, so Pull Zones with “Block Direct URL File Access” or Token Authentication on every path need the Bunny player. Bunny’s view counts come from Bunny’s player, so Nahnu Player plays may not be counted. Chromecast in the Nahnu Player is an opt-in setting because it loads Google’s Cast script (see the FAQ).
This is a free plugin maintained in our spare time, and the block editor is still newer ground for us than shortcodes. The front end has always worked well, so we’re not worried about it; if you’d like to help with the editor preview, turn on Settings → Block Editor → Preview diagnostics and send us what the notice shows.
