Add Equalize Digital oEmbed Cleaner plugin with README and main functionality

Author: SteveJonesDev

README.md

@@ -0,0 +1,42 @@
+# Equalize Digital oEmbed Cleaner
+
+**Contributors:** Equalize Digital  
+**Tags:** oEmbed, cache, scheduled posts, WordPress  
+**Requires at least:** 5.0  
+**Tested up to:** 6.6  
+**Stable tag:** 1.0.0  
+**License:** GPLv2 or later  
+**License URI:** [https://www.gnu.org/licenses/gpl-2.0.html](https://www.gnu.org/licenses/gpl-2.0.html)  
+
+## Description
+
+Equalize Digital oEmbed Cleaner is a lightweight WordPress plugin that automatically removes invalid oEmbed cache entries when posts transition from **scheduled** to **published**. This ensures that broken or outdated embed previews do not persist on your site.
+
+## Features
+
+- Cleans up `_oembed_*` post meta with `{{unknown}}` values.  
+- Runs automatically when a scheduled post gets published.  
+- Helps prevent outdated or broken oEmbed caches.  
+- Simple, efficient, and does not add overhead to your site.  
+
+## Installation
+
+1. Download the plugin ZIP or clone the repository.  
+2. Upload the extracted folder to `/wp-content/plugins/equalize-digital-oembed-cleaner/`.  
+3. Activate the plugin via **Plugins > Installed Plugins** in your WordPress dashboard.  
+
+## How It Works
+
+The plugin hooks into WordPress’s `transition_post_status` action and:  
+
+- Detects when a post status changes from **scheduled** (`future`) to **published**.  
+- Removes `_oembed_*` cache entries with `{{unknown}}` values in the postmeta table.  
+
+## Changelog
+
+### 1.0.0  
+- Initial release.  
+
+## License
+
+This plugin is licensed under the **GPL-2.0+**.  

oembed-cleaner.php

@@ -0,0 +1,43 @@
+<?php
+/**
+ * Plugin Name: Equalize Digital oEmbed Cleaner
+ * Description: Cleans invalid oEmbed caches when posts transition from scheduled to published
+ * Version: 1.0.0
+ * Author: Equalize Digital
+ *
+ * @package EqualizedigitalOembedCleaner
+ */
+
+// If this file is called directly, abort.
+if ( ! defined( 'WPINC' ) ) {
+	die;
+}
+
+/**
+ * Cleans up invalid oEmbed cache entries when a post transitions from scheduled to published
+ *
+ * @param string  $new_status New post status.
+ * @param string  $old_status Old post status.
+ * @param WP_Post $post       Post object.
+ * @return void
+ */
+function eqd_clean_unknown_oembed_caches( $new_status, $old_status, $post ) {
+	// Check if post is transitioning from future (scheduled) to publish.
+	if ( 'publish' === $new_status && 'future' === $old_status ) {
+		global $wpdb;
+		
+		// Use WordPress's table references.
+		$wpdb->query( 
+			$wpdb->prepare(
+				"DELETE FROM {$wpdb->postmeta} 
+				WHERE post_id = %d 
+				AND meta_key LIKE '_oembed_%%' 
+				AND meta_value = '{{unknown}}';",
+				absint( $post->ID )
+			)
+		);
+	}
+}
+
+// Hook into WordPress with a unique function name to avoid conflicts.
+add_action( 'transition_post_status', 'eqd_clean_unknown_oembed_caches', 10, 3 );