【ブログ】Cocoonで画像が拡大されない原因はJetpack|Spotlightで解決

スポンサーリンク
ブログ
スポンサーリンク

このブログはWordPressのテーマにCocoonを使っていて、記事の画像はクリックすると大きく表示されるように、画像に元サイズの画像へのリンクを付けている。ところが、実際にスマホで記事を開いて画像を押してみたら、黒い背景の拡大表示(ライトボックス)は出ず、画像ファイルだけが同じタブで開いた。読者は画像を見たあと「戻る」で記事に戻るしかない。調べてみると、新しい記事だけでなく、前からリンクを付けていた記事でも全部同じだった。

結論から書くと、原因はJetpackの画像の高速化(サイトアクセラレーター)が、画像へのリンクの末尾に?ssl=1を付けていたこと。Cocoon設定の「画像の拡大効果」をbaguetteBoxからSpotlightに変えるだけで直った。コードを書く必要はなく、ラジオボタンを1つ変えて保存するだけだ。

Spotlightで記事の画像を拡大表示したところ。黒い背景に画像が大きく出て、上に枚数とズームボタン、右に次へ矢印
Spotlightに変えたあと。画像を押すと全画面で拡大され、矢印で同じ記事のほかの画像へ移れる

確認した環境は、Cocoon 2.9.5、Jetpack 16.4、サーバーはConoHa WING(2026年11月時点)。

こんな症状なら当てはまる

  • テーマがCocoonで、Cocoon設定の「画像の拡大効果」がbaguetteBoxになっている
  • 画像にはリンクを付けているのに、押すと拡大表示ではなく画像ファイルだけが開く
  • Jetpackを入れていて、画像のURLがi0.wp.comのような形になっている

いちばん早い確かめ方は、公開ページで画像を右クリックして「リンクのアドレスをコピー」を選び、メモ帳などに貼ってみることだ。次のようにi0.wp.comで始まり、末尾が?ssl=1になっていれば、この記事の原因に当てはまる。

https://i0.wp.com/example.com/wp-content/uploads/2026/11/sample.png?ssl=1

そもそも「リンクのアドレスをコピー」が出ない(画像にリンクが付いていない)場合は、原因が別だ。Cocoonの拡大効果は、メディアファイルへのリンクを付けた画像にしか効かない(Cocoonの画像拡大効果(Lightbox)ライブラリ各々お勧めの使いどころ - Cocoon)。ブロックエディターで画像を選び、ツールバーの「リンク」から「メディアファイル」を選んでリンクを付けておく。

直し方:画像の拡大効果をSpotlightに変える

  1. WordPressの管理画面で「Cocoon設定」を開く
  2. 「画像」タブを開く
  3. 「画像の拡大効果」で「Spotlight(軽量・高機能ギャラリー)」を選ぶ
  4. 画面の下にある「変更をまとめて保存」を押す
Cocoon設定の画像タブにある画像の拡大効果。Spotlightを選んだ状態
Cocoon設定 →「画像」タブ →「画像の拡大効果」。前はbaguetteBoxを選んでいた

保存したら、公開ページを開き直して画像を押してみる。キャッシュ系のプラグインを使っている場合は、キャッシュを消してから確かめる。うちのブログでは、新しい記事から古い記事まで7本で試し、どれも拡大表示されることを確かめた。スマホでも全画面で拡大され、横にスワイプすると次の画像へ移れる。

スマホ幅でSpotlightの拡大表示を開いたところ
スマホ幅で開いたところ。横長の画像はピンチか上のズームボタンで大きくできる

元に戻したいときは、同じ設定をbaguetteBoxに戻して保存するだけだ。記事の本文やテーマのファイルは何も変わらない。

原因:Jetpackの?ssl=1でbaguetteBoxの対象から外れていた

Jetpackが画像へのリンクを書き換える

Jetpackのサイトアクセラレーターを有効にすると、画像はi0.wp.comなどのJetpackの配信サーバーから表示されるようになる(Site Accelerator - Jetpack)。このとき書き換わるのはimgのURLだけではない。画像を囲むリンクのURLも、同じ配信サーバーのURLに書き換えられる。さらに元の画像がhttpsだと、URLの末尾に?ssl=1が付く(Jetpackのソースコード class-image-cdn.php と class-image-cdn-core.php)。

実際に、記事で書いたリンクと、公開ページに出てくるリンクを比べるとこうなっていた。

<!-- 記事で書いたリンク -->
<a href="https://example.com/wp-content/uploads/2026/11/sample.png">
<!-- 公開ページに出てくるリンク -->
<a href="https://i0.wp.com/example.com/wp-content/uploads/2026/11/sample.png?ssl=1">

baguetteBoxは「.pngで終わるリンク」だけを拡大する

CocoonのbaguetteBoxは、記事の本文の中にあるリンクのうち、画像を指すリンクだけを拡大の対象にする。画像かどうかの判定は、Cocoonに入っているbaguetteBoxの次の条件だ(Cocoonの baguetteBox.min.js)。

/.+\.(gif|jpe?g|png|webp|avif)$/i

最後の$は「ここで終わる」という意味なので、URLが.pngなどで終わっていないと画像として扱われない。Jetpackが?ssl=1を足したリンクは.png?ssl=1で終わるので、ただのリンクとしてそのまま画像ファイルが開いていた。

Spotlightなら効く理由

Spotlightは仕組みが違う。Cocoonは記事を表示するときに、画像へのリンクにclass="spotlight"という目印を付け、Spotlightはその目印が付いたリンクを拡大する(Cocoonの lib/image.php)。この目印を付ける処理は、Jetpackがリンクを書き換えるより前に動く。

順番 処理 リンクの状態
1 Cocoonが画像へのリンクに目印を付ける(優先度11) …/sample.pngにclass="spotlight"が付く
2 Jetpackがリンクを書き換える(優先度999999) …/sample.png?ssl=1になるが、目印は残る
3 ページを開いたときにSpotlightが動く 目印のあるリンクを拡大する。URLの末尾は見ない

baguetteBoxはページを開いたあとにURLの末尾を見て判定するので、書き換えられたあとのリンクで判定してしまう。Spotlightは書き換えの前に付いた目印で判断するので、?ssl=1の影響を受けない。うちのブログの公開ページでも、リンクは?ssl=1付きのまま、class="spotlight"が付いていることを確かめた。

ほかの直し方と、選ばなかった理由

方法 結果
画像の拡大効果をSpotlightにする 採用。設定を1つ変えるだけで、画像の高速化もそのまま使える
画像の拡大効果をLityにする 拡大はできた(Spotlightと同じく目印を付ける方式)。ただし1枚ずつしか見られず、次の画像へ移れない
Jetpackのサイトアクセラレーターを切る 試していない。リンクが元のURLに戻るはずだが、画像の配信が遅くなるかもしれないので選ばなかった
Cocoon設定の「フッター用コード」に、?ssl=1付きでも拡大させるスクリプトを入れる ブラウザ上では拡大できたが、保存しようとするとサーバーのWAFに止められた

最後のスクリプトの方法は、最初にこれで直そうとした。ところがConoHa WINGでは、スクリプトを含む設定を保存するとWAF(不正なアクセスを止めるサーバーの防御機能)に「閲覧できません (Forbidden access)」と止められ、設定は空のままだった。WAFのログを見ると、クロスサイトスクリプティングを防ぐルールに引っかかっていた。ConoHa WINGでは、クラウドからWordPressのREST APIを使ったときにも、WAFとは別の「海外アクセス制限」という防御機能に止められたことがある(クラウド版Claude CodeからWordPressのREST APIが403になった原因と対処)。

WAFを一時的に切ったり、そのルールを除外したりすれば保存はできる。ただ、同じルールは外から来る本物の攻撃も止めている。うちのWAFのログにも、別のルールだが、ボットからの攻撃らしいアクセスを1日で50件以上止めた記録がある。画像の拡大のためにそこを緩めるのは割に合わないので、WAFは触らず、設定だけで済むSpotlightにした。同じように保存で止められた人も、WAFを外す前に「画像の拡大効果」を変えてみてほしい。

Spotlightに変えて気づいたこと

  • 画像の下に、画像の代替テキスト(alt)がそのまま説明として出る。スマホでは文字が大きめなので、altは短めにしておくと見やすい
  • 画像の外側の余白を押しても閉じない。右上の「×」で閉じる(Cocoon公式の説明にも書かれている)
  • 上にズーム、全画面、閉じるのボタンが出て、画面のスクショのような細かい画像も拡大して読める

この記事のまとめ

  • Cocoon+Jetpackで画像を押しても拡大されないときは、画像のリンクが?ssl=1で終わっていないか確かめる
  • 原因は、Jetpackのサイトアクセラレーターがリンクに?ssl=1を足し、baguetteBoxが画像へのリンクと判定しなくなること
  • Cocoon設定 →「画像」→「画像の拡大効果」をSpotlightにして保存すれば直る。コードもWAFの変更もいらない
  • 画像にリンクが付いていない場合は、先に「メディアファイル」へのリンクを付ける

参考

コメント

タイトルとURLをコピーしました