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

WordPressのショートコードとは

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

問題が解決しない場合

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

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

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

まとめ

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

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

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