=== Schwarttzy's Open Graph ===
Contributors: schwarttzy
Plugin URI: https://schwarttzy.com/schwarttzys-open-graph/
Tags: open-graph, social-media, meta-tags, facebook, linkedin, twitter-cards, seo, social-media-optimization, wordpress-plugin, social-preview, website-metadata, social-media-integration, open-graph-protocol, wordpress-social-media
Requires at least: 5.2
Tested up to: 6.9
Stable tag: 1.1
Requires PHP: 7.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Adds Open Graph meta tags to WordPress posts, pages, and the front page to enhance social media sharing.

== Description ==

Schwarttzy's Open Graph is a lightweight WordPress plugin that automatically adds Open Graph meta tags to your website’s posts, pages, and front page. These tags optimize content sharing on social media platforms like Facebook, LinkedIn, and Twitter by providing rich previews with titles, descriptions, and images.

**Key Features:**
- Automatically adds Open Graph meta tags for posts, pages, and the front page.
- Uses post/page title, featured image, excerpt (or content trimmed to 300 characters), and permalink.
- Supports a configurable default image URL for when no featured image is set.
- Simple, lightweight, and easy to use with minimal configuration.

== Installation ==

1. Upload the `schwarttzys-open-graph` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Navigate to **Settings > Schwarttzy’s Open Graph** to configure the default image URL (e.g., https://example.com/default-image.jpg).

== Frequently Asked Questions ==

= How do I set a default image? =
Go to **Settings > Schwarttzy’s Open Graph** and enter the full URL of your default image (e.g., https://example.com/default-image.jpg). This image is used when a post or page lacks a featured image.

= What meta tags are added? =
The plugin adds the following Open Graph meta tags:
- `og:title`: Post/page title or site name (front page).
- `og:description`: Excerpt or content trimmed to 300 characters (posts/pages), or site description (front page).
- `og:image`: Featured image or default image URL.
- `og:url`: Post/page permalink or home URL.
- `og:type`: "article" (posts/pages) or "website" (front page).
- `og:site_name`: Site name.
- `og:locale`: Site locale for internationalization.
- `article:published_time`: Post publication date (posts/pages only).

= Does this plugin work with SEO plugins? =
It may conflict with plugins like Yoast SEO or Rank Math that also add Open Graph tags, leading to duplicates. Consider disabling Open Graph features in those plugins or using this clean, simple alternative for focused social media sharing.

= Can I use my own images? =
Yes, upload an image to your server and enter its full URL in the **Settings > Schwarttzy’s Open Graph** page.

== Screenshots ==

1. The settings page under **Settings > Schwarttzy’s Open Graph** where you can configure the default image URL featuring Mousse, the chocolate lab.

== Changelog ==

= 1.1 =
* Added og:locale meta tag for better internationalization.
* Improved description trimming to 300 characters for optimal social previews.
* Added admin notice for conflicts with other SEO plugins, suggesting this simple alternative.
* Updated "Tested up to: 6.9".
* Enhanced code comments for better maintainability.

= 1.01 =
* Updated version number format to 1.01.
* Added styling to settings page via admin.css.
* Clarified description trim length (55 words) in documentation.

= 1.0 =
* Initial release.

== Upgrade Notice ==

= 1.1 =
Update for WordPress 6.9 compatibility, improved meta tags, and conflict handling with SEO plugins.

= 1.01 =
Minor update with standardized version number, improved settings page styling, and clarified documentation.

= 1.0 =
Initial release. No upgrades available yet.

== Other Notes ==

- Ensure your theme includes `<?php wp_head(); ?>` in its `header.php` file for meta tags to render.
- Test shared links using tools like the [Facebook Sharing Debugger](https://developers.facebook.com/tools/debug/).
- This plugin focuses on simplicity and does not support archive pages or advanced image uploaders.

== Support ==

For support, visit the [WordPress.org support forum](https://wordpress.org/support/plugin/schwarttzys-open-graph/) or contact the author at [https://schwarttzy.com/contact-me/](https://schwarttzy.com/contact-me/).