=== PostMeta Viewer – Custom Fields Inspector ===
Contributors: wpwebguru, vivekkumarsahu0
Tags: custom fields, post meta, acf, debugging, developer tools
Requires at least: 5.6
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A powerful debugging tool for WordPress developers to inspect and analyze post meta (custom fields) across posts, pages, and custom post types.

== Description ==

**PostMeta Viewer** is an essential utility for WordPress developers who work with custom fields and post meta. Whether you're using Advanced Custom Fields (ACF), Pods, Toolset, or custom-coded meta fields, this plugin provides a clean and developer-friendly interface to explore, search, and analyze post meta data across your site.

It is designed strictly as a **read-only inspection tool**, making it safe for production environments.

= Key Features =

* **Complete Post Meta Overview**  
  Browse all posts with total custom field counts.

* **Detailed Meta Inspection**  
  View all meta keys and values for any individual post.

* **Powerful Search & Filtering**
  – Search across post titles, content, meta keys, and meta values  
  – Filter by post type, post status, and date range  
  – Filter by specific meta key existence  
  – Filter by meta value type (string, array, JSON, numeric, empty)

* **Post Edit Screen Meta Box**  
  View custom fields directly inside the post edit screen.

* **Developer-Friendly Data Display**  
  Proper formatting for serialized, array, and JSON meta values.

* **Post Statistics**  
  Quick insights into total posts and filtered results.

* **Responsive Admin UI**  
  Works smoothly across all screen sizes.

= Ideal For =

* **ACF Developers** – Debug and verify stored ACF field data  
* **Plugin Developers** – Inspect custom meta added by plugins  
* **Theme Developers** – Validate custom field implementations  
* **Site Debugging** – Identify and resolve metadata issues  
* **Migration Projects** – Analyze existing meta structures  
* **Learning WordPress** – Understand how post meta works internally

== Installation ==

= Automatic Installation =

1. Go to **Plugins <span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji">→</span></span> Add New** in your WordPress admin
2. Search for **PostMeta Viewer**
3. Click **Install Now**
4. Activate the plugin

= Manual Installation =

1. Download the plugin ZIP file
2. Go to **Plugins <span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji">→</span></span> Add New <span aria-hidden="true" class="wp-exclude-emoji"><span aria-hidden="true" class="wp-exclude-emoji">→</span></span> Upload Plugin**
3. Upload the ZIP file and click **Install Now**
4. Activate the plugin

= FTP Installation =

1. Unzip the downloaded file
2. Upload the `postmeta-viewer` folder to `/wp-content/plugins/`
3. Activate **PostMeta Viewer** from the Plugins screen

== Usage ==

= Getting Started =

1. After activation, go to **PostMeta Viewer** (top-level menu)
2. View a list of all posts along with their custom field counts
3. Use search and filter options to narrow results
4. Click **View Details** to inspect meta for a specific post

= Using Search & Filters =

1. **Search Box** – Search across post titles, content, meta keys, and values  
2. **Post Type Filter** – Filter posts, pages, or custom post types  
3. **Meta Key Filter** – Filter by existing meta keys  
4. **Date Range** – Filter posts by creation date  
5. **Post Status** – Published, draft, pending, etc.  
6. **Value Type Filter** – String, array, JSON, numeric, or empty  
7. Click **Apply Filters** to update results

= Viewing Meta Details =

1. Click **View Details** from the main list
2. View a table of all meta keys and values
3. Serialized and complex data is displayed in readable format
4. Use **Back to List** to return

= Post Edit Screen Meta Box =

1. Edit any post or page
2. Locate the **Custom Fields Inspector** meta box
3. Instantly view all custom fields for that post
4. Ideal for quick debugging during content editing

== Frequently Asked Questions ==

= Is this plugin safe for production sites? =
Yes. The plugin is read-only and does not modify or delete any data.

= Does it work with Advanced Custom Fields (ACF)? =
Yes. It displays the raw meta data stored by ACF.

= Can I edit meta values using this plugin? =
No. This plugin is intended for inspection and debugging only.

= Does it affect site performance? =
No. It runs only in the WordPress admin area when actively used.

= Can I export post meta data? =
Export functionality is not available yet but is planned for future releases.

= Is there a display limit for posts? =
Pagination is enabled with 20 posts per page by default for optimal performance.

== Screenshots ==

1. Main Interface – Post list with custom field counts and filters  
2. Meta Details View – Complete meta data for a single post  
3. Post Edit Meta Box – Custom fields inside the editor  
4. Filtered Results – Search and filter results in action  

== Changelog ==

= 1.0 =
* Initial release
* Full post meta overview
* Advanced search and filtering
* Detailed meta inspection
* Post edit screen meta box
* Support for all post types and statuses

== Upgrade Notice ==

= 1.0 =
Initial release.

== License ==

This plugin is licensed under the GPL v2 or later.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or any later version.

This program is distributed without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose.