【初心者向け】Cocoon子テーマの大そうじ｜コピーしたファイルをフックで置きかえる手順

はじめに：今日やったことをひとことで言うと

今日は、WordPressの「子テーマ」の大そうじをしました。

ひとことで言うと、「親テーマのファイルをコピーして書きかえる方法」をやめて、「決まった場所にパーツを差しこむ方法」に全部作りかえたという作業です。

これだけ聞いても「？？？」だと思うので、たとえ話を使って、ゼロから説明していきます。

そもそも「親テーマ」と「子テーマ」ってなに？

WordPressでサイトの見た目を決めているのが「テーマ」です。私は「Cocoon（コクーン）」という無料のテーマを使っています。

ここで、学校の教科書とノートでたとえてみます。

教科書（親テーマ）に直接落書きすると、新しい教科書が配られたときに全部消えてしまいます。だから自分の工夫はノート（子テーマ）に書くのがルールです。

何が問題だったの？

私の子テーマには、広告をたくさん入れるために、親テーマのファイルをまるごとコピーして、書きかえたものが11個も入っていました。

教科書でたとえると、教科書のページをコピーして、そのコピーに落書きして、教科書の上からはりつけていた状態です。

これの何がこまるかというと、

• 新しい教科書が配られても、上にはったコピーが古いままなので、新しい内容が読めない
• 教科書のまちがいが直っても、コピーのほうはまちがったまま
• 何年もたつと、「どこが自分の落書きで、どこが古い教科書の文なのか」が分からなくなる

実際に最新のCocoonとくらべてみたら、親テーマで直っているバグが、私のサイトでは直っていないところがいくつも見つかりました。

コピーして書きかえていたファイルはこの11個です。

解決のカギ「フック」ってなに？

ここで登場するのが「フック」というしくみです。

フックは、教科書に最初から用意されている「ふせんをはっていい場所」のようなものです。

Cocoonの作者さんは、「ここにパーツを差しこみたい人がいるだろうな」という場所に、あらかじめ目印をつけてくれています。たとえば、

• 記事の本文が終わった直後
• カルーセル（スライドする画像）のすぐ下
• フッターを読みこむ直前

などです。この目印に「ここに広告を出してね」というふせんをはれば、教科書をコピーしなくても、好きな場所にパーツを出せるんです。

しかも、新しい教科書が配られても、ふせんの場所（フック）はそのまま残るので、ふせんもそのまま使える。これが一番のメリットです。

実際のコードは、こんな感じの形をしています。

add_action( 'cocoon_part_after__tmp/carousel', 'my_after_carousel' );
function my_after_carousel() {
  // ここに出したい広告を書く
}

1行目が「カルーセルの後ろ（after）に、この中身を出してね」というお願いです。2行目から下が、出したい中身です。

実際にやった作業の流れ

全部で11ファイルあったので、1ファイルずつ「自分で書きたした部分だけ」を見つけて、ふせん（フック）に引っこしさせる作業をくり返しました。

いきなり全部やると、こわれたときにどこが原因か分からなくなるので、小さいファイルから1つずつ、確認しながら進めたのがポイントです。

見くらべる道具「WinMerge（ウィンマージ）」

手順2の「見くらべる」で便利なのが、WinMergeという無料のWindows用ソフトです。

2つのファイル（またはフォルダ）を左右にならべて開くと、ちがうところだけ色をつけて教えてくれます。まちがいさがしを自動でやってくれる道具、というイメージです。

• 左に「親テーマのファイル」、右に「子テーマにコピーしたファイル」を開く
• 色がついた行 ＝ 自分で書きたした（または親テーマが新しくなって変わった）部分
• フォルダ同士をくらべれば、「同じ名前のファイルがどれか」も一目で分かる

何百行もあるファイルを目で見くらべるのは大変なので、この作業には欠かせない道具でした。

以前このブログで記事にしましたので参考までに見てみて

WinMergeの使い方を完全解説｜2つのファイルの違いを一瞬で見つける無料ソフト

WinMergeは2つのファイルの違いを色分けで表示してくれる無料のWindowsソフト。ダウンロード方法、32bit/64bitの選び方、基本操作、フォルダ比較、WordPress子テーマの更新チェックまで、初心者向けに一から解説します。

webcss.withrun.org

2026.09.19

サイドバー（sidebar.php）

一番小さいファイルからスタート。自分で足していたのは「広告」と「星5評価ランキング」の2つだけでした。WordPressにもともとある「サイドバーのウィジェットを出す直前」のフックに引っこしさせて、終わり。

星5評価ランキングってなに？

訪問してくれた人が記事に星1から5で評価をつけられるしくみを作りました。

• 記事のタイトルの下に星がならんでいて、クリックするだけで投票できる
• 集まった評価から、人気の記事をランキングにして表示
• 投票数が少ない記事がいきなり1位にならないよう、票数も考えた計算で順位を決めている
• 前の日とくらべて順位が上がったか下がったかを矢印で表示

このしくみは自作のもので、プラグイン化して次回公開予定です。お楽しみに。

ヘッダー・ボディ上部・フッター（header.php / tmp/body-top.php / footer.php）

ここが一番むずかしかったところです。

サイトはPCで3列（3カラム）になっていて、その3列目を作るために、

• body-top.php で「箱をあける」
• footer.php で「箱をしめて、となりに3列目を作る」

という、2つのファイルでセットになった作りになっていました。

お弁当箱でたとえると、ふたを開ける係と閉める係が別々の人なので、片方だけやめると、ふたが開けっぱなし（レイアウトがくずれる）になってしまいます。

なので、「箱をあけるフック」と「箱をしめるフック」を同時に用意して、3つのファイルを同時に削除しました。

記事一覧のカード（tmp/entry-card.php）

カードに「カテゴリとタグのリンク」を出していただけでした。抜粋文の直後に出せるフックがあったので、そこに引っこし。ついでに、親テーマで直っていたバグ（まだ作っていない変数を使っていたミス）も、自動的に直りました。

記事本文まわり（tmp/content.php）

記事タイトルの下に「お気に入りボタン」と「星5評価」を出していた部分だけ。アイキャッチ画像の直前のフックに引っこし。

投稿ページ・固定ページ（single-contents.php / page-contents.php）

ここは中身の9割が自分で書いた広告でした。量が多いので、

• 投稿ページ用の広告 → ad-single.php
• 固定ページ用の広告 → ad-page.php
• 何度も出てくる「リンク表」→ parts/link-table.php（1つにまとめて使い回し）

というふうに、ファイルを役割ごとに分けて整理しました。

カテゴリ・タグページ（category-content.php / tag-content.php）

カテゴリ用とタグ用で、ほとんど同じ中身でした。なので1つの共通の部品にまとめて、両方から使う形にしました（ad-archive.php）。同じものを2回書かなくていいので、次に直すときも1か所ですみます。

404ページ（404.php）

「商品がない場合はコチラ」のボタンと、星5評価ランキングだけ。フッターを読みこむ直前のフックで、「404ページのときだけ出す」という条件をつけて引っこし。

途中で起きたトラブルと、その解決

もちろん、すんなりとはいきませんでした（笑）。

トラブル1：星5ランキングの見た目がくずれた

サイドバーを引っこしさせたら、ランキングのデザイン（CSS）が全部消えてしまいました。

原因は、ランキングのCSSが「ページの中で最初にランキングが呼ばれたときに1回だけ出す」というしくみだったこと。フックに引っこしたことで、その「1回目」が画面に出ないタイミングになってしまい、「CSSはもう出したつもり」なのに実際には出ていないという状態になっていました。

解決は、CSSをページの一番最初（head）で必ず1回出すように変えること。これで、どこでランキングを使ってもくずれなくなりました。

トラブル2：スマホでトップページだけ横にはみ出る

スマホでトップページを見ると、画面が横に広がってしまう問題が出ました。

Chromeの開発者ツールで、「画面からはみ出している部品だけを赤い線でかこむ」という調べ方をして、犯人を探しました。

犯人さがしの道具：Chromeの開発者ツール（F12）

スマホで横にはみ出す原因は、目で見てもなかなか分かりません。そこで使ったのが、Chromeにもともと入っている「開発者ツール」です。PCだけでスマホの表示を再現して調べられます。

注意：初めてConsoleに貼りつけるときは、ブロックがかかります。「貼りつけていいですか？」という安全のためのしくみで、入力欄にallow pastingと手で打ってEnterすると、貼りつけられるようになります。

ちなみに私は「allow posting」と打ちまちがえて、エラーが出ました（笑）。正しくは「pasting（ペースト＝貼りつけ）」です。

まず使ったのが、画面からはみ出している部品を全部、赤い線でかこむコードです。

document.querySelectorAll('body *').forEach(function(el){
  if (el.getBoundingClientRect().right > document.documentElement.clientWidth + 1) {
    el.style.outline = '2px solid red';
    console.log(el);
  }
});

ところが、これだと犯人の「中に入っている部品」まで全部赤くなって、一覧がズラーッと出てしまい、本当の犯人がどれか分かりませんでした。

そこで、「自分は画面より広いのに、親（外側の箱）は画面に収まっている」部品だけをさがすように改良しました。これが、横幅を押し広げている張本人です。

var W = document.documentElement.clientWidth;
document.querySelectorAll('body *').forEach(function(el){
  var r = el.getBoundingClientRect();
  if (r.width > W + 1) {
    var p = el.parentElement.getBoundingClientRect();
    if (p.width <= W + 1) {
      el.style.outline = '3px solid red';
      console.log(Math.round(r.width) + 'px', el);
    }
  }
});

今度は数行だけ出てきて、それぞれの横幅（px）も表示されるので、どの部品が何px広がっているかが一目で分かりました。

ただし、スマホのメニューのように「ふだんは画面の外にかくれている部品」も引っかかるので、そういうものは無視してOKです。また、開発者ツールで選んだ機種の画面がすごくせまいと、ふつうの部品まで引っかかることがあるので、最後は実際のスマホでも確認するのが大事です。

犯人は、一番上に出していたスマホ用広告の「表（table）」の外わく。表は、中身が大きいと自分もいっしょに広がる性質があるので、大きめの広告が出たときだけ、ページごと横に広がっていました。

表をやめて、「中身がはみ出したら、はみ出た分はかくす」わくに変えて、ページが横に広がる問題は解決。さらに、1つの広告会社のバナーが大きすぎたので、別の会社の広告に入れかえました。

これで一件落着…かと思いきや、入れかえた広告会社のほうにも大きなバナーがあったんです。わくのおかげでページがくずれることはないものの、はみ出た右側がスパッと切れた形で表示されていて、どうも気になります。

そこで、広告が画面より大きいときだけ、画面の幅に合わせてまるごと縮小するしくみを作りました。

• 広告を「中箱」に入れて、表示されたら中箱の横幅を測る
• 画面より大きければ、ちょうど収まる比率で縮小（画像もクリックできる範囲もいっしょに縮む）
• 画面に収まる広告なら、縮小せずにそのまま中央に表示
• 広告は少し遅れて表示されるので、表示された瞬間・読みこみ完了時・数秒後・画面を回転したときにも測り直す

コピー機の「縮小コピー」のようなイメージです。これで見た目がすっきりして、気持ちよくなりました。

実際のソースはこちらです（広告タグは伏せています）。

add_action( 'cocoon_part_after__tmp/carousel', 'my_after_carousel' );
function my_after_carousel() {

  // スマホのときだけ
  if ( ! wp_is_mobile() ) return;

  // ランダムで出す広告の候補
  $banners = array(
    '（広告会社Aの広告タグ）',
    '（広告会社Bの広告タグ）',
  );
  ?>
<div id="sp-top-banner" style="background:#000; text-align:center; max-width:100%; overflow:hidden;">
  <div id="sp-top-banner-in" style="display:inline-block; transform-origin:top left; vertical-align:top;">
    <?php echo $banners[ array_rand( $banners ) ]; ?>
  </div>
</div>
<script>
/* 広告が画面幅より大きいときだけ縮小する */
(function(){
  var box   = document.getElementById('sp-top-banner');
  var inner = document.getElementById('sp-top-banner-in');
  if (!box || !inner) return;

  function fit(){
    inner.style.transform = 'none';
    box.style.height = '';
    var w   = inner.scrollWidth;
    var max = box.clientWidth;
    if (w > max) {
      var s = max / w;
      inner.style.transform = 'scale(' + s + ')';
      box.style.height = Math.ceil(inner.offsetHeight * s) + 'px';
    }
  }

  /* 広告が差しこまれた瞬間に測り直す */
  if (window.MutationObserver) {
    new MutationObserver(fit).observe(inner, { childList: true, subtree: true });
  }
  window.addEventListener('load', fit);
  window.addEventListener('resize', fit);
  setTimeout(fit, 1000);
  setTimeout(fit, 3000);
})();
</script>
  <?php
}

ついでに直したバグたち

1つずつファイルを見ていったおかげで、今まで気づかなかったミスもたくさん見つかりました。

できあがったファイルの形

最終的に、子テーマはこんな形になりました。

そして一番大事なのは、親テーマと同じ名前のファイル（コピーして書きかえたもの）がゼロになったことです。

広告のふせんファイルの中身（かんたん版）

実際のファイルは広告がたくさん入っていて長いので、ここではしくみが分かるように、かんたんにしたものをのせます。「（広告タグ）」のところに、広告会社からもらったタグを入れる形です。

ad-hooks.php（全ページ共通の広告のふせん）

全部のページに出す広告を書くファイルです。ほかの広告ファイル（投稿・固定・一覧ページ用）も、ここから読みこんでいます。

<?php
if ( !defined( 'ABSPATH' ) ) exit;

/* ページの種類ごとの広告ファイルも読みこむ */
require_once get_stylesheet_directory() . '/ad-single.php';
require_once get_stylesheet_directory() . '/ad-page.php';
require_once get_stylesheet_directory() . '/ad-archive.php';

/* カルーセルの直後に広告を出す */
add_action( 'cocoon_part_after__tmp/carousel', 'my_after_carousel' );
function my_after_carousel() {
  echo '<div>（広告タグ）</div>';
}

/* サイドバーのウィジェットの直前に広告を出す */
add_action( 'dynamic_sidebar_before', 'my_sidebar_top', 10, 2 );
function my_sidebar_top( $index, $has_widgets ) {
  if ( $index !== 'sidebar' ) return;  // メインのサイドバーだけ
  echo '<div>（広告タグ）</div>';
}

/* メインの一番最後（フッターの直前）に広告を出す */
add_action( 'get_footer', 'my_main_bottom' );
function my_main_bottom() {
  echo '<div>（広告タグ）</div>';
}

ad-single.php（投稿ページ専用の広告のふせん）

投稿ページのときだけ出す広告です。「is_single()」で「今、投稿ページかな？」を確認してから出しています。

<?php
if ( !defined( 'ABSPATH' ) ) exit;

/* 記事の本文が終わった直後に広告を出す */
add_action( 'cocoon_part_after__tmp/content', 'my_single_after_content' );
function my_single_after_content() {
  if ( !is_single() ) return;  // 投稿ページ以外では何もしない
  echo '<div>（広告タグ）</div>';
}

/* 関連記事の直後に広告を出す */
add_action( 'cocoon_part_after__tmp/related-entries', 'my_single_after_related' );
function my_single_after_related() {
  if ( !is_single() ) return;
  echo '<div>（広告タグ）</div>';
}

ad-page.php（固定ページ専用の広告のふせん）

固定ページは、自作のページテンプレート（お気に入り一覧など）もあるので、「ふつうの固定ページを表示している間だけ」目印を立てて、そのときだけ広告を出すようにしています。

<?php
if ( !defined( 'ABSPATH' ) ) exit;

/* 目印：ふつうの固定ページを表示している間だけ true */
$GLOBALS['my_in_page'] = false;
add_action( 'cocoon_part_before__tmp/page-contents', function() {
  $GLOBALS['my_in_page'] = true;
} );
add_action( 'cocoon_part_after__tmp/page-contents', function() {
  $GLOBALS['my_in_page'] = false;
}, 99 );

/* 本文が終わった直後に広告を出す */
add_action( 'cocoon_part_after__tmp/content', 'my_page_after_content' );
function my_page_after_content() {
  if ( empty( $GLOBALS['my_in_page'] ) ) return;  // 目印がないときは何もしない
  echo '<div>（広告タグ）</div>';
}

ad-archive.php（カテゴリ・タグページの広告のふせん）

カテゴリページとタグページは中身がほとんど同じなので、共通の部品（my_archive_ads）を1つ作って、両方から呼び出す形にしています。表示しているカテゴリ名・タグ名を受け取って、その名前で広告や商品を出します。

<?php
if ( !defined( 'ABSPATH' ) ) exit;

/* カテゴリページ：タイトル・説明の直後 */
add_action( 'cocoon_part_after__tmp/category-content', 'my_category_ads' );
function my_category_ads() {
  $term = get_queried_object();  // 表示中のカテゴリ
  my_archive_ads( $term->name );
}

/* タグページ：タイトル・説明の直後 */
add_action( 'cocoon_part_after__tmp/tag-content', 'my_tag_ads' );
function my_tag_ads() {
  $term = get_queried_object();  // 表示中のタグ
  my_archive_ads( $term->name );
}

/* カテゴリ・タグ共通の広告ブロック */
function my_archive_ads( $keyword ) {
  echo '<h2>' . esc_html( $keyword ) . 'の人気商品</h2>';
  echo '<div>（広告タグ）</div>';
}

functions.php（目次）

最後に、functions.php の一番下で広告ファイルと見た目のファイルを読みこめば完成です。

require_once get_stylesheet_directory() . '/ad-hooks.php';
require_once get_stylesheet_directory() . '/display-hooks.php';

これで、Cocoonが何回アップデートしても、広告や改造が消えたり、くずれたりする心配がなくなりました。

最後の仕上げ：使っていないファイルのおそうじ

フックへの引っこしが終わったあと、子テーマの中に何年も前に作って、今は使っているか分からないファイルがいくつか残っていました。

いきなり消すと、どこかで使っていたときに表示が消えてしまいます。そこで、「そのファイル名が、ほかのファイルの中に書かれていないか」を、Windowsにもともと入っているPowerShell（パワーシェル）で一気に調べました。

たとえると、「この名前の人を呼んでいる人はいますか？」と、クラス全員に一度に聞くようなものです。だれも呼んでいなければ、その人（ファイル）はいなくても困りません。

手順

「ターミナルで開く」を使うと、そのフォルダの場所でPowerShellが開くので、場所（パス）を自分で打たなくてすみます。

使ったコード

「”oldfile1″,”oldfile2″」のところに、調べたいファイル名（の一部）をカンマ区切りで入れます。

Get-ChildItem -Recurse -File | Select-String -Pattern "oldfile1","oldfile2","oldfile3" | Select-Object Path -Unique

結果の見かた

私の場合は何も表示されなかったので、テーマの中では使われていないことが確定しました。

消すときの注意

この検索で分かるのはテーマのファイルの中だけです。記事の本文やウィジェットに直接書いている可能性は残るので、

• PCにバックアップがあることを確認
• サーバーからは削除
• 数日ようすを見て、どこかの表示が欠けていなければ完全にお別れ

という順番で消しました。もし何か消えても、バックアップから戻せば一瞬で元どおりです。中身が空になった tmp フォルダも、このタイミングで削除しました。

今回わかった大事なルール

おわりに

正直、最初は「ごちゃごちゃで手がつけられない…」と思っていました。でも、1ファイルずつ、自分で書いた部分だけを取り出して、正しい場所に引っこしさせるというのをくり返していったら、ちゃんと全部片づきました。

WordPressの子テーマに、親テーマのファイルをコピーしてたくさん置いている人は、アップデートでこまる前に、一度見直してみるのがおすすめです。

次回は、星5評価のしくみを「プラグイン」にして公開する予定です。お楽しみに！

PowerShellで子テーマの不要ファイルを一括検索する方法【WordPress】

WordPressの子テーマに残った不要ファイルや関数の残骸を、Windows標準のPowerShellで一括検索する方法を解説。Get-ChildItemとSelect-Stringの使い方、実際の検索例と注意点まで紹介します。

webcss.withrun.org

2026.09.22