Title: Qaiyo Social Video Embed
Author: qaiyo
Published: <strong>30 julho, 2026</strong>
Last modified: 27 setembro, 2026

---

Pesquisar plugins

![](https://ps.w.org/qaiyo-social-video-embed/assets/icon-256x256.png?rev=3634093)

# Qaiyo Social Video Embed

 Por [qaiyo](https://profiles.wordpress.org/qaiyo/)

[Baixar](https://downloads.wordpress.org/plugin/qaiyo-social-video-embed.1.1.0.zip)

 * [Detalhes](https://br.wordpress.org/plugins/qaiyo-social-video-embed/#description)
 * [Avaliações](https://br.wordpress.org/plugins/qaiyo-social-video-embed/#reviews)
 *  [Instalação](https://br.wordpress.org/plugins/qaiyo-social-video-embed/#installation)
 * [Desenvolvimento](https://br.wordpress.org/plugins/qaiyo-social-video-embed/#developers)

 [Suporte](https://wordpress.org/support/plugin/qaiyo-social-video-embed/)

## Descrição

Qaiyo Social Video Embed is a modern, multi-platform video embed plugin with TikTok,
YouTube (Shorts + regular videos) and Vimeo support. Mix videos from different platforms
together in a single gallery, or automatically import the latest videos from a YouTube
channel.

**Key features:**

 * **Multi-platform** — TikTok, YouTube and Vimeo in one plugin.
 * **Mixed galleries** — Videos from different platforms together in one grid, carousel
   or list view.
 * **Gutenberg block** — Insert galleries from the editor with a live preview, no
   shortcodes needed.
 * **YouTube channel feed import** — Paste a channel URL and automatically show 
   the latest N videos or Shorts (no API key required).
 * **Lightbox / modal playback** — Optionally open videos in a fullscreen modal 
   instead of inline.
 * **Responsive column breakpoints** — Separate column counts for desktop, tablet
   and mobile.
 * **High-resolution thumbnails** — Automatic use of maxresdefault.jpg (1280×720).
 * **Automatic aspect ratio detection** — 9:16 (Shorts/TikTok), 16:9 (regular YouTube).
 * **Lazy load + click-to-play** — The iframe only loads on click, keeping pages
   fast.
 * **VideoObject structured data** — Every embedded video is described with Schema.
   org JSON-LD (title, thumbnail, player URL, upload date, duration), so search 
   engines and AI answer engines understand the page. Each video is described once
   per page; switch it off in the settings if another plugin already does this.
 * **Customizable play button** — Background and icon color configurable in the 
   admin.
 * **Resilient cache** — Metadata is cached; when a platform is down, a channel 
   gallery keeps showing the last videos it read instead of going blank, and a failing
   feed is not retried on every page view.
 * **YouTube nocookie support** — GDPR-friendly privacy-enhanced mode.
 * **4 display modes** — single, grid, carousel, list.
 * **Accessible** — Descriptive labels, keyboard support, a focus-trapped lightbox
   dialog.
 * **Dark mode** and print styles.
 * **Extensible** — Provider pattern, write your own provider.
 * **Translation ready** — Fully internationalized; translations are provided through
   translate.wordpress.org.
 * **Translation plugin compatible** — Works with WPML, Polylang, TranslatePress
   and other translation plugins.
 * **WordPress standards** — Nonce verification, capability checks, input sanitization,
   escaped output.

#### YouTube channel feed

Paste the channel’s ID-based URL (you can copy it from the channel’s About/Share
panel or from a video’s channel link):

 * `https://www.youtube.com/channel/UCxxxxxxxxxxxxxxxxxxxxxx` — the latest videos
 * `https://www.youtube.com/channel/UCxxxxxxxxxxxxxxxxxxxxxx/shorts` — the latest
   uploads shown vertically (9:16)
 * `https://www.youtube.com/user/legacyname` — legacy username channels are also
   supported

The plugin reads YouTube’s official public RSS feed (feeds/videos.xml) for that 
channel — no API key needed and no page scraping. The feed lists a channel’s latest
15 uploads. Handle URLs (`/@name`) and custom URLs (`/c/name`) cannot be resolved
without the YouTube Data API, which this plugin does not use — paste the `/channel/
UC…` URL instead. The feed does not say which uploads are Shorts, so `/shorts` shows
the latest uploads vertically rather than filtering them.

### External services

This plugin embeds videos hosted on third-party platforms. It therefore contacts
those platforms in two different ways, described below.

**1. Server-side requests (made by your site, from wp-admin or while rendering a
page)**

These resolve the metadata of the videos you add. Only the video or channel URL 
that you enter is sent; the responses are cached. No visitor data is involved.

 * YouTube (Google) — `www.youtube.com`: oEmbed endpoint (`/oembed`) for individual
   videos, and the official public RSS feed (`/feeds/videos.xml`) for channel feeds,
   using the channel ID or legacy username contained in the URL you provide.
 * Vimeo — `vimeo.com`: oEmbed endpoint (`/api/oembed.json`) for individual videos.
 * TikTok — `www.tiktok.com`: oEmbed endpoint (`/oembed`) for individual videos.
 * WordPress.org — `api.wordpress.org`: on the plugin’s “Discover Qaiyo” screen 
   only, the standard WordPress plugin API (`plugins_api`) is queried to list this
   author’s free plugins. No data about your site is sent beyond the standard API
   query.

**2. Requests made by your visitors’ browsers (when a page with the gallery is viewed)**

Video thumbnails and the video players themselves are loaded directly from the platforms.
This means your visitors’ browsers contact those platforms, and — as with any embedded
video — the platform receives the visitor’s IP address, user agent and referring
page, and may set cookies.

 * Thumbnail images — `i.ytimg.com` (YouTube), plus Vimeo’s and TikTok’s own image
   CDNs.
 * Video players (loaded only after the visitor clicks play) — `www.youtube.com`
   or `www.youtube-nocookie.com` (YouTube), `player.vimeo.com` (Vimeo), `www.tiktok.
   com` (TikTok).

To reduce this, the plugin uses click-to-play (nothing from the player is loaded
until the visitor clicks), offers YouTube’s privacy-enhanced `youtube-nocookie.com`
mode, and requests Vimeo’s Do Not Track (`dnt=1`) parameter.

This functionality is required for the plugin to display embedded videos. Provider
terms and privacy policies:
 * YouTube (Google): https://www.youtube.com/t/terms—
https://policies.google.com/privacy * Vimeo: https://vimeo.com/terms — https://vimeo.
com/privacy * TikTok: https://www.tiktok.com/legal/terms-of-service — https://www.
tiktok.com/legal/privacy-policy * WordPress.org: https://wordpress.org/about/privacy/

## Instalação

 1. Upload the `qaiyo-social-video-embed` folder to `/wp-content/plugins/`.
 2. Activate the plugin from the WordPress admin Plugins page.
 3. Navigate to **Social Video Embed** in the admin sidebar to configure appearance,
    play button, thumbnails and caching.
 4. Place a shortcode anywhere — page, post, Bricks, Gutenberg.

## Perguntas frequentes

### How do I embed a single video?

[qsve_video url=”https://youtu.be/dQw4w9WgXcQ”]

This also works with TikTok and YouTube Shorts URLs.

### How do I create a mixed gallery?

[qsve_video mode=”grid” columns=”3″ urls=”tiktok-url|youtube-url|shorts-url”]

Separate URLs with the `|` character.

### How do I import a YouTube channel feed?

[qsve_video channel=”https://www.youtube.com/channel/UCxxxxxxxxxxxxxxxxxxxxxx/shorts”
limit=”6″]

Use the channel’s ID-based URL (`/channel/UC...`). Add `/shorts` to show the latest
uploads vertically (9:16).

### Is there a block editor (Gutenberg) block?

Yes. Add the “Qaiyo Social Video Embed” block in the editor. It exposes the same
options (URLs, mode, columns, channel, lightbox, etc.) with a live preview — no 
shortcodes required.

### How do I open videos in a lightbox?

Enable “Open videos in a lightbox” in the settings, choose it under Playback in 
the block, or add `playback="lightbox"` to any shortcode. `playback="inline"` does
the opposite for one placement.

### Does Vimeo work?

Yes. Paste a Vimeo URL (e.g. `https://vimeo.com/76979871`) into the `urls` attribute
or the block. Vimeo channel/showcase import is not available.

### Does TikTok channel import work?

Not in this plugin. TikTok does not provide a public, key-less API for a profile’s
videos, so TikTok videos are added individually via the `urls` attribute.

### Does the plugin add structured data?

Yes, a Schema.org `VideoObject` for every embedded video (one `@graph` per gallery).
When the platform does not report an upload date (single YouTube and TikTok videos),
the publish date of the page is used. Developers can adjust or drop an item with
the `qsve_video_schema_item` filter and change the fallback date with `qsve_video_schema_fallback_date`.
The setting “VideoObject JSON-LD” switches it off.

### Do I need a YouTube API key?

No. The plugin uses public oEmbed and RSS endpoints, so no API key is required.

### Which shortcodes are available?

[qsve_video], `[qsve_tiktok]` (TikTok only) and `[qsve_youtube]` (YouTube only).

## Avaliações

Não há avaliações para este plugin.

## Colaboradores e desenvolvedores

“Qaiyo Social Video Embed” é um programa de código aberto. As seguintes pessoas 
contribuíram para este plugin.

Colaboradores

 *   [ qaiyo ](https://profiles.wordpress.org/qaiyo/)

Qaiyo Social Video Embed” foi traduzido para 1 localidade. Agradecemos aos [tradutores](https://translate.wordpress.org/projects/wp-plugins/qaiyo-social-video-embed/contributors)
por suas contribuições.

[Traduzir o “Qaiyo Social Video Embed” para seu idioma.](https://translate.wordpress.org/projects/wp-plugins/qaiyo-social-video-embed)

### Interessado no desenvolvimento?

[Navegue pelo código](https://plugins.trac.wordpress.org/browser/qaiyo-social-video-embed/),
consulte o [repositório SVN](https://plugins.svn.wordpress.org/qaiyo-social-video-embed/)
ou assine o [registro de desenvolvimento](https://plugins.trac.wordpress.org/log/qaiyo-social-video-embed/)
por [RSS](https://plugins.trac.wordpress.org/log/qaiyo-social-video-embed/?limit=100&mode=stop_on_copy&format=rss).

## Registro de alterações

#### 1.1.0

 * New: VideoObject JSON-LD structured data for every embedded video, with upload
   date and duration where the platform reports them (can be switched off).
 * New: a channel gallery keeps showing its last good videos when YouTube is unreachable;
   a failing feed is retried every 15 minutes instead of on every page view.
 * New: the block’s Playback setting can force inline or lightbox playback per block.
 * Fix: the player no longer loads inside the play button (invalid markup that screen
   readers announced as a button).
 * Fix: a single channel URL placed in `urls` caused a PHP notice.
 * Fix: video URLs are now encoded in oEmbed requests (a timestamp in the URL no
   longer broke the lookup).
 * Fix: switching YouTube privacy mode now applies to already cached videos.
 * Fix: unlisted Vimeo videos (with a privacy hash) now play.
 * Fix: titles with “<” were shown as “<“; “Youtube” spelling in labels.
 * Fix: the block showed its setup hint to site visitors; it is now shown to editors
   only.
 * Fix: “Clear all cache” no longer flushes the whole site’s object cache; only 
   this plugin’s entries are invalidated.
 * Fix: uninstall now removes the plugin’s data on every site of a network.
 * Accessibility: descriptive labels on every play button and player, focus moves
   into the player, the lightbox is a proper dialog that keeps keyboard focus, ARIA
   tabs on the settings screen.
 * Translations: the block editor is translated as well; a site’s own translation
   now takes precedence over the bundled one.
 * Security and code quality: admin actions check capabilities and nonces, remote
   requests use wp_safe_remote_get(), every value from a platform is validated before
   it is printed, admin screens are templates; PHPStan level 10 and a PHPUnit test
   suite.
 * Requires WordPress 6.5 or newer.

#### 1.0.0

 * First release under the Qaiyo brand.
 * TikTok, YouTube (Shorts + regular) and Vimeo support, mixed galleries and YouTube
   channel feed import.
 * Gutenberg block with live preview.
 * Lightbox / modal playback option.
 * Responsive column breakpoints (desktop / tablet / mobile).
 * Top-level Qaiyo admin menu with its own brand separator.
 * Admin UI in the Qaiyo design system (purple brand accent).
 * English source language; fully translatable via translate.wordpress.org.
 * `[qsve_video]`, `[qsve_tiktok]`, `[qsve_youtube]` shortcodes.

## Meta

 *  Versão **1.1.0**
 *  Última atualização **2 meses atrás**
 *  Instalações ativas **10+**
 *  Versão do WordPress ** 6.5 ou superior **
 *  Testado até **7.1.4**
 *  Versão do PHP ** 7.4 ou superior **
 *  Idiomas
 * [English (US)](https://wordpress.org/plugins/qaiyo-social-video-embed/) e [Spanish (Chile)](https://cl.wordpress.org/plugins/qaiyo-social-video-embed/).
 *  [Traduzir para seu idioma](https://translate.wordpress.org/projects/wp-plugins/qaiyo-social-video-embed)
 * Tags
 * [gallery](https://br.wordpress.org/plugins/tags/gallery/)[shorts](https://br.wordpress.org/plugins/tags/shorts/)
   [Tiktok](https://br.wordpress.org/plugins/tags/tiktok/)[video](https://br.wordpress.org/plugins/tags/video/)
   [youtube](https://br.wordpress.org/plugins/tags/youtube/)
 *  [Visualização avançada](https://br.wordpress.org/plugins/qaiyo-social-video-embed/advanced/)

## Classificações

Ainda não foi enviada nenhuma avaliação.

[Sua avaliação](https://wordpress.org/support/plugin/qaiyo-social-video-embed/reviews/#new-post)

[Ver todas avaliações](https://wordpress.org/support/plugin/qaiyo-social-video-embed/reviews/)

## Colaboradores

 *   [ qaiyo ](https://profiles.wordpress.org/qaiyo/)

## Suporte

Tem algo a dizer? Precisa de ajuda?

 [Ver fórum de suporte](https://wordpress.org/support/plugin/qaiyo-social-video-embed/)