Description
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.
Ohara is a YouTube feed builder for WordPress. Show a YouTube channel feed of the latest videos as a masonry video gallery, a YouTube grid or a list, and let visitors watch in a video lightbox without leaving the page. Paste a channel and see your feed at once — no YouTube API key needed — then fine-tune it in a live preview and embed the YouTube feed with a shortcode or the block. Add a free API key later for up to 50 videos per feed and @handles.
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.
Why choose Ohara YouTube Feed Builder?
- No API Key Needed — paste a channel and your feed works; add a free API key only if you want more.
- YouTube Channel Feed — show the latest videos and Shorts from any YouTube channel, updated automatically.
- Masonry YouTube Gallery — a responsive masonry video gallery that fits videos of every size.
- YouTube Grid and List — clean grid and list layouts for a YouTube channel gallery.
- Video Lightbox — visitors play YouTube videos in a popup and stay on your page.
- Privacy Friendly — privacy-enhanced player, optional thumbnails from your own site, optional “ask before playing” notice.
- YouTube Feed Block and Shortcode — embed a YouTube feed in the block editor, any page builder, or a widget.
- Live Preview Feed Builder — build a YouTube feed visually on desktop, tablet and mobile.
- Fast and SEO Friendly — feeds refresh in the background, pages never wait for YouTube, and video markup is server-rendered.
Key features
- Works without an API key — when you create a feed, choose “Without API key” or “With API key”. Without a key, a feed shows the 15 newest videos of a channel from YouTube’s public feed: title, date, description, views and likes. With a free YouTube Data API key: up to 50 videos per feed and channel @handles. Switch a feed any time.
- 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 of any YouTube channel: videos, Shorts, or both. Named by its
UC…channel ID or a channel link, or by its handle (@elementrio) with an API key. Fully functional with nothing to unlock. - Three layouts — Grid, List, and Masonry, all fully responsive.
- Card design — four card styles (Classic, Modern, Minimal, Cinema), picture format (16:9, 4:3, 1:1, 9:16), corner radius, spacing, title below or on the picture, hover effect (lift, zoom, shine), play button shape and color, light/dark/auto color scheme, and your own background, text and accent colors.
- Video details — show or hide the channel name, titles, dates, views, likes, a description of up to 5 lines, and a “New” badge for fresh videos.
- Order and filters — newest, oldest, A–Z, most viewed or random; show only videos whose title contains a word, hide videos with a word, or hide single videos.
- Player options — play in a lightbox or open on YouTube, start muted, subtitles on.
- Privacy — videos play from youtube-nocookie.com; optionally serve the thumbnails from your own site, so visitors connect to nothing from Google before they press play; optionally ask before playing (works with Complianz, CookieYes, Cookiebot, Borlabs Cookie and Real Cookie Banner).
- Fast and reliable — feeds are stored in your database and refreshed in the background (WP-Cron). If YouTube does not answer, the last videos stay on show. Pages showing a feed are cleared from WP Rocket, LiteSpeed Cache, W3 Total Cache, WP Super Cache, SiteGround Optimizer and WP Fastest Cache when its videos change.
- Feed status — see when each feed was last refreshed and any problem YouTube reported, and refresh them all with one click.
- 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 ado_shortcode()PHP snippet for themes. - Dashboard — feed count, videos displayed, 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-youtubetext domain. - Clean uninstall — removing the plugin removes its options, stored feed data, local thumbnails, and saved feeds.
Popular uses
- YouTube channel feed on a home page or blog sidebar, always showing the newest uploads.
- YouTube video gallery for a portfolio, course, church, school or business site.
- Masonry YouTube grid for a media or vlog page.
- YouTube feed with lightbox so visitors watch videos without leaving your site.
PRO
Take your YouTube feeds to the next level with the Ohara Pro add-on. It unlocks powerful new content sources, layouts, and engagement tools while staying fully integrated with the feed builder you already know.
The Pro add-on offers:
- New feed types — Playlist, Single Videos and Multiple Channels (all also without an API key), plus Search and Live Streams (with a key).
- New layouts — Carousel, Gallery, Player with playlist (with “Up next” autoplay) and Shorts wall.
- Engagement tools — a “Load More” button and a “Subscribe” button to help you grow your audience.
- Video SEO — describe the videos to search engines with VideoObject structured data.
- Advanced customization — Custom CSS and JavaScript fields for total design control.
Unlock the full power of Ohara and upgrade to Pro today: https://wpshark.xyz/ohara/
Getting started
- Install and activate the plugin.
- Go to Ohara → Create Feed and follow the wizard. In step 2, keep “Without API key” and paste the channel ID or channel link.
- Copy the shortcode from the Embed modal and paste it into any post, page, or widget.
- Optional: add a YouTube Data API v3 key under Ohara → Settings → General for up to 50 videos per feed and @handles.
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 beyondgrid,list, andmasonry.ohara_feed_layout_renderers— register a PHP renderer for a custom layout.ohara_feed_types— add a feed-type slug beyond the built-inchannel.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 onwindow.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 shows YouTube videos, so it connects to YouTube, a Google service, in the ways below. All server requests run from your server in the background (WP-Cron) or while you work in the admin, and their results are stored in your own database, so visitors’ page views do not wait for YouTube.
YouTube public video feeds (feeds without an API key). For a feed set to “Without API key”, or when no API key is saved, your server requests https://www.youtube.com/feeds/videos.xml with the feed’s channel ID or playlist ID. Nothing else is sent; like any web request it reveals your server’s IP address to YouTube.
YouTube Data API v3 (optional, feeds with an API key). For a feed set to “With API key”, your server sends requests to https://www.googleapis.com/youtube/v3/ (the channels, search and playlistItems endpoints) with your API key, the channel the feed points at (its ID, or a handle Ohara looks up once and then remembers) and result parameters such as the number of videos. The key is also checked against this API when you save it in Settings.
Video pictures. Video thumbnails are loaded by visitors’ browsers from https://i.ytimg.com/, which reveals their IP address to Google. With “Serve thumbnails from this site” turned on (Settings → Feeds → Privacy), your server downloads each picture from i.ytimg.com once and visitors load it from your own site instead.
Video playback. The player loads only after a visitor clicks a video, from https://www.youtube-nocookie.com/ (YouTube’s privacy-enhanced mode, the default) or https://www.youtube.com/. With “Ask before playing” turned on, a notice asks the visitor first; their choice to always play is kept in their own browser, not in a cookie.
No visitor personal data or site content is sent by the plugin itself. These services are 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
WPShark news (optional). OFF by default: nothing is shown and no request is made until an administrator enables it (Ohara → Settings → Advanced, or the “Enable WPShark news” link on the Plugins screen). When enabled, a “WPShark News” dashboard widget lists WPShark blog posts and tips, dismissible news and offers may appear on the Ohara screen only (never elsewhere in wp-admin), and your site requests https://wpshark.xyz/wp-json/wpshark-hub/v1/feed about every 6 hours. The request contains no personal data, site URL, or list of plugins; like any web request it reveals your server’s IP address to wpshark.xyz. Images in notices are loaded from wpshark.xyz by the administrator’s browser.
- Service provider: WPShark — https://wpshark.xyz/
- Terms of use: https://wpshark.xyz/terms/
- Privacy policy: https://wpshark.xyz/privacy-policy/
Installation
From your WordPress dashboard
- Go to Plugins → Add New.
- Search for “Ohara Feed Builder For YouTube”.
- Click Install Now, then Activate.
Manual upload
- Download the plugin zip.
- Go to Plugins → Add New → Upload Plugin and choose the zip.
- Click Install Now, then Activate.
FTP
- Unzip the plugin and upload the
ohara-feed-builder-for-youtubefolder to/wp-content/plugins/. - Activate the plugin through the Plugins screen in WordPress.
After activating
Create your first feed from Ohara → Create Feed. No API key is needed; you can add one later under Ohara → Settings → General.
FAQ
Do I need a YouTube API key?
No. A feed set to “Without API key” reads YouTube’s public video feed for the channel. That feed holds the 15 newest videos, so a keyless feed shows at most 15, and a channel has to be given by its ID (or a link containing it), not its @handle.
With a free YouTube Data API v3 key you get up to 50 videos per feed and @handles. Create a Google Cloud project, enable the YouTube Data API v3, generate a key, and paste it into Ohara → Settings → General. Each feed then lets you choose “With API key”.
Why does my feed show only 15 videos?
It is set to “Without API key”. YouTube’s public feed holds the 15 newest videos of a channel. Add an API key and switch the feed to “With API key” in the feed editor to show up to 50.
How do I find a channel ID?
It starts with “UC”. For your own channel, YouTube shows it at youtube.com/account_advanced. For any channel: on its page, open “more” → “Share channel” → “Copy channel ID”. A link to the channel page that contains the ID works too.
How do I add a YouTube channel feed to WordPress?
Go to Ohara → Create Feed, choose “Without API key” (or “With API key” if you added one), enter the channel ID or link, pick a layout, and save. Then embed the feed with the [ohara_feed id="123"] shortcode or the Ohara YouTube Feed block.
Can I show YouTube videos in a masonry gallery?
Yes. Choose the Masonry layout in the feed builder to show your YouTube channel videos as a responsive masonry video gallery. Grid and List layouts are included too.
Does the YouTube feed have a video lightbox?
Yes. Videos open in a lightbox popup, so visitors watch them without leaving your page.
Is the YouTube feed builder free?
Yes. Channel feeds, the Grid, List and Masonry layouts, the lightbox, the block and the shortcode are all free. The Pro add-on adds more feed types and layouts.
Will this use up my API quota?
Rarely, and only for feeds set to “With API key” (feeds without a key use no quota). Feeds are stored in your database and refreshed in the background at the caching interval you choose under Ohara → Settings → Feeds, so visitors never trigger a YouTube request. A channel feed limited to videos or Shorts uses 1 quota unit per refresh.
Is it GDPR friendly?
It helps. Videos play from youtube-nocookie.com, the player loads only after a click, thumbnails can be served from your own site, and “Ask before playing” shows a notice before YouTube loads (cookie banners that already have consent are respected). Your privacy policy should still mention YouTube. See Ohara → Settings → Feeds → Privacy.
What happens if YouTube is down?
The feed keeps showing the last videos it had. Problems are listed under Ohara → Settings → Feeds → Feed status, and Ohara tries again by itself.
How do I display a feed?
Every saved feed has an Embed modal with three options: the [ohara_feed id="123"] shortcode, the Ohara YouTube Feed block, and a PHP snippet for use in theme templates.
Can I use the same feed in more than one place?
Yes. A feed is a saved, reusable record. Embed it as many times as you like; editing the feed once updates every place it appears.
Does it work without JavaScript?
Yes. Each feed is rendered as real HTML on the server first, so search engines and visitors without JavaScript still see your videos. The interactive layer loads on top of that markup.
Can I change how the feed looks?
Yes. Each feed has a card style, picture format, corner radius, spacing, title position, hover effect, play button, color scheme and colors, plus toggles for the header, titles, dates, views, likes, description and a “New” badge. For anything beyond that, use Appearance → Customize → Additional CSS or your theme’s stylesheet.
What happens to my feeds if I delete the plugin?
Deleting the plugin removes its settings, cached feed data, and saved feeds. Deactivating it leaves everything in place, so you can safely deactivate and reactivate without losing your work.
How can I contribute, or report a bug?
Development happens on GitHub at https://github.com/wp-shark/ohara-feed-builder-for-youtube — open an issue for bugs and feature requests, or send a pull request. The repository’s CONTRIBUTING.md covers coding standards, the security checklist, and what is expected in a PR.
Do I need the channel ID, or can I use the @handle?
Without an API key: the UC… channel ID, or a channel link that contains it. Ohara does not read YouTube’s web pages, so an @handle alone cannot be looked up without a key.
With an API key, the handle works too: paste the one shown on the channel page — @elementrio — and Ohara looks up the channel ID once and remembers it, so the feed keeps working even if you remove the key later. If a channel changes its handle, clear the cache under Ohara → Settings → Feeds and the new one is looked up on the next load.
Which feed types are available?
Channel — a feed of a channel’s latest videos, Shorts, or both, with or without an API key. It is built in; there is nothing in this plugin to unlock. Developers can add further feed types with the ohara_feed_types and ohara_feed_type_sources filters, and an add-on plugin may ship its own.
Which layouts are available?
Grid, List, and Masonry. Developers can register additional layouts with the ohara_allowed_layouts and ohara_feed_layout_renderers filters.
Screenshots








Changelog
1.2.0
- Added: Feeds work without a YouTube API key. Choose “Without API key” or “With API key” when you create a feed, with a list of what each can do; switch any time in the feed editor.
- Added: Channel feeds can show videos, Shorts, or both.
- Added: Card design options: card style, picture format, corner radius, spacing, title on the picture, hover effect, play button, color scheme.
- Added: Views, likes, description lines and a “New” badge on cards.
- Added: Order (newest, oldest, A–Z, most viewed, random), title word filters, and hidden videos.
- Added: Player options: open on YouTube, start muted, subtitles on.
- Added: Privacy options: privacy-enhanced player (on by default), thumbnails served from your own site, “Ask before playing” notice with cookie banner support. The former unused “GDPR mode” setting now turns on “Ask before playing”.
- Added: Feed status card with the last refresh and last error of each feed, and “Refresh now”.
- Improved: Feeds are refreshed in the background and stored, so pages never wait for YouTube and a YouTube outage keeps the last videos on show. The “Caching interval” setting now sets how often feeds refresh.
- Improved: Pages showing a feed are cleared from common page cache plugins when its videos change.
- Improved: Sharper thumbnails (srcset) with local thumbnails.
- Improved: A channel handle resolved with an API key keeps working if the key is removed.
- Improved: With an API key, views and likes now show on the cards too (one extra request per 50 videos).
- Improved: When YouTube refuses a request (for example when the daily quota is used up), the feed keeps its last videos instead of going empty.
- Improved: Feeds no longer flash a loading spinner over the videos while the page starts.
- Improved: Feeds with several sources get a multi-line source box, and a feed without a source says so clearly.
- Changed: The API key is optional everywhere: dashboard health, getting-started checklist, settings and admin notice.
- Fixed: View counts read “1.0K” in the page’s first render and “1K” after it loaded; both now read “1K”.
- Developers:
ohara_feed_cache_argsreceives the API client as a fifth argument; new filtersohara_use_rss,ohara_fetch_inline,ohara_feed_refresh_interval,ohara_purge_posts,ohara_max_videos,ohara_video_details_parts,ohara_video_details,ohara_fetched_videos,ohara_rss_item,ohara_display_settings,ohara_display_videos,ohara_card_options,ohara_card_badges,ohara_channel_header,ohara_feed_config,ohara_feed_style_props,ohara_feed_html; acardBadgesfrontend slot; new schema keyscssUnitandmountClass, thechoiceandurlsanitizers and theimagecontrol.
1.1.4
- Improved: Uninstall routine variables are prefixed, following the WordPress.org plugin guidelines.
- Improved: Translations load through WordPress’s built-in loader; the redundant manual text-domain loading was removed.
- Compatibility: Works with Ohara Pro 1.1, which no longer uses a licence key.
1.1.3
- Added: Optional “WPShark News” dashboard widget, off by default. Enable or disable it with the “Enable WPShark news” link on the Plugins screen.
1.1.2
- Added: Add Plugins Page Action & Meta links
- Fixed: API Notice-Warning Remove issue
- Added: Optional WPShark news (dashboard widget and Ohara-screen notices), off by default
1.1.1
- Added: YouTube API Create Guide component
1.1.0
- Added: YouTube channel ID and handle support
1.0.0
- Initial release.
- Feed builder with four-step create wizard and live device-responsive preview.
- Channel feed type.
- Grid, List, and Masonry layouts.
- Saved, reusable feeds with search, filter, sort, and bulk actions.
[ohara_feed]shortcode, Ohara YouTube Feed block, and PHP snippet embeds.- Per-feed header, title, date, and color options.
- Transient-based feed caching with a configurable interval and manual flush.
- Server-rendered no-JavaScript fallback markup.
