概要

ショートコードは、角括弧で囲んだ短い記法をWordPressの本文などに置き、登録済みの処理を呼び出す仕組みです。編集者が本文へPHPの処理そのものを書き込むのとは異なり、提供元が用意した機能を指定します。[1]

ショートコードが表示される仕組み

WordPressは、ショートコードを処理するときに、記法の名前に対応して登録された関数を呼び出し、その結果を表示に使います。たとえば、本文にある[gallery]を、画像を並べる表示に変えます。[1]

ショートコードによっては、記法に属性を付けて表示の条件を渡せます。開始と終了の記法で文章などを囲む形式では、その内側の内容も処理の対象になります。[1]受け付ける指定は、使うショートコードごとに確認してください。

使われる場面

ショートコードは、本文に機能の呼び出しだけを書き、表示をWordPressやプラグインに任せたいときに使われます。[1]

  • 画像や動画を埋め込む:WordPressには、画像ギャラリーや動画を表示するためのショートコードがあります。[1]
  • データから表示を作る:WooCommerceでは、指定した条件に合う商品を表示するショートコードがあります。[2]
  • 提供元を確かめる:使いたい記法がWordPress標準のものか、利用しているプラグインなどが提供するものかを確認します。

ブロックとの関係

ブロックエディターでも、ショートコードブロックに記法を入れて、対応する処理を利用できます。専用ブロックを選んで画面上で設定する方法と、ショートコードブロックに記法を渡す方法は、編集の仕方が異なります。[2]

WooCommerceの資料でも、ショートコードに対応するブロックは、代替がある場合に案内されています。[2]既存ページをブロックへ置き換えるときは、使っている機能と設定を個別に確認します。

保守で注意すること

保守では、記法が残っているかだけでなく、その処理を登録する機能が使える状態かを確認します。[1]

  • 提供元:プラグインを無効にしたりテーマを変更したりする前に、影響する記法を確認します。登録が失われれば、同じ記法を残しても従来の出力は得られません。[1]
  • 表示:編集画面の記法と、読者が見るページの両方を確認します。変更前の出力と比べ、必要な内容が表示されるかを確かめてください。
  • コードの扱い:記法を追加する作業と、処理を実装する作業は分けて考えます。出所や動作を確認できないコードを、そのまま本番サイトで実行しないでください。

参考文献・出典

  • Supervisor
    supervisor

    桑田 陽介

    代表取締役

    Web制作・運用・改善に20年以上携わり、WordPress、CMS構築、SEO、AWSなど、Webサイトの企画・制作から公開後の運用まで幅広く担当。実務経験にもとづき、本記事の内容・表現・技術情報を監修しています。

Contact us

『ホームページ制作の相談をしたい』『もっとたくさん商品を売りたい』等、ご要望をお伝えくださいませ。

疑問に思っていること、お困りごと、具体的な内容が未定でも、まずはお気軽にご相談くださいませ。