TTSWPは主要なキャッシュプラグインすべてに対応しています。WP Rocket、LiteSpeed Cache、W3 Total Cache、WP Super Cache、Cache Enablerなど多数が含まれます。プラグインはJavaScriptファイルとCSSファイルをキャッシュ除外リストに自動で追加します。
TTSWPが自動構成する内容
サポート対象のキャッシュプラグインが検出されると、以下の設定が適用されます。
- TTSWPのJSファイルは「ミニファイ/結合しない」としてマーク(プレーヤーの破損を防止)
- TTSWPのCSSファイルは通常どおり結合を許可
- TTSWPのアドミンバーメニュースクリプトは常に最新版を配信(リアルタイムのプラン変更を反映するため)
- 音声ファイル(MP3)はHTMLページキャッシュに含めない(専用の有効期限ヘッダーを使用)
手動設定は不要です。TTSWPを有効化すると自動で機能します。
サポートするキャッシュプラグイン(テスト済み)
- WP Rocket
- LiteSpeed Cache
- W3 Total Cache
- WP Super Cache
- Cache Enabler
- Hummingbird
- Swift Performance
- Autoptimize
設定変更後のキャッシュクリア
カラー、プレーヤーの配置、または音声設定を変更した場合、フロントエンドは最新のCSSとJSを読み込む必要があります。プラグイン自体の内部キャッシュはクリアされますが、キャッシュプラグインが古いバージョンのページを配信する場合があります。
設定を変更した後は、以下の手順を実行してください。
- キャッシュプラグインのキャッシュをクリアする
- CDN(Cloudflare、BunnyCDNなど)を使用している場合は、パージも行う
オブジェクトキャッシュ
サイトがオブジェクトキャッシュプラグイン経由でRedisまたはMemcachedを使用している場合、TTSWPは以下のデータに同じキャッシュを利用します。
- ElevenLabsからの音声リスト(1時間)
- app.ttswp.comからの請求データ(24時間)
- 使用統計(5分間)
特別な操作は不要です。オブジェクトキャッシュにより管理画面の読み込みが高速化されます。
ページキャッシュと音声プレーヤー
ページキャッシュはTTSWPと安全に併用できます。プレーヤーのHTMLは投稿ごとに静的であり、訪問者ごとに変化しません。音声ファイルは別URLから読み込まれるため、ページキャッシュの影響を受けません。
注意が必要なケースは1つあります。
ログイン済みユーザーと匿名ユーザーの混在キャッシュ
キャッシュプラグインによっては、ログイン済みの管理者と匿名の訪問者に同じキャッシュページを配信することがあります。この場合、管理者専用の要素(アドミンバーメニューなど)がすべてのユーザーに表示される可能性があります。多くのプラグインはデフォルトでこの問題を適切に処理しています。
キャッシュプラグインの既知の設定
LiteSpeed Cache
- RedisまたはMemcachedが利用可能な場合はオブジェクトキャッシュを有効化(管理画面の高速化)
- 管理画面ではJS結合を無効のまま維持
- プラグインは
mementor-tts-admin.jsを最適化から自動除外
WP Rocket
- 手動での除外設定は不要
- プラグインはスクリプトに
data-no-optimize="1"属性を使用
W3 Total Cache
- フロントエンドの音声ページ向けにページキャッシュを有効化
- JSミニファイは有効のまま維持 - プラグインが自動でスクリプトを除外
キャッシュされた音声が更新されない場合のトラブルシューティング
投稿の音声を再生成しても古い音声が再生される場合は、以下の手順を試してください。
- ブラウザキャッシュをクリアする(Ctrl+Shift+Delete)
- キャッシュプラグインのページキャッシュをクリアする
- CDNを使用している場合はパージする
- 投稿ページをハード再読み込みする(Ctrl+Shift+R)
音声ファイルのURLにはタイムスタンプが含まれているため、通常はブラウザが新しいバージョンを取得します。それでも更新されない場合は、上記のキャッシュのいずれかが原因です。