=== Per-Post Open Graph Image ===
Contributors: snehalpancholi
Tags: open graph, og image, social share, twitter card, meta tags
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

Set an exact Open Graph and Twitter Card share image per post, overriding the featured image.

== Description ==

Per-Post Open Graph Image adds a media-picker meta box to any supported post type so you can choose the precise social-sharing image for each piece of content, independent of the featured image.

The plugin outputs `og:image`, `og:image:width`, `og:image:height`, and `twitter:image` meta tags in `wp_head` at priority 1, ensuring the tags land early in the HTML head.

**Features:**

* Per-post OG/Twitter image via the native WordPress media uploader
* Falls back to the post's featured image, then a global default image you configure
* Enable on any combination of public post types
* Outputs `og:image`, `og:image:width`, `og:image:height`, and `twitter:image`
* Priority-1 `wp_head` hook so tags appear before most other plugins
* Lightweight — zero external libraries

== Installation ==

1. Upload the `per-post-og-image` folder to `/wp-content/plugins/`
2. Activate through **Plugins > Installed Plugins**
3. Go to **Settings > OG Image** to choose a fallback image and enable post types
4. Edit any post — use the **Open Graph / Share Image** sidebar meta box to pick a custom share image

== Frequently Asked Questions ==

= Will this conflict with Yoast SEO or All in One SEO? =
Both plugins also output `og:image`. To avoid duplicate tags, either disable the OG image output in those plugins or leave this plugin as the sole source of truth.

= Where does the meta box appear? =
In the post editor sidebar under **Open Graph / Share Image** — visible on all enabled post types.

= What image size is recommended? =
1200 × 630 pixels in JPEG or PNG is the ideal Facebook/Twitter share image size.

== Changelog ==

= 1.0.0 =
* Initial release.

== Screenshots ==

1. Meta box in the post editor sidebar with media picker button and thumbnail preview.
2. Settings page — default fallback image and post-type selection.
