Transient Inspector Mini

A lightweight, single-file transient cache inspector and cleaner built for modern WordPress development and performance debugging.

WordPressの管理画面から、wp-optionsテーブルに蓄積された一時キャッシュ（Transient）を一瞬で可視化・一括破棄できる、1ファイル完結型の超軽量デバッグツールです。開発環境でのAPI通信デバッグや、本番環境でのキャッシュ詰まり解消を安全かつ高速に行うために設計されています。

Key Features

• Single-File Architecture: Zero external dependencies, pure PHP, and fully self-contained in a single lightweight file.
• High-Performance Scanning: Optimally maps transient keys and expiration timestamps in just two queries, ensuring zero frontend/backend lag even with thousands of rows.
• Human-Friendly Expirations: Parses raw timestamps into readable countdowns (e.g., "X hours Y minutes" or "[Expired]").
• Bulk Action Support: Delete individual transients or purge selected records simultaneously using the WordPress-native bulk action UI.
• Developer Safety: Built-in WP Nonce verification and rigorous capability checks (manage_options) to ensure secure operation.

主な機能（日本語）

• 1ファイル完結アーキテクチャ: 外部依存なし、純粋なPHPのみで構成された、単一ファイルで動作するプラグインです。
• 高速なスキャン処理: Transientの値と有効期限をわずか2回のクエリでマッピングし、データが大量にある環境でも動作を重くしません。
• 直感的な残り時間表示: 生のタイムスタンプを「X時間Y分」や「[期限切れ]」といった、人間がひと目で理解できる形式に変換して表示。
• 一括操作（バルクアクション）に対応: 個別の削除ボタンに加え、WordPress標準のチェックボックスを利用した複数キャッシュの一括破棄が可能です。
• 開発者向けの安全設計: WP Nonceによるセキュリティ検証と、管理者権限（manage_options）チェックを徹底した安全な設計。

Features Overview / 機能概要

Admin Features / 管理画面機能

• Centralized Transient dashboard / ツールメニュー内でのキャッシュ一元管理
• Human-readable expiration countdown / 残り時間のカウントダウン表示
• Value snippet preview / シリアライズされた値や長い文字列の簡易プレビュー

Security & Operations / セキュリティと操作

• Bulk delete processing / チェックボックスによる一括削除
• Full Nonce security verification / 悪意あるリクエストを防ぐセキュリティトークン検証
• Zero Database Polluting / 有効化・無効化時にDBを一切汚さないクリーン設計

Installation / インストール

1. Upload the plugin file to your /wp-content/plugins/ directory. (wp-content/plugins/ ディレクトリにプラグインファイルをアップロードします)
2. Activate the plugin through the 'Plugins' menu in WordPress. (管理画面の「プラグイン」メニューから有効化してください)
3. Navigate to Tools > Transient Inspector to monitor and manage your transient cache. (管理画面の「ツール > Transient Inspector」からキャッシュの監視と管理を行えます)

Technical Details

Menu Location

Tools > Transient Inspector (tools.php?page=transient-inspector-mini)

Technology Stack

• WordPress (Transient API, WP_List_Table UI styling, WP DB Layer)
• Pure PHP (Single-file Class Structure, Recursive/Mapping optimization)

Roadmap / 今後の予定

• [ ] AJAX-powered instant deletion without page reload / ページリロードなしのAJAX高速削除
• [ ] Individual transient value detail viewer (JSON/Array popup) / 値の詳細を確認できるポップアップビューア
• [ ] Filter by prefix/plugin name / プラグインやプレフィックスごとの絞り込み機能
• [ ] One-click "Purge All Expired" button / 「期限切れキャッシュのみ全削除」ボタンの追加
• [ ] Transient size calculation / 各キャッシュのデータ容量（バイト数）の算出表示

Developer Info / 開発者情報

• Author: masato shibuya (Image-box Co., Ltd.)
• GitHub: https://github.com/ms13th-cyber/
• License: MIT License