ショートコードの利点

ショートコードは、コンテンツをクリーンで意味的に保ちながら、エンドユーザーがプログラム的にコンテンツの表示を変更する能力を持つ貴重な方法です。

エンドユーザーがショートコードを使用して投稿にフォトギャラリーを追加する際、ギャラリーの表示方法を示すために最小限のデータを使用しています。

利点:

  • 投稿コンテンツにマークアップが追加されないため、マークアップとスタイリングはその場で簡単に操作したり、後で変更したりできます。
  • ショートコードはパラメータを受け入れることもでき、ユーザーはインスタンスごとにショートコードの動作を変更できます。

組み込みショートコード

デフォルトで、WordPressには以下のショートコードが含まれています:

  • [caption] – コンテンツの周りにキャプションをラップすることを許可します
  • [gallery] – 画像ギャラリーを表示することを許可します
  • [audio] – オーディオファイルを埋め込んで再生することを許可します
  • [video] – ビデオファイルを埋め込んで再生することを許可します
  • [playlist] – オーディオまたはビデオファイルのコレクションを表示することを許可します
  • [embed] – 埋め込まれたアイテムをラップすることを許可します

ショートコードのベストプラクティス

ショートコードを開発するためのベストプラクティスには、プラグイン開発のベストプラクティスと以下のリストが含まれます:

  • 常に戻り値を返すこと!
    ショートコードは本質的にフィルターであるため、「副作用」を作成すると予期しないバグが発生します。
  • 他のプラグインとの衝突を避けるために、ショートコード名にプレフィックスを付けてください。
  • 入力をサニタイズし、出力をエスケープしてください。
  • すべてのショートコード属性に関する明確なドキュメントをユーザーに提供してください。

クイックリファレンス

基本的なショートコード構造の完全な例を参照し、自己閉じと囲みのシナリオ、ショートコード内のショートコード、出力のセキュリティを考慮してください。

外部リソース