Cocoonで最後H2の上にウィジェットエリアを追加する方法【最新版】

2026年7月現在、このウェブサイトはワードプレステーマ「Cocoon」を利用しています。

Cocoonは多機能なテーマで、ウィジェットエリアは約30も用意され、自分の目的に合わせてウィジェットを表示できます。役立つサイト⇒『[Cocoon] ウィジェットエリア　デモページ Ikumi’s lifelog』

豊富にあるウィジェットエリアですが、記事本文中には「投稿本文中」と「固定ページ本文中」しかありません。これは「最初のH2見出しの上」に当たります。おそらく多くのウェブサイトでは、目次がある位置だと思われます。

しかし例えば、「最後見出しH2の上」にアドセンスを設置したいといった考えもあるでしょう。最後見出しH2の上にウィジェットエリアを追加する方法を、インターネット検索してもヒットしなかったので、備忘録として紹介します。

以下のコードを、Cocoon子テーマのfunctions.phpに貼り付けるだけです

💡 【お知らせ】PHP8・AMP廃止に対応した最新コードをお探しの方へ
この記事で以前紹介していた下のコードは旧環境向けです。現在のCocoonやPHP8環境に最適化した最新コードは、ページ下の最新コード解説欄へお進みください。

/* ウィジェットエリア追加 */
if (function_exists('register_sidebar')){
    register_sidebar(array(
    'name' => '投稿本文最後H2見出しの上',
    'id' => 'widget-in-article2',
    'description' => '投稿本文記事に表示されるウイジェット。文中最後のH2タグの手前に表示される',
    'before_widget' => '<div id="%1$s" class="widget-in-article2 %2$s">',
    'after_widget' => '</div>',
    'before_title' => '<div class="widget-in-article2-title main-widget-label">',
    'after_title' => '</div>'
    ));
}

/////////////////////////////////////
// 投稿本文中の下にウィジェットを表示する
/////////////////////////////////////
if ( !function_exists( 'add_widget_before_2nd_h2' ) ):
function add_widget_before_2nd_h2($the_content) {
  if ( is_amp() ) {
    return $the_content;
  }
  if ( is_single() && //投稿ページのとき、固定ページも表示する場合はis_singular()にする
       is_active_sidebar( 'widget-in-article2' ) //ウィジェットが設定されているとき
  ) {
    // 投稿本文中の下タグを記入
    ob_start();//バッファリング
    echo '<div id="widget-in-article2" class="widgets">';
    dynamic_sidebar( 'widget-in-article2' );// 投稿本文中の下ウィジェットエリアの表示
    echo '</div>';
    $ad_template = ob_get_clean();
        $h2 = '/^<h2.*?>.+?<\/h2>$/im';//H2見出しのパターン
        if ( preg_match_all( $h2, $the_content, $h2s )) {//H2見出しが本文中にあるかどうか
          if ( $h2s[0] ) {//チェックは不要と思うけど一応
			  if ( $h2s[0][1] ) {//H2が2個以上なら最後のH2見出し手前に挿入
              $the_content  = str_replace($h2s[0][count($h2s[0]) - 1], $ad_template.$h2s[0][count($h2s[0]) - 1], $the_content);
            }
          }
        }
  }
  return $the_content;
}
endif;
add_filter('the_content','add_widget_before_2nd_h2');

カスタマイズの手順

お礼・参考にしたウェブサイト

私はワードプレス関数【PHP】や条件分岐などの知識のまったくない、ど素人です。一から「最後見出しH2の上に、ウィジェットエリアを追加する」ソースコードをつくることはできません。

以下のウェブサイトに紹介されたソースコードを参考に、あ～だこうだとこねくり回して何とか、作成しました。

CocoonとSimplicityに完全な互換性はありませんが、上記の2つのSimplicityのfunctions.phpカスタマイズコードは大変参考になりました。

PHP8.x系・AMP廃止に対応した最新コード

2020年に、「最後のH2見出しの上にウィジェットエリアを追加するコード」をご紹介しました。

しかし記事公開から6年以上がたち、PhPは7から8へ、WordPress5.4から6.9へ、CocoonのAMP機能の廃止などの変化がありました。

以前のコードでもウィジェットエリアは追加されますが、より安全で軽量なコードへとアップデートを行いました。

以前のコードをご利用中の方も、これから設置する方も、こちらの最新版コードも参考にしてご活用ください。

/* ウィジェットエリア追加 */
if ( function_exists( 'register_sidebar' ) ) {
    register_sidebar( array(
        'name'          => '投稿本文最後H2見出しの上',
        'id'            => 'widget-in-article2',
        'description'   => '投稿本文記事に表示されるウィジェット。文中最後のH2タグの手前に表示される',
        'before_widget' => '<div id="%1$s" class="widget-in-article2 %2$s">',
        'after_widget'  => '</div>',
        'before_title'  => '<div class="widget-in-article2-title main-widget-label">',
        'after_title'   => '</div>'
    ) );
}

/////////////////////////////////////
// 投稿本文中の下にウィジェットを表示する
/////////////////////////////////////
if ( ! function_exists( 'add_widget_before_2nd_h2' ) ) :
function add_widget_before_2nd_h2( $the_content ) {
    // 投稿ページかつウィジェットが空でない場合のみ処理
    if ( is_single() && is_active_sidebar( 'widget-in-article2' ) ) {
        
        // H2見出しのパターン（改行を含んでも判定できるよう修正）
        $h2 = '/<h2.*?>.*?<\/h2>/is';
        
        if ( preg_match_all( $h2, $the_content, $h2s ) ) {
            // H2が2個以上ある場合、最後のH2の手前にウィジェットを挿入
            if ( isset( $h2s[0][1] ) ) {
                
                // ウィジェット出力の取得
                ob_start();
                echo '<div id="widget-in-article2" class="widgets">';
                dynamic_sidebar( 'widget-in-article2' );
                echo '</div>';
                $ad_template = ob_get_clean();

                // 最後のH2タグと置換（直前に差し込み）
                $last_h2_index = count( $h2s[0] ) - 1;
                $the_content = str_replace( $h2s[0][$last_h2_index], $ad_template . $h2s[0][$last_h2_index], $the_content );
            }
        }
    }
    return $the_content;
}
endif;
add_filter( 'the_content', 'add_widget_before_2nd_h2' );