=== OGsmith Social Cards ===
Contributors: ogsmith
Tags: open graph, social card, og image, twitter card, social sharing
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A proper social card for every post and page, made from its title and excerpt in your brand colours.

== Description ==

When someone shares a link to your site on X, LinkedIn, Facebook, Slack, WhatsApp or Discord, the preview shows an image. Most posts don't have a good one. This plugin gives every post, page and your home page a 1200×630 card generated by [OGsmith](https://ogsmith.app) from the page's own title and excerpt.

* No design work per post: template, colours, site name and logo come from your OGsmith brand defaults.
* Works alongside Yoast SEO, Rank Math and other SEO plugins: their image tags are replaced so each page has exactly one og:image.
* Signed URLs: your signing secret stays in WordPress and never appears in your pages.
* Editing a title gives the card a new URL, so platforms fetch the new version.

You need an OGsmith account. The free plan includes 500 renders a month.

= External service =

This plugin points your pages' og:image and twitter:image tags at `https://ogsmith.app/api/og`. The URL carries the page's title and excerpt, your account ID and a signature (or your API key, if you choose that option). Social platforms request the image from OGsmith when your link is shared. [Terms](https://ogsmith.app/terms) · [Privacy](https://ogsmith.app/privacy).

== Installation ==

1. Upload the plugin and activate it.
2. In OGsmith, open the dashboard and copy your Account ID and signing secret from Advanced → Signed URLs.
3. In WordPress, go to Settings → OGsmith, paste both and save. A preview of your home page card appears.

== Frequently Asked Questions ==

= Which pages get a card? =

Single posts, pages and custom post types, plus the home page (you can turn that off). Archives keep whatever tags they had. Password-protected posts are skipped.

= Can I change what goes on the card? =

Use the `ogsmith_card_params` filter. It receives an array with `title`, `subtitle` and optionally `template`; return an empty array to leave a page alone.

= A platform still shows the old image. =

Platforms cache previews. See [why previews don't update](https://ogsmith.app/blog/og-image-not-updating) and how to refresh each one.

== Changelog ==

= 1.0.0 =
* First release.
