Buoy Video Sync – Import YouTube Videos, Playlists & Channels as Posts
| 开发者 | martincipriano |
|---|---|
| 更新时间 | 2026年10月23日 21:02 |
| PHP版本: | 8.0 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Buoy Video Sync brings your YouTube channel to WordPress — import YouTube videos, playlists, and channel data as WordPress posts. Point it at a channel, choose what to sync and which post type to save it as, and Buoy Video Sync creates posts complete with titles, descriptions, thumbnails, view counts, and other YouTube metadata. Whether you want to embed a YouTube channel on your site, build a video gallery from synced posts, or mirror your uploads as blog content, the sync runs on your terms.
Run a sync once, immediately after you save the rule, or set it to repeat automatically — hourly, daily, weekly, monthly, or on a custom interval — so new content keeps flowing in without you lifting a finger.
Features
- Sync from a YouTube channel
- Three sync actions: import new videos, import new playlists, or import the channel itself
- Save synced items as any post type you choose (Posts, or a custom post type)
- Recurring schedules — run a rule once on demand, or automatically hourly, daily, weekly, monthly, or on a custom interval via WP-Cron
- Quota estimation — see how many YouTube Data API units a sync will use before you run it, including a per-day estimate for recurring schedules
- Thumbnails shown as the featured image when none is set; channel profile pictures and banners are downloaded into your media library
- Sync history with the last-synced time and a per-rule error log
- Stores all YouTube data in standard post meta (
_buoyvs_*) for easy use in your theme or queries [buoy-video-sync]shortcode and three Gutenberg blocks (Field, Image, Embed) to display synced titles, descriptions, stats, thumbnails, and the YouTube player anywhere on your site — no code required- Delete channel — clear the configured channel and its sync history in one click when you want to start over or point at a different channel
- Optional "remove all data on uninstall" setting — your content stays unless you ask for it to be removed
- Sync from unlimited YouTube channels
- Update existing posts — refresh all metadata, or only the fields you choose, on the same schedule
- Taxonomy assignment — file synced items into categories, tags, and custom taxonomy terms
- Field mapping — map YouTube fields (including each thumbnail size) to your own custom meta keys
- Filter conditions — sync only the items that match your rules
- Video protection — stop syncs from overwriting your manual edits
安装:
- Upload the
buoy-video-syncfolder to the/wp-content/plugins/directory, or install it from Plugins → Add New. - Activate the plugin through the Plugins screen in WordPress.
- Go to Buoy Video Sync → Settings and enter your Google API key.
- Go to Buoy Video Sync → Channels and add a YouTube channel.
- Add a sync rule to the channel — pick an action, a schedule, and a destination post type — then save to import.
- Visit Google Cloud Console.
- Create a project and enable the YouTube Data API v3.
- Generate an API key under Credentials.
- Paste the key into Buoy Video Sync → Settings.
屏幕截图:
常见问题:
Does Buoy Video Sync upload video files to my site?
No. Buoy Video Sync imports metadata (title, description, thumbnail URL, view counts, and so on) and saves it in WordPress. The video files stay on YouTube. Channel profile pictures and banners are downloaded into your media library; video and playlist thumbnails are displayed from the URLs YouTube serves them at.
Where do synced items go?
You choose. Each sync rule has a destination post type, so videos, playlists, and channels are saved as the post type you select — Posts or any public custom post type.
How often does it sync?
You choose per rule. Run it once, immediately after saving, or set it to repeat automatically — hourly, daily, weekly, monthly, or on a custom interval — via WordPress's built-in cron system. A recurring rule keeps importing new videos, playlists, or channel data on its own; it does not go back and refresh posts already imported. Refreshing existing posts on a schedule is available in Buoy Video Sync Pro.
Why do I need a Google API key?
YouTube data is fetched from the official YouTube Data API v3, which requires a key. The key is yours and stays on your server; Buoy Video Sync never sends your data to a third party.
How much API quota does a sync use?
Each API call costs 1 quota unit. Importing from a channel needs at least 2 calls (channel data plus playlist items), and roughly 1 more call per 50 videos for metadata. Google provides 10,000 free units per day. Buoy Video Sync shows an estimate before you run a sync.
Can I switch to syncing a different channel?
Yes. Edit the Channel field on the Channels page and save — the plugin resolves the new URL/@handle/ID and switches to it, keeping your existing sync rules attached to the new channel. To stop syncing entirely, use the Delete channel button at the bottom of the channel card, which also clears its sync history.
What happens to my data if I uninstall Buoy Video Sync?
By default your synced posts and settings are kept. If you want everything removed, enable Remove all Buoy Video Sync data when the plugin is deleted in Buoy Video Sync → Settings before deleting the plugin.
更新日志:
3.4.0
- Changed: Export and import now live on their own Export/Import tab on the Settings page, instead of the Channels page.
- Changed: The API, Content and Advanced settings are combined into one General tab.
- New: Import and export your channel and sync rules as a JSON file from the Channels page.
- New: Choose the post status (published, draft, pending, private) for each sync rule, with a default in the channel settings.
- New: Synced posts are labelled YouTube Video, Playlist, or Channel in post lists, with a Sync Type column.
- New: Synced posts are attributed to the user who created the sync rule.
- New: Developer hooks —
buoyvs_before_sync,buoyvs_after_sync,buoyvs_import_item,buoyvs_before_post_insert, andbuoyvs_post_meta. - Fixed: Deleting, reordering, or editing rules no longer mixes up their status, schedule, or history — every rule now has a permanent ID.
- Fixed: Changes saved while a sync is running are no longer overwritten when it finishes.
- Fixed: A sync with errors now shows "Failed" with its error messages instead of "Success".
- Fixed: Rules stuck on "Syncing" (for example when WP-Cron isn't running) are reset with an explanation.
- Fixed: Rules that create Pending or custom-status posts no longer re-import the same playlists and channel on every run, and trashed items are no longer re-imported.
- Fixed: Deleting the Free plugin after upgrading to Pro no longer erases your settings and channel setup.
- Fixed: A fatal error on the comment edit screen.
- Fixed: Videos longer than a day now get the correct duration.
- Fixed: Blocks now work inside a Query Loop.
- Improved: Recurring syncs use less API quota by stopping once they reach already-imported videos.
- Improved: Accessibility — the video embed has a title, and the featured-image preview is a keyboard-usable button.
- Improved: Help tabs and admin messages now work on translated sites.
- Improved: Channel lookup only contacts YouTube addresses.
- New: Recurring sync schedules — hourly, daily, weekly, monthly, or a custom interval — are now available in the Free plugin. Previously every rule could only run once, on save.
- Changed: "Go further with Pro" now highlights refreshing existing posts (metadata updates), taxonomy assignment, field mapping, and filter conditions instead of recurring schedules.
- Fixed: Restored the "Copy shortcode" button on the video, playlist, and channel metaboxes — it was missing even though the
[buoy-video-sync]shortcode itself has always been a Free feature.
- Fixed: Added horizontal padding to the Pro upgrade banner so its content no longer touches the edges on narrow screens.
- New: Added a "Go further with Pro" section to the plugin description, a Pro mention in the "How often does it sync?" FAQ, and Free-vs-Pro links in the Help tabs on the Channels and Settings screens.
- New: Added disabled Pro feature previews (recurring schedules, taxonomy assignment, field mapping, and filter conditions) to the sync rule screen, the add-rule wizard, and the channel Settings tab, so Free users can see what Pro adds.
- Changed: the shortcode is now registered as
[buoy-video-sync]instead of[buoyvs_video_sync], and the unprefixed[video-sync]back-compat alias has been removed — WordPress.org plugin review requires every registered tag to use a unique, distinct name.
- Security: the block editor's post-selector REST endpoint now checks read access to each returned post individually, instead of relying on a blanket
edit_postscheck — draft/private synced posts no longer leak titles to users who can't otherwise read them. - Changed: the
[video-sync]shortcode is now registered as[buoyvs_video_sync]for uniqueness;[video-sync]still works as a back-compat alias.
- Changed: Renamed to Buoy Video Sync (previously WPBuoy Video Sync) per WordPress.org naming requirements — plugin slug, text domain, and internal identifiers updated accordingly.
- Fixed: The "Delete channel" button did nothing after confirming — the Save button's
name="submit"attribute shadowed the form's nativesubmit()method, so the form silently failed to send.
- New: "Delete channel" button on the Channels page — clears the configured channel and its sync history, so you can start over or switch to a different channel without manually resetting the plugin.
- New:
[video-sync]shortcode and three Gutenberg blocks (Field, Image, Embed) to display synced titles, descriptions, stats, thumbnails, and the YouTube player anywhere on your site. - Fixed: Uninstalling with "remove all data" enabled now also removes synced playlist posts (previously only videos and channels were detected).
- New: Channel profile pictures and banners are now downloaded into the media library and attached to the channel post, instead of being referenced from YouTube's CDN.
- Improved: Uninstall now also removes the channel configuration, per-channel sync history, plugin transients, and — when the "remove all data" setting is enabled — all synced posts and their attachments.
- Improved: Internal code and documentation cleanup.
- Standardized internal code naming for consistency across WPBuoy plugins.
- Simplified the single-channel architecture and removed unused legacy code. No changes to features or settings.
- New:
buoyvs_metabox_tabsfilter for adding custom tabs to the video, playlist, and channel metaboxes.
- New: Action hooks fire after each video, playlist, and channel is synced —
buoyvs_video_synced,buoyvs_playlist_synced,buoyvs_channel_synced.
- Maintenance release.
- Fixed: The channel History badge now counts only unread sync errors and clears when you open the History tab.
- New: Option to use the YouTube thumbnail as the post featured image (enabled by default) — disable it to keep your own featured images.
- Fixed: Channel posts now reliably display their profile image (removed image sideloading that failed on extension-less YouTube CDN URLs).
- Improved: Documented the YouTube image CDN in the readme's External services section, per WordPress.org review feedback.
- Improved: Added an "External services" section to the readme documenting the YouTube Data API v3 usage, in line with WordPress.org plugin guidelines.
- Fixed: Sync history status icons now render as inline SVG and no longer load an external font, removing the Google Fonts (Material Icons) dependency for full WordPress.org compliance.
- New: Paste a channel URL or @handle in the Channel field — Buoy Video Sync resolves it to the channel ID automatically (supports channel URLs, @handles, /user/ and /c/ URLs, and video links).
- Improved: The Settings page shows a generic "Settings saved." notice and no longer re-validates the API key when it hasn't changed.
- New: In-plugin Help tabs linking to the Buoy Video Sync knowledge base on every admin screen.
- Improved: WordPress.org coding-standards compliance — prepared SQL statements, output escaping, and translator comments.
- Improved: Tested up to WordPress 7.0.
- Sync new videos, new playlists, or channel data from a YouTube channel.
- Choose any post type as the destination for synced items.
- Run-once sync with a pre-sync API quota estimate.
- Thumbnail import with featured-image fallback.
- Per-rule sync history and error logging.