=== Bitbug Meta Tags ===

Contributors: bitbugio
Tags: meta tags, open graph, favicon, social sharing, twitter card
Requires at least: 6.5
Tested up to: 6.9
Stable tag: 1.2.7
Requires PHP: 8.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add Open Graph meta tags and per-page favicons to improve social sharing and branding.

== Description ==

Bitbug Meta Tags lets you control how your site appears when shared on social networks and in browser tabs:

* **Open Graph & Twitter meta tags** — Outputs `og:title`, `og:description`, `og:url`, `og:image`, `og:type`, and `twitter:card` in the head for singular posts, pages, and the front page so links show the right title, description, and image on Facebook, Twitter, LinkedIn, etc.
* **Per-page favicons** — On any post or page you can set a custom favicon (and apple-touch-icon / tile image). When someone visits that URL, the browser tab shows your chosen icon instead of the site-wide one.
* **Front page defaults** — In Settings → General you can set a default Open Graph image for the homepage. Recommended size for the site image is 1200×675 px.
* **Per-post/page overrides** — On the edit screen for posts and pages, two side meta boxes let you choose a Custom Favicon and a Custom Open Graph Image for that content. If you don't set them, the plugin falls back to: post OG image → featured image → front page OG image → site icon → theme default-og-image.jpg.

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/bitbug-meta-tags/`, or install the plugin through the WordPress Plugins screen.
2. Activate the plugin through the Plugins screen.
3. Go to Settings → General and set the Front Page Open Graph Image if desired.
4. When editing a post or page, use the Custom Favicon and Custom Open Graph Image meta boxes in the sidebar to set per-URL values.

== Frequently Asked Questions ==

= Where do I set the default OG image for the homepage? =

Go to Settings → General and scroll to the "Front Page Meta Tags" section. Use "Select Front Page Open Graph Image" to choose the image.

= Can I use a different favicon per page? =

Yes. Edit the post or page and use the "Custom Favicon" meta box in the sidebar to select an image. When that URL is open, the browser tab will show that icon.

= What size should the Open Graph / site image be? =

Recommended size for the site image is 1200×675 px.

== Changelog ==

= 1.2.4 =
* Maintenance release.

= 1.1.0 =
* Initial release.
* Open Graph and Twitter Card meta tags for posts, pages, and front page.
* Per-page/post custom favicon and Open Graph image.
* Front page OG image setting in General options.
