Queue Image Optimizer

大量の画像を安全に最適化できるWordPressプラグイン。非同期キュー処理により、サーバー負荷を分散し、バックグラウンドで画像圧縮を実行します。

特徴

• 外部APIなし - ローカルで完結（Imagick/GD使用）
• 高速処理 - ダッシュボード表示中は並列Ajax処理
• バックグラウンド継続 - ブラウザを閉じてもWP-Cronで処理継続
• サイズ増加防止 - 圧縮でサイズが増える場合は自動で元に戻す

アーキテクチャ

graph TB
    subgraph WordPress
        A[メディアライブラリ] --> B[QIO_Queue]
        B --> C[QIO_Compressor]
        C --> D{エンジン}
        D -->|優先| E[Imagick]
        D -->|フォールバック| F[GD Library]
    end

    subgraph 処理方式
        G[ダッシュボード表示中] -->|並列Ajax| H[高速処理]
        I[ブラウザ非表示] -->|WP-Cron| J[低速処理]
    end

    subgraph データ
        K[(wp_qio_queue)]
        L[(wp_qio_stats)]
        M[(postmeta)]
    end

    B --> K
    C --> L
    C --> M

処理フロー

sequenceDiagram
    participant U as ユーザー
    participant D as ダッシュボード
    participant Q as QIO_Queue
    participant C as QIO_Compressor
    participant DB as Database

    U->>D: スキャン開始
    D->>Q: scan_unoptimized_images()
    Q->>DB: 未最適化画像を検索
    DB-->>Q: 画像リスト
    Q-->>D: スキャン結果

    U->>D: 圧縮開始
    D->>Q: add_to_queue()
    Q->>DB: キューに追加

    loop 並列Ajax処理（3リクエスト）
        D->>Q: process_batch()
        Q->>DB: pending→processing
        Q->>C: compress()
        C->>C: Imagick/GD圧縮
        alt サイズ削減成功
            C-->>Q: 成功
        else サイズ増加
            C->>C: 元ファイルに復元
            C-->>Q: 成功（変更なし）
        end
        Q->>DB: completed更新
        Q-->>D: 進捗返却
    end

    D-->>U: 完了表示

状態遷移

stateDiagram-v2
    [*] --> idle: プラグイン有効化

    idle --> scanned: スキャン実行
    scanned --> idle: 画像なし
    scanned --> processing: 圧縮開始

    processing --> paused: 一時停止
    processing --> completed: 全件完了

    paused --> processing: 再開
    paused --> idle: リセット

    completed --> idle: 新規スキャン

動作要件

インストール

方法1: ZIPアップロード

1. ReleasesからZIPをダウンロード
2. WordPress管理画面 > プラグイン > 新規追加 > アップロード
3. 有効化

方法2: Git Clone

cd wp-content/plugins
git clone https://github.com/t-hirai03/Queue-Image-Optimizer.git queue-image-optimizer

使い方

1. 管理画面 > Queue Image Optimizer にアクセス
2. 「スキャン開始」で未最適化画像を検出
3. 「圧縮を開始」でバックグラウンド処理開始
4. ページを開いたままにすると高速処理

処理モード

圧縮品質

フック

アクション

// 全処理完了時
add_action( 'qio_completed', function( $progress ) {
    // 通知送信など
});

フィルター

// JPEG品質を変更
add_filter( 'qio_jpeg_quality', function( $quality ) {
    return 80;
});

// 特定画像をスキップ
add_filter( 'qio_skip_image', function( $skip, $attachment_id ) {
    if ( get_post_meta( $attachment_id, '_skip_optimization', true ) ) {
        return true;
    }
    return $skip;
}, 10, 2 );

CI/CD

ライセンス

GPL v2 or later