OG Pilot Dynamic Open Graph Images

Açıklama

OG Pilot Dynamic Open Graph Images helps you create branded social preview images for every URL on your site. Connect via OAuth, choose a template, and automatically generate Open Graph images for blog posts, landing pages, and WooCommerce products. Override per post when needed, output complete Open Graph + X/Twitter meta tags, and keep existing images live even when generation is paused.

Core capabilities:
* 3-step setup wizard for faster onboarding after activation.
* OAuth connection flow (PKCE) for secure account linking.
* Site-wide defaults for template, title, description, logo URL, image URL, and colors.
* Per-post/page/product overrides with dynamic placeholder support.
* Rule-based template selection (post/page/product + taxonomy rules).
* Outputs comprehensive Open Graph and X/Twitter meta tags, including article-specific and WooCommerce product-specific fields.
* Meta ownership mode to avoid duplicate tags with SEO plugins.
* Live social preview UI in wp-admin (Facebook, LinkedIn, X/Twitter).
* Per-entry generated image preview in the editor sidebar.
* Supports publicly available OG Pilot templates for WordPress: page, blog_post, podcast, portfolio, book, event, product, company, and github.
* Optional auto-generation on content save.
* Non-blocking background generation with processing fallback image + retry scheduling.
* Optional cache busting toggle to force a daily image refresh cycle.
* Bulk regenerate queue with in-admin progress updates.
* One-click import of existing social fields from Yoast, Rank Math, and AIOSEO.
* Diagnostics panel with endpoint health, token status, and latest API errors.
* Role-aware UX: admins manage plugin settings; editors can override per-entry templates.
* WooCommerce-aware placeholders ({{product_price}}, {{product_short_description}}, etc.).
* Graceful subscription handling: when trial/subscription is inactive, new image generation is paused while existing OG images keep working.

Supported placeholders:
* {{post_title}}
* {{excerpt}}
* {{site_name}}
* {{post_url}}
* {{author_name}}
* {{author_avatar_url}}
* {{publish_date_iso}}
* {{featured_image_url}}
* {{product_price}}
* {{product_short_description}}
* {{episode_date}}
* {{event_date}}
* {{event_location}}
* {{book_author}}
* {{book_series_number}}
* {{book_genre}}
* {{company_logo_url}}
* {{github_contributions}}

Service details:
* This plugin is a SaaS integration. OG image generation is provided by OG Pilot.
* Terms of Service: https://ogpilot.com/terms
* Privacy Policy: https://ogpilot.com/privacy

No usage tracking is performed by this plugin beyond required OAuth and image-generation API calls.

External services

OG Pilot API

This plugin connects to the OG Pilot API (https://ogpilot.com) to generate dynamic Open Graph images for your content.

What data is sent:
* OAuth authorization data (account email, site URL) during the initial connection flow.
* Image generation payloads containing template name and the fields you configured (e.g., post title, excerpt, author name, logo URL, colors) each time an image is generated or regenerated.
* Token refresh requests to maintain the OAuth connection.

When data is sent:
* When you connect your site to OG Pilot via OAuth.
* When a post/page/product is saved with auto-generate enabled.
* When you manually trigger image generation or force refresh.
* When bulk regeneration is run.
* When the plugin checks subscription status.

This service is provided by OG Pilot: Terms of Service | Privacy Policy.

Bunny Fonts

This plugin loads web fonts from Bunny Fonts (https://fonts.bunny.net) for the admin preview UI in the WordPress dashboard.

What data is sent:
* Standard HTTP request data (IP address, user agent) is sent to the Bunny Fonts CDN when the admin settings/preview page is loaded.

When data is sent:
* When an admin user views the OG Pilot settings page or post editor metabox that includes the social image preview.

No personal content or site data is transmitted to Bunny Fonts. Only standard browser request headers are sent to load font files.

This service is provided by BunnyWay d.o.o.: Terms of Service | Privacy Policy.

Dynamic OG Image Examples

The examples below mirror the payload style used in og-pilot-plugins/og_pilot_ruby/README.md, adapted to fields you set in this plugin.

Page

{
  "template": "page",
  "title": "Acme Robotics Product Updates",
  "description": "See what shipped this week across the web app.",
  "logo_url": "https://www.google.com/s2/favicons?sz=128&domain_url=https%3A%2F%2Fwww.notion.so",
  "image_url": "https://images.unsplash.com/photo-1558655146-d09347e92766?w=1400&q=80",
  "bg_color": "#0B1220",
  "text_color": "#F8FAFC"
}

Blog Post

{
  "template": "blog_post",
  "title": "How Stripe Reduced Checkout Abandonment by 18%",
  "logo_url": "https://www.google.com/s2/favicons?sz=128&domain_url=https%3A%2F%2Fstripe.com",
  "image_url": "https://images.unsplash.com/photo-1460925895917-afdab827c52f?w=1400&q=80",
  "author_name": "Maya Patel",
  "author_avatar_url": "https://api.dicebear.com/7.x/avataaars/svg?seed=MayaPatel",
  "publish_date": "2026-02-24",
  "bg_color": "#0F172A",
  "text_color": "#F8FAFC"
}

Podcast

{
  "template": "podcast",
  "title": "Indie Hackers Podcast: Pricing Experiments That Worked",
  "logo_url": "https://www.google.com/s2/favicons?sz=128&domain_url=https%3A%2F%2Fwww.spotify.com",
  "image_url": "https://images.unsplash.com/photo-1478737270239-2f02b77fc618?w=1400&q=80",
  "episode_date": "2026-02-21",
  "bg_color": "#18181B",
  "text_color": "#FAFAFA"
}

Product (WooCommerce-friendly)

{
  "template": "product",
  "title": "Allbirds Tree Dasher 3",
  "logo_url": "https://www.google.com/s2/favicons?sz=128&domain_url=https%3A%2F%2Fwww.allbirds.com",
  "image_url": "https://images.unsplash.com/photo-1542291026-7eec264c27ff?w=1400&q=80",
  "unique_selling_point": "Free shipping + 30-day returns",
  "bg_color": "#F8FAFC",
  "text_color": "#0F172A"
}

Event

{
  "template": "event",
  "title": "Launch Week Berlin 2026",
  "logo_url": "https://www.google.com/s2/favicons?sz=128&domain_url=https%3A%2F%2Fwww.eventbrite.com",
  "image_url": "https://images.unsplash.com/photo-1540575467063-178a50c2df87?w=1400&q=80",
  "event_date": "2026-06-12/2026-06-14",
  "event_location": "Station Berlin",
  "bg_color": "#1E1B4B",
  "text_color": "#F5F3FF"
}

Book

{
  "template": "book",
  "title": "Designing APIs for Humans",
  "description": "A practical handbook for product-minded engineers.",
  "logo_url": "https://www.google.com/s2/favicons?sz=128&domain_url=https%3A%2F%2Fwww.oreilly.com",
  "image_url": "https://images.unsplash.com/photo-1512820790803-83ca734da794?w=1400&q=80",
  "book_author": "Alex Turner",
  "book_series_number": "2",
  "book_genre": "Technology",
  "bg_color": "#172554",
  "text_color": "#EFF6FF"
}

Portfolio

{
  "template": "portfolio",
  "title": "Maya Chen • Product Designer",
  "description": "Fintech UX, design systems, and prototyping.",
  "logo_url": "https://api.dicebear.com/7.x/avataaars/svg?seed=MayaChen&size=64",
  "image_url": "https://images.unsplash.com/photo-1557672172-298e090bd0f1?w=1400&q=80",
  "bg_color": "#1F2937",
  "text_color": "#F9FAFB"
}

Company

{
  "template": "company",
  "title": "Notion",
  "description": "4 job openings",
  "logo_url": "https://www.google.com/s2/favicons?sz=128&domain_url=https%3A%2F%2Fwww.notion.so",
  "company_logo_url": "https://www.google.com/s2/favicons?sz=256&domain_url=https%3A%2F%2Flinear.app",
  "bg_color": "#111827",
  "text_color": "#F9FAFB"
}

GitHub Activity

{
  "template": "github",
  "title": "rails/rails",
  "description": "Recent merged PRs, reviews, and commit activity.",
  "github_accent_color": "#22C55E",
  "bg_color": "#0B1220",
  "text_color": "#E5E7EB",
  "github_contributions": "[{\"date\":\"2026-02-16\",\"count\":7},{\"date\":\"2026-02-20\",\"count\":12},{\"date\":\"2026-02-24\",\"count\":9}]"
}

For templates that support custom images, you can run both styles:
* With custom image: set image_url.
* Without custom image: leave image_url empty.