WordPressのショートコードがコンテンツの最上部に表示される不具合の解決方法
MENU
  1. HOME
  2. WordPress / カスタマイズ
  3. WordPressのショートコードがコンテンツの最上部に表示される不具合の解決方法

最近の作業実績

  • 2022年10月18日不要になっていたコンテンツをサイト内から除去いたしました。
  • 2022年10月17日サイト内の画像が表示されない不具合を修正いたしました。
  • 2022年10月16日サイト内で発生した大量の404エラーを修正いたしました。
  • 2022年10月15日既存サイトの各所を簡単に更新できる機能を追加いたしました。
  • 2022年10月14日過去記事を定期的に自動ツイートする機能をテーマに実装いたしました。
  • 2022年10月13日サイト内の広告を一括管理できる機能をテーマに実装いたしました。
  • 2022年10月12日既存サイトのトップページを再構築いたしました。
  • 2022年10月11日クラシックエディターで管理されていたコンテンツをブロックエディターで再構築いたしました。
  • 2022年10月10日複数のサイトの更新情報を一括表示させる機能をテーマに実装いたしました。
  • 2022年10月09日WordPressの管理画面にオリジナルの管理ページを実装いたしました。
  • 2022年10月08日コンタクトフォーム7で構築されたフォームに確認画面とサンクスページを導入いたしました。
  • 2022年10月07日既存サイトのサーバー移管を担当いたしました。
  • 2022年10月06日フッターのレイアウトを再設計いたしました。
  • 2022年10月05日既存サイトのカラーを一括管理できる機能をテーマに実装いたしました。
  • 2022年10月04日新規ページを5ページ作成いたしました(デザイン込み)。
  • 2022年10月03日訪問者に閲覧履歴を表示する機能をテーマに実装いたしました。
  • 2022年10月02日ログインできなくなったWordPressを復旧いたしました。
  • 2022年10月01日オリジナルテーマの制作を担当いたしました。
  • 2022年09月30日破損していたテーマを修正いたしました。
  • 2022年09月29日アフィリエイト審査用のサイト立ち上げを担当いたしました。
  • このエリアには直近の制作実績を一部掲載しております。
  • 制作実績はリアルタイム反映ではありません。

WordPressのショートコードがコンテンツの最上部に表示される不具合の解決方法

オリジナルのショートコードを作成したことがある方もいると思います。
そのとき、こんな経験はありませんか?

ショートコードが本文の一番上に出力されてしまう。

本文の途中にショートコードを設置したのに、なぜか本文の最上部に出力されてしまう。
もしかすると、今まさにこの問題に直面している方もいらっしゃるかもしれません。

でも安心してください。
今回のコンテンツでは、この問題の解決策をご紹介しています。

オリジナルのショートコードをちょっと修正するだけで、この問題は解決できます。
興味のある方は、このコンテンツを最後までお読みください。
この記事は約 4 分で読めます。

WordPressのショートコードとは

本題に入る前に、基本的な部分をさらっと解説しておきます。

ショートコードとは、特定の処理を簡単に呼び出せるようにした短いコードのことです。

例えば、「こんにちは」という文字列をショートコード化しておけば、投稿や固定ページなどでショートコードを記述するだけで、「こんにちは」という文字列を表示することできます。

WordPressの投稿や固定ページでは、PHPが使用できませんが、PHP処理をショートコード化しておけば、投稿や固定ページでもPHP処理を行うことができるようになります。

ショートコードの基本的な部分は、以下のコンテンツを参照してください。
【WordPress】ショートコードの作り方と使い方

ショートコードがコンテンツの最上部に表示されてしまうケース

ショートコードを投稿や固定ページ内に設置した時、どういうわけか、コンテンツの最上部に表示されてしまうことがあります。

前文
[ショートコード]
後文

上記のようにショートコードを設置した場合、正常な状態であれば、以下の様な表示となります。

前文
ここにショートコードの処理
後文

ところが、オリジナルのショートコードを設置すると、以下の様な表示になる場合があります。

ここにショートコードの処理
前文
後文

なぜか、ショートコードの内容がコンテンツの最上部に来てしまうのです。

ショートコードがコンテンツの最上部に表示される原因

この原因は、ショートコード内で使われている【print】や【echo】にあります。

ショートコードは、記事を表示する時に実行される【wp_content】を通る際に処理されています。
本文の途中に設置したショートコードでも、記事を表示する段階で【print】や【echo】が動作してしまい、結果としてコンテンツの最上部でショートコードが動作してしまうわけです。

フィルターの知識だ無い方には、なんのことか分からないかと思います。
でも、心配はありません。

次の修正方法に従って、ショートコードを修正すれば問題は解決します。

ショートコードがコンテンツの最上部に表示される不具合の解決方法

以下のショートコードを例として、修正を加えてみます。

function shortcode_test() {
echo "こんにちは";
}
add_shortcode('shortcode_01', 'shortcode_test');

上記で作ったショートコードを以下の様に設置すると、

前文
[shortcode_01]
後文

次のような表示になってしまうものとします。

こんにちは
前文
後文

それでは、修正方法を見ていきましょう。
先ほどご紹介した、以下のコードを修正してやります。

function shortcode_test() {
echo "こんにちは";
}
add_shortcode('shortcode_01', 'shortcode_test');

上記のコードを以下の様に修正します。

function shortcode_test() {
ob_start();
echo "こんにちは";
return ob_get_clean();
}
add_shortcode('shortcode_01', 'shortcode_test');

赤文字の部分が新たに追加したコードです。

この様にショートコードの表示内容を【ob_start();】と【return ob_get_clean();】で囲ってやるだけで、以下の様に問題は解決します。

前文
[shortcode_01]
後文

上記の様にショートコードを設置すると、

前文
こんにちは
後文

ショートコードを設置した個所で処理が行われました。
問題は解決です。

問題が解決しない場合

上記の修正を加えても問題が解決しない場合、修正内容に誤りがあるか、他に原因があるものと考えられます。

まずは、修正内容に誤りが無いか最初から見直しをしてみてください。
修正内容に誤りが無いのに問題が解決しない場合は、他に原因があるものと思われます。

その場合は、お問い合わせからお気軽にご相談下さい。

まとめ

ショートコードがコンテンツの最上部に表示される不具合の解決方法をご紹介しました。

・ショートコード内の【print】や【echo】が原因で起こる不具合
・内部処理段階で【print】や【echo】が動作しないようにしてやる

修正自体はコピペでできる簡単なものです。
興味のある方は、コンテンツの手順に従って挑戦してみてください。

Wordpressのカスタマイズや不具合など
何かお困りのことはありませんか?

Wordpressに関連するあなたのお悩み、解決いたします。
次のような方は、お気軽にご相談下さい。

  • Wordpressサイトをカスタマイズしたいが、やり方が分からないで困っている。カスタマイズの知識が豊富な人に任せたい。
  • Wordpressサイトに不具合が発生したが、直し方が分からない。不具合の修正経験が豊富な人に任せたい。
  • 既存サイトにWordPressを導入したいが、やり方が複雑で自分ではできそうにもない。経験が豊富な人に任せたい。
  • WordPressがハッキングされたが修正の仕方が分からない。サイトを元通りにできる人を探している。
  • Wordpressで0からサイトを制作したいが、自分ではできそうにもない。プロにサイト制作を委託したい。

一つでも該当する方は、以下のフォームからお気軽にご相談下さい。

WordPressに関して今すぐ相談する

著者:takaya kondo

岡山在住のWordPress専門フリーランサーです。Wordpressを使ったWEBサイト制作を中心に10年間ほど活動させていただいています。

Wordpress関連の記事でお役に立てれば幸いです。

【関連記事】あなたが興味のありそうな関連記事をご紹介します。

コメントを残す

(必須)

CAPTCHA