mer-vin-article-video-upload

name: mer-vin-article-video-upload description: Upload an MP4 to mer.vin WordPress and embed it in a published article with a Gutenberg wp:video block. Use when the user provides a local video path, asks to add video to an article, praisonaiwp media upload, wp media import, or wp:video on mer.vin. disable-model-invocation: true

mer.vin — upload video to article

How mer.vin handles article media

WordPress root: /home/hestiaadmin/web/mer.vin/public_html

Always run WP-CLI with --allow-root on hestia.

Gutenberg block (required shape)

Match existing mer.vin articles (e.g. post 50671, 50442):

<!-- wp:heading -->
<h2 class="wp-block-heading">Short video walkthrough</h2>
<!-- /wp:heading -->

<!-- wp:paragraph -->
<p>Optional one-line intro before the player.</p>
<!-- /wp:paragraph -->

<!-- wp:video {"id":ATTACHMENT_ID} -->
<figure class="wp-block-video"><video controls src="ATTACHMENT_URL"></video></figure>
<!-- /wp:video -->

Use --no-block-conversion semantics: raw block markup in post_content, not bare HTML.

Path A — Mac + praisonaiwp (preferred)

When the video is on the Mac and praisonaiwp is installed:

# 1. Upload to Media Library (parent = article)
praisonaiwp media upload /path/to/video.mp4 --post-id=ARTICLE_ID --server default

# 2. Note attachment ID + URL from output, then update content
praisonaiwp update ARTICLE_ID --no-block-conversion --post-content "$(cat article-with-video.html)"

See docs/create-post-workflow-simple.md and migration-markdown/mer.vin/posts/2025/2025-12-20-praisonaiwp-post-creation-guide.md.

Path B — Server WP-CLI (agent on hestia)

Local Mac paths (/Users/…) are not visible on hestia. Copy the file first:

# Mac
scp /Users/praison/praisonaippt/examples/heygen-50590-video-audio-heygen-images.mp4 \
  hestia:/tmp/heygen-50590-video-audio-heygen-images.mp4

Then on server:

cd /home/hestiaadmin/web/mer.vin/public_html
bash .cursor/skills/mer-vin-article-video-upload/scripts/upload-video-to-article.sh \
  /tmp/heygen-50590-video-audio-heygen-images.mp4 \
  50590 \
  "Short video walkthrough"

Script behaviour:

1. Resolve article by numeric ID or slug/URL.
2. wp media import with --post_id set to the article.
3. Insert heading + optional paragraph + wp:video block before ## At a glance if present, else append before closing content.
4. Skip if the same attachment URL is already in content.

Resolve article ID from URL

wp post list --name=dreaming-outcomes-and-webhooks-claude-managed-agents-update-may-2026 \
  --field=ID --allow-root
# → 50590

Section placement conventions

Do not replace an existing announcement clip unless the user asks. Add a separate section for composite walkthrough videos.

HeyGen article videos (related, not the same)

• _mer_heygen_video_attachment_id — HeyGen talking-head MP4 sideloaded by mu-plugin; used on Shorts CPT, not auto-embedded in article body.
• PraisonAIPPT composite (heygen-50590-video-audio-heygen-images.mp4) is a separate deck export — upload via this skill into post_content.

Verify

wp post get ARTICLE_ID --field=url --allow-root
wp post get ARTICLE_ID --field=post_content --allow-root | grep -A2 'wp:video'
curl -sI "ATTACHMENT_URL" | head -1   # expect HTTP/2 200

Open the live URL in a browser; confirm the player loads and controls work.

Common failures

Additional detail

See reference.md for full example (article 50590) and REST alternative.