內容簡介
Ohara 是一款專為 YouTube 頻道設計的外掛，能將頻道轉換為乾淨、快速且響應式的資訊流，並提供直觀的資訊流建構工具，讓使用者輕鬆嵌入至 WordPress 網站中。
【主要功能】
• 直觀的資訊流建構器，具即時預覽功能
• 支援多種佈局：網格、列表和磚塊
• 可重複使用的資訊流，方便編輯和嵌入
• 三種嵌入方式，包括短碼和區塊
• 影片燈箱功能，無需離開頁面即可播放
• 內建快取，管理 YouTube API 配額
外掛標籤
開發者團隊
② 後台搜尋「Ohara – Feed Builder For YouTube」→ 直接安裝（推薦）
原文外掛簡介
Ohara turns a YouTube channel into a clean, fast, responsive feed you can drop anywhere on your WordPress site — with a real feed builder instead of a wall of shortcode attributes.
Create a feed in a guided four-step wizard (Type, Source, Layout, Review), then fine-tune it in a two-pane editor: settings on the left, a live desktop/tablet/mobile preview on the right with undo and redo. When you are happy with it, copy the shortcode, insert the block, or paste a PHP snippet.
Every feed is server-rendered first, so your videos are visible to search engines and to visitors without JavaScript, and then progressively enhanced into an interactive React app in the browser.
Key features
Feed builder with live preview — see layout, color, and section changes as you make them, at three device widths, with undo/redo.
Channel feeds — the latest videos from any YouTube channel, fully functional with nothing to unlock.
Three layouts — Grid, List, and Masonry, all fully responsive.
Saved, reusable feeds — build a feed once, embed it on as many pages as you like; edit it in one place and every embed updates.
Three ways to embed — the [ohara_feed id="123"] shortcode, the Ohara YouTube Feed block, or a do_shortcode() PHP snippet for themes.
Per-feed customization — show or hide the channel header, video titles, and dates; override background, text, and accent colors.
Video lightbox — play videos in a modal without leaving the page.
Built-in caching — API responses are cached with the WordPress Transients API on a schedule you control, so you stay well inside your YouTube API quota. Clear one feed’s cache or all of them from the settings screen.
Dashboard — feed count, videos displayed, API and system health, feeds still missing a source, recent activity, and a getting-started checklist.
All Feeds screen — search, filter, and sort every saved feed, with bulk duplicate, embed, and delete.
Translation ready — all strings are localized under the ohara-feed-builder-for-youtube text domain.
Clean uninstall — removing the plugin removes its options, transients, and saved feeds.
Getting started
Install and activate the plugin.
Go to Ohara → Settings → General and paste a YouTube Data API v3 key.
Go to Ohara → All Feeds → Create Feed and follow the wizard.
Copy the shortcode from the Embed modal and paste it into any post, page, or widget.
For developers
Ohara ships a namespaced REST API under ohara/v1 and a set of filters for extending the feed types and layouts it supports:
ohara_allowed_layouts — extend the layout list beyond grid, list, and masonry.
ohara_feed_layout_renderers — register a PHP renderer for a custom layout.
ohara_feed_types — add a feed-type slug beyond the built-in channel.
ohara_feed_type_sources — register a video-fetching callable for a custom feed type.
ohara_feed_cache_args — supply the cache key for a custom feed type.
ohara_sanitize_feed_source — sanitize a custom feed type’s source value.
ohara_validate_feed_source — accept or refuse a custom feed type’s source value.
ohara_feed_schema — register additional per-feed settings, which then flow through REST, storage, rendering, and the builder UI on their own.
ohara_feed_slot_before_feed / ohara_feed_slot_after_feed — render your own markup above or below the feed, in every layout.
ohara_settings_tabs — add a screen to Ohara → Settings, rendered by a React component you register on window.oharaSettingsPanels.
Every list is validated server side, so a filter is the supported way to add your own. ohara_feed_types only ever adds to the built-in type; it cannot remove it.
The YouTube API client exposes request(), remember(), clamp_count(), and normalize_item() so an add-on’s feed type reuses this plugin’s API key, transport, and cache rather than reimplementing them.
Source code and contributing
Ohara is developed in the open. The full, human-readable source — including the uncompiled React and SASS sources behind the bundles in build/, and the build scripts used to produce them — lives at:
https://github.com/wp-shark/ohara-feed-builder-for-youtube
Bug reports, feature requests, and pull requests are welcome there. To build the plugin from a checkout, run composer install && npm install && npm run build in the plugin directory.
External services
This plugin connects to the YouTube Data API v3, a Google service, to fetch the videos and channel details it displays. This is required — without it the plugin has no video data to render.
Requests are sent to https://www.googleapis.com/youtube/v3/ (the channels and search endpoints) when a feed is rendered on the front end, when you build or preview a feed in the admin, and when you validate your API key in Settings.
Each request sends only the data needed to identify what to fetch: your YouTube Data API key, the channel ID configured on the feed, and result parameters such as the maximum number of items and the sort order. No visitor personal data, IP addresses, or site content are sent. Responses are cached in your own database so the same request is not repeated on every page load.
This service is provided by Google. By using the plugin you also agree to Google’s terms:
Google Terms of Service: https://policies.google.com/terms
Google Privacy Policy: https://policies.google.com/privacy
YouTube API Services Terms of Service: https://developers.google.com/youtube/terms/api-services-terms-of-service
Embedded video playback is served by YouTube itself and is subject to the same terms.
