=== ImageFeaty — Automatic Blog Covers & Social Images ===
Contributors: themicly, rkb007
Tags: featured image, og image, social image, open graph, auto generate
Requires at least: 6.2
Tested up to: 7.0
Requires PHP: 8.1
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Automatically generate beautiful, branded blog covers and social images (Featured, Open Graph, Twitter, LinkedIn) from your post content.

== Description ==

ImageFeaty turns every published post into a set of professionally branded images — no design tool required. When you publish or update a post, ImageFeaty composes a cover from the title, category, author, date, your brand logo and colours, then wires the correct Open Graph and Twitter meta tags into your site's `<head>` automatically.

It's Canva-style automation, built natively for WordPress — and it's completely free.

= Features =

* Auto-generate Featured, Open Graph, Twitter and LinkedIn images on publish.
* Six template packs: SaaS, News, Creator, Tech Split, Business Pro and a fully configurable Custom Layout.
* Design Studio with a live preview: advanced gradient presets (linear, radial and mesh), a custom backdrop image, and drag-free positioning for each element.
* Brand kit: logo, primary/secondary/accent/text colours, and font selection applied to every asset.
* Per-post controls: custom cover title (great for long headlines), template and backdrop — right in the editor (Gutenberg & Classic).
* Bulk generation for selected posts, processed in a memory-safe background queue.
* JPG / PNG / WebP output with a quality control.
* Standard sizes (1200×630, 1200×675, 1080×1080, 1920×1080) and custom sizes.
* Bundled SIL Open Font License fonts (Inter, Poppins, Montserrat) for crisp typography out of the box, or upload your own brand font (TTF/OTF).
* Automatic non-Latin support — Cyrillic, Greek and other scripts fall back to the bundled Noto Sans so titles never render as empty boxes.

= Privacy =

Image generation runs entirely on your own server using the PHP GD library. ImageFeaty makes **no external requests** — nothing about your content ever leaves your site.

= Developers =

ImageFeaty is OOP with a small DI container, a service layer, and the repository pattern. Extend it with filters: `imagefeaty_register_templates`, `imagefeaty_is_pro`, `imagefeaty_can`, `imagefeaty_excluded_post_types`, and `imagefeaty_output_meta_tags`.

== Installation ==

1. Upload the `imagefeaty` folder to `/wp-content/plugins/`, or install via *Plugins → Add New*.
2. Activate the plugin through the *Plugins* screen.
3. Visit *ImageFeaty → Settings* to set your logo, brand colours and fonts.
4. Publish a post — your covers are generated automatically.

== Frequently Asked Questions ==

= Does ImageFeaty require an external service? =
No. Image generation runs entirely on your own server with the GD library — ImageFeaty makes no external requests.

= Will it overwrite my existing featured images? =
Only if you enable "Overwrite existing" in Settings. By default ImageFeaty skips posts that already have covers.

= My text looks like a plain bitmap font. Why? =
Your server is missing FreeType support in GD, so ImageFeaty falls back to GD's built-in font. Ask your host to enable FreeType for crisp TrueType rendering.

= Can I use my own font? =
Yes. In *ImageFeaty → Settings*, set the heading font to "Custom font" and upload a TTF or OTF file. It is applied to every generated cover.

= Will non-Latin titles (Cyrillic, Greek, etc.) work? =
Yes. The bundled fonts are Latin-only, but ImageFeaty automatically detects missing glyphs and falls back to the bundled Noto Sans (Latin, Cyrillic, Greek and more). CJK and Arabic require a matching font to be installed on the server; ImageFeaty will use it automatically if present.

= Does it work with my SEO plugin? =
Yes. If your SEO plugin already outputs social meta, use the `imagefeaty_output_meta_tags` filter to let it take over, or simply disable those variants.

== Screenshots ==

1. Dashboard — generation stats, setup checklist and one-click quick generate.
2. Templates — six branded packs with live in-browser previews rendered from your brand kit.
3. Design Studio — the design engine for the Custom Layout: gradient presets, backdrop image and per-element positioning, with every template previewed live.
4. Settings — brand logo, colours and fonts, plus generation rules, image variants and output options.
5. Tools — bulk generation, regeneration and diagnostics.
6. Example generated cover.

== Changelog ==

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
First public release of ImageFeaty.
