README

Indexes YouTube and Vimeo videos found in WordPress post content and ACF fields as VideoObject schema markup (JSON-LD).

How it works

On save_post, the package scans post_content and all ACF fields for YouTube and Vimeo URLs (including iframe embed URLs).
For each unique video found, it fetches metadata via the platform's oEmbed API and builds a VideoObject schema.
The schemas are cached in post meta, keyed by URL. On subsequent saves, already-cached videos are reused without a new HTTP request.
On wp_head (singular pages only), the cached schemas are output as <script type="application/ld+json"> tags.

Installation

The package is available on Packagist.

composer require wefabric/wp-video-indexer:^1.0
php artisan package:discover

Requirements

PHP >= 7.4
WordPress
Themosis framework (for hook registration and service container)
wefabric/wp-support (for WPSupport::addHooks)

Supported URL formats

YouTube

Format	Example
Watch URL	`https://youtube.com/watch?v=ID`
Short URL	`https://youtu.be/ID`
Embed iframe	`https://youtube.com/embed/ID`
Legacy embed	`https://youtube.com/v/ID`

Vimeo

Format	Example
Standard URL	`https://vimeo.com/ID`
URL with query params	`https://vimeo.com/ID?fl=pl&fe=vl`
Embed iframe	`https://player.vimeo.com/video/ID`
Channel URL	`https://vimeo.com/channels/name/ID`

Structure

src/
├── Hooks/
│   └── VideoIndexerHook.php            Registers save_post + wp_head, delegates to services
├── Providers/
│   └── ServiceProvider.php             Laravel service provider (auto-discovered)
└── Services/
    ├── VideoSchemaServiceInterface.php  Contract for all platform services
    ├── VideoSchemaCacheService.php      Scans content, fetches/reuses schemas, saves to post meta
    ├── VideoSchemaOutputService.php     Reads post meta and outputs JSON-LD script tags
    ├── YouTubeSchemaService.php         YouTube oEmbed fetching and schema generation
    └── VimeoSchemaService.php           Vimeo oEmbed fetching and schema generation

Adding a new platform

Each platform is a service class implementing VideoSchemaServiceInterface:

interface VideoSchemaServiceInterface
{
    public function matches(string $url): bool;
    public function extractId(string $url): ?string;
    public function fetchSchema(string $url): array;
}

Create a new service class implementing the interface:

class DailymotionSchemaService implements VideoSchemaServiceInterface
{
    public function matches(string $url): bool
    {
        return strpos($url, 'dailymotion.com') !== false;
    }

    public function extractId(string $url): ?string
    {
        // extract ID from URL
    }

    public function fetchSchema(string $url): array
    {
        // fetch oEmbed data and return a VideoObject schema array
    }
}

protected array $services = [
    YouTubeSchemaService::class,
    VimeoSchemaService::class,
    DailymotionSchemaService::class, // add here
];

No other changes are needed.

Testing

composer install
./vendor/bin/phpunit

Tests cover matches(), extractId(), and fetchSchema() (including fallback behaviour) for each platform service. WordPress functions are mocked using Brain Monkey.

Post meta

Key	Type	Description
`_cached_video_schemas`	array	Schemas keyed by URL: `[ $url => $schema, ... ]`

Schemas are re-cached each time a post is saved. Already-cached URLs are reused without a new API call. To force a full refresh, delete the _cached_video_schemas post meta and re-save the post.

wefabric / wp-video-indexer

Maintainers

Package info

Statistics

Security