=== Video Thumbnail Auto-Grab ===
Contributors: snehalpancholi
Tags: video, thumbnail, youtube, vimeo, featured image
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 8.1
Stable tag: 1.0.0
License: GPL-2.0+
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Automatically fetches and stores YouTube/Vimeo thumbnails when you save a post with a video embed.

== Description ==

Video Thumbnail Auto-Grab detects the first YouTube or Vimeo URL in your post content when you save, retrieves the video poster thumbnail from the provider's API, imports it into your media library, and optionally sets it as the featured image.

**Features**

* Supports YouTube (watch, embed, shorts, youtu.be) and Vimeo.
* Prefers HD (maxresdefault) with graceful fallback to standard quality.
* Imports thumbnail as a media attachment — available everywhere in WordPress.
* Optionally auto-sets the imported thumbnail as the post's featured image.
* Stores video ID and provider in post meta for theme/plugin use.
* Admin column in the post list shows the fetched thumbnail at a glance.
* No API keys required for YouTube; uses Vimeo's public v2 API for Vimeo.

== Installation ==

1. Upload the `video-thumbnail-auto-grab` folder to `/wp-content/plugins/`.
2. Activate via **Plugins > Installed Plugins**.
3. Go to **Settings > Video Thumbnail Auto-Grab** to configure options.

== Frequently Asked Questions ==

= Does it require API keys? =
No for YouTube. Vimeo thumbnails are fetched via the public Vimeo v2 API which does not require authentication.

= Where is the thumbnail stored? =
As a standard WordPress media attachment attached to the post. The attachment ID is saved in `_vtag_thumbnail_id` post meta.

= Will it overwrite a featured image I set manually? =
No. The "Set as Featured Image" option only runs when no featured image exists yet.

== Changelog ==

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
First release.
