Buoy Video Sync
| 开发者 | martincipriano |
|---|---|
| 更新时间 | 2026年7月30日 00:20 |
| PHP版本: | 8.0 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Buoy Video Sync imports content from a YouTube channel into WordPress. 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.
Every sync runs once, immediately after you save the rule — so you stay in control of when content is imported.
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)
- On-demand imports — each rule runs immediately when you save it, so you decide exactly when content is imported
- Quota estimation — see how many YouTube Data API units a sync will use before you run it
- 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
- Recurring schedules — hourly, daily, weekly, monthly, or a custom interval
- Update existing posts — refresh all metadata, or only the fields you choose
- 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 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?
Every rule runs once, immediately after you save it. To import again later — for example after publishing new videos — re-enable the rule and save, and it picks up anything new. Recurring schedules (hourly, daily, weekly, monthly, or custom) are 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.1.1
- 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.