対応が必要な問題が発生したとき、WebPix は調査に役立つ記録を提供します。ヘルスチェック、システム情報、読みやすいログ、サポートファイル、そして WebPix Pro では WP-CLI コマンドです。
場所: ARN WebPix → サポート(Pro)、または ARN WebPix ダッシュボードの メンテナンス カード(Free)。
ヘルスチェック(Pro)
WebPix のヘッダーには、正常、状態をチェック、要注意 のいずれかのヘルス表示が出ます。詳細は サポート → ヘルス を開き、再実行 をクリックするとチェックを繰り返せます。
| チェック | わかること |
|---|---|
| WebP エンコード | GD または Imagick で WebP を書き出せるかどうか |
| AVIF エンコード | AVIF が利用可能かどうか(AVIF 対応の Imagick、または AVIF 対応の PHP 8.1 以降の GD) |
| バックグラウンド処理 | ワーカーの次回実行時刻、遅延またはオフになっていないか、WP-Cron が無効になっていないか |
| 画像配信 | 配信方法と、最後の ページをチェック の結果 |
| ディスク容量 | サーバーの空き容量 |
| PHP メモリ | メモリ上限。大きな写真には 256 MB を推奨 |
| 動画(FFmpeg) | 動画変換が利用可能かどうか |
| 他の画像プラグイン | 他のプラグインも画像 URL を変更していないか |
サポート → システム には、WebPix、WordPress、PHP のバージョン、PHP メモリ上限、GD と Imagick の WebP・AVIF 対応状況、FFmpeg、コピー用フォルダーが表示されます。
ログとデバッグモード(Pro)
サポート → ログ には最近のログ項目が表示されます。エラーは常にログに記録されます。ダウンロード でログを保存、クリア でログファイルを削除できます。
ログ記録 では次の設定ができます:
- デバッグモード はすべての処理ステップをログに記録します。24 時間後に自動的にオフになります。
- 各変換を記録 は、デバッグモードがオンの間のみ、各変換を記録します。
- 履歴の保存期間 は、ログファイルと概要グラフの元になる変換履歴を保存する日数を設定します(既定は 30 日)。
サポートファイルをダウンロードする(Pro)
サポート ページ上部の サポートファイルをダウンロード をクリックします。このファイルにはシステム情報、WebPix の設定、統計、最近のログが含まれます。ライセンスキー、シークレット、CDN トークンが含まれることはありません。
役立つサポートリクエストを準備するには:
- 問題の再現が難しい場合は、デバッグモード をオンにして保存し、問題を再現します。
- サポートファイルをダウンロード をクリックします。
- 影響を受けたページのアドレス、行った手順、正確なエラーメッセージを控えます。
- support.arnsmart.com でチケットを作成し、サポートファイルを添付します。
ファイル検証(Pro)
WebPix Pro は、保護対象のファイルがリリースされたパッケージと一致しているかを確認します。一致しないファイルがあると、WebPix は動作を一時停止し、該当ファイルを一覧表示します。WebPix Pro パッケージを再アップロードするなどして公式ファイルを復元してから、設定 → ARN Center → ライセンス で 今すぐ検証 をクリックしてください。そこにある ファイル 列に最新の結果が表示されます。
WP-CLI コマンド(Pro)
サーバーに WP-CLI がインストールされている場合、コマンドラインからライブラリの確認と変換ができます:
wp webpix status
wp webpix scan
wp webpix convert 123 124
wp webpix convert --all
wp webpix convert --all --regenerate
statusは、出力形式、対象・変換済み・一部変換済み・未変換・失敗・スキップの画像数、カバー率、削減量を表示します。scanはディスク上のファイルを確認してライブラリの状態を更新します。変換は行いません。convertは指定した添付ファイル ID を変換します。--allは、まだ変換されていない対象画像をすべて変換します。--force(--allと併用)は、最新のコピーがある画像も再エンコードします。--regenerateは既存のコピーを先に削除し、現在の設定で作り直します。
承認待ちで保留中のメディアはスキップされます。
メンテナンスツール(Free)
WebPix Free ダッシュボードの メンテナンス カードには、3 つのツールがあります。
- 統計を更新 は統計情報を更新します。
- 一覧を再計算 はメディアライブラリを再スキャンします。
- 古いログを削除 は、このプラグインのログのうち 30 日より古いものを削除します。
WebPix を削除したときの動作
WebPix を無効化しても何も変わりません。データが削除されるのはプラグインを 削除 したときだけで、しかも事前にそのように選択した場合に限ります。
WebPix Pro(サポート → WebPix を削除したとき):
- 設定と統計を削除(初期設定はオフ):削除時に、WebPix はこのサイト上のテーブル、オプション、メディアフォルダー、Media AI データ、ライセンスを削除します。
- WebP/AVIF コピーも削除(初期設定はオフ、上記オプションが必要):
uploads/arn-nextgenフォルダーを削除します。 - 元のファイルには一切手を加えません。画像のバックアップと透かしのクリーンコピーは保持されます。
- 設定と統計を削除 がオフの場合、ライセンスは保持されます。同じサイトに WebPix を再インストールすると、新しいアクティベーションコードなしで有効になります(Pro 3.0.2。それ以前のバージョンでは削除のたびにライセンスが削除されていました)。マルチサイトネットワークでは、いずれかのサイトでこのオプションがオンになっていればライセンスが削除されます。
WebPix Free(ダッシュボードの 最適化設定):
- アンインストール時にプラグインデータを削除(初期設定はオフ):削除時に、設定、統計、メディアフォルダーを削除します。
- WebP/AVIF コピーも削除(初期設定はオフ、上記オプションが必要):
uploads/arn-image-optimizer内のコピーを削除します。 - 元の画像や他のプラグインのデータは削除されません。共有の ARN Free AI 設定は、インストール済みの他の ARN Free プラグインがそれを使用していない場合にのみ削除されます。
注意: WebPix Pro を削除する前に、不要になった透かしを削除してください(プラグインを削除しても透かしは消えません)。また、クラウドへのアップロード後にローカルファイルを削除した場合は、ファイルを戻す を実行し、完了するまでお待ちください。