Plugin Docs

Introduction

apiJAV is a WordPress system that lets you host videos on one WordPress site and import and display them on another — automatically, with full metadata, taxonomy support, and permanent embed URLs.

How It Works

The system works as a source-destination pair. Your server site holds the original video posts. Your client site pulls them via REST API and creates local WordPress posts with all metadata preserved.

Server Site (My Video API Manager)
  └─ Hosts original video posts
  └─ Exposes REST API at /wp-json/myvideo/v1/
  └─ Generates permanent embed tokens

  ↕ REST API calls over HTTPS

Client Site (My Video Public API)
  └─ Browses server via admin panel
  └─ Imports posts with full meta + taxonomies
  └─ Stores embed URL permanently in post meta
  └─ Theme renders iframe from stored meta

Features

• Browse & Search — filter by category, tag, actor, studio, date, views
• Bulk Import — import by page range (e.g. page 26 → 1), 1000 videos per page
• Import All — one-click import of all available videos
• Duplicate Detection — single SQL batch query checks thousands of IDs instantly
• Live Progress — real-time progress bar, per-row status, pause/resume/cancel
• Auto Page Switch — table view automatically follows the currently importing page
• Cache Control — configurable transient cache + one-click clear
• Taxonomy Sync — categories, tags, actors, studios all created locally on import

Client Plugin — Installation

Install My Video Public API on the WordPress site where you want to import and display the videos.

Connecting to the Server

In Video API → Settings, enter the full URL of your server site — no trailing slash, no /wp-json path. The plugin appends the REST API path automatically.

✅ Correct:
https://myserver.com
https://videos.example.com

❌ Wrong:
https://myserver.com/          # trailing slash
https://myserver.com/wp-json   # don't add the path

Browse Videos

The Browse Videos page lets you search and filter the server's videos and import them one at a time.

• Search — filter by keyword, category, tag, actor, studio
• Import button — each card has an ⬇ Import button. Already-imported videos show a green ✅ Imported overlay
• Batch check — imported status is checked in a single database query per page load, not per video
• Preview — click ▶ Preview to open the player modal before importing

Bulk Import

The Bulk Import page lets you import thousands of videos with a single click. It runs sequentially — one video at a time — to avoid server overload.

Step 1 — Choose Filter

Select a category, tag, and/or studio to narrow the import, or leave all blank to import everything. Set videos per page (up to 1000 if your server supports it).

Click Load Video Info to see the total video count and page count. This automatically clears any stale cache so you always get accurate numbers.

Step 2 — Set Page Range

Set From Page and To Page. The import always runs from the highest page number down to the lowest — meaning oldest-first, newest-last.

Or click ⚡ Import All Pages to queue every page automatically.

Step 3 — Start Import

Click ▶ Start Import. The system will:

1. Load all pages in the queue sequentially
2. Check which videos are already imported (batch SQL query)
3. Build a flat queue of only new videos
4. Import them one by one with 150ms between each
5. Auto-update the table view as each page completes

Import Speed

Import by ID

Go to Video API → Import by ID to import a single video by its remote post ID. You can preview the player before importing.

Remote Post ID: 12345
→ Fetches from: https://server.com/wp-json/myvideo/v1/posts/12345
→ Creates local post with all meta + embed URL

Imported Posts

The Imported Posts page shows all locally imported videos. From here you can:

• Edit — open the WordPress post editor
• Play — open the embed URL in a new tab
• Refresh All Embeds — re-fetches embed URLs from the server (only needed if server secret keys changed)

Meta Fields

Each imported post gets these WordPress post meta fields, which your theme can read:

Example Theme Usage

// Output the embed in your single.php or template
$embed = get_post_meta( get_the_ID(), 'embed', true );
if ( $embed ) {
    echo $embed; // outputs the full <iframe> tag
}

// Or get the plain URL
$url = get_post_meta( get_the_ID(), 'embed_url', true );
$thumb = get_post_meta( get_the_ID(), 'thumb', true );
$views = get_post_meta( get_the_ID(), 'post_views_count', true );

Caching

API responses are cached using WordPress transients. The cache duration is set in Video API → Settings.

• Browse Videos — cached per unique filter combination
• Bulk Import — always fetches fresh (cache bypassed)
• Embed URLs / Player — never cached, always fresh
• Filter options — cached 6 hours

To clear all cached data, go to Video API → Settings → Clear Cache. The Bulk Import "Load Video Info" button also clears the posts cache automatically before fetching.

Taxonomies

On import, the plugin maps server taxonomies to local WordPress taxonomies:

FAQ

Why does the page count change after I change per_page?

The total page count is calculated as ceil(total_videos / per_page). With 25,631 videos at 1000/page you get 26 pages. At 100/page you get 257 pages. Always click Load Video Info after changing the per-page setting to get the updated count — the button also clears stale cache automatically.

Can I run multiple bulk imports at the same time?

It's not recommended. Two parallel imports on the same site may cause duplicate detection to miss posts that are mid-import. Run one at a time.

What happens if an import fails midway?

Already-imported videos are safe — they're in your database. The failed item shows a red ❌ Error badge. You can click Resume or re-run the same range — all previously imported videos will be detected and skipped.

Are embed URLs permanent?

Yes. The server generates embed tokens that never expire. They are safe to store in your WordPress database permanently. The only reason to use Refresh Embeds is if the server's WordPress secret keys were regenerated.

My categories/tags dropdown is empty

Go to Video API → Settings → Clear Cache and then reload the Bulk Import page. The filter dropdowns sample up to 1,000 posts from the API — if your server is new and has few posts, the lists may be sparse.