使い方
参考：
ショートコード | WordPress Codex 日本語版
API
参考：
ショートコード API | WordPress Codex 日本語版
文字のエスケープ
ショートコードで使用する特殊文字を通常の文字として扱いたい場合は数値参照文字を使用する。
| 文字 | 数値文字参照 |
|---|---|
| [ | [ |
| ] | ] |
| “ | " |
| ‘ | ' |
参考：
角括弧とクォートをエスケープして表示 ショートコードと属性値 | MaryCore
ショートコードのエスケープ
ショートコードを通常の文字として表示したい場合は角括弧を二重にする。
[[escaped_shortcode]]
参考：
ショートコードのエスケープ | WordPress Codex 日本語版
ショートコード自体を表示する (ショートコードのエスケープ) | jz5.jp
デフォルトのショートコード
[audio][caption][embed][gallery][video][playlist]
参考：
デフォルトで使えるショートコード | WordPress Codex 日本語版
独自のショートコードを作成する
- add_shortcode：ショートコードを処理するフックを追加する
- shortcode_exists：ショートコードを処理するフックが登録されているか確認する
- remove_shortcode：ショートコードを処理するフックを削除する
- remove_all_shortcodes：ショートコードを処理するフックを全て削除する
参考：
ショートコードの作成 | Web Design Leaves
add_shortcode | WordPress 私的マニュアル
shortcode_exists | WordPress 私的マニュアル
remove_shortcode | WordPress 私的マニュアル
remove_all_shortcodes | WordPress 私的マニュアル
add_shortcode | WordPress Codex 日本語版
shortcode_exists | WordPress Codex 日本語版
remove_shortcode | WordPress Codex 日本語版
remove_all_shortcodes | WordPress Codex 日本語版
add_shortcode() | WordPress Developer Resources [Official]
属性 (shortcode_atts)
参考：
便利なショートコードの基本的な書き方と使い方 | KERENOR
shortcode_atts と extract | 団地デバッグ
WordPress で引数ありのショートコードを作成する方法をとっても丁寧に説明します | いつも隣にITのお仕事
shortcode_atts | WordPress 私的マニュアル
shortcode_atts | WordPress Codex 日本語版
How to add attributes to a shortcode – WordPress Development Stack Exchange
Shortcode attributes don’t appear? – WordPress Development Stack Exchange
Shortcode empty attribute – WordPress Development Stack Exchange
ウィジェットでショートコードを使う
次のコードを function.php に追加する。
add_filter( 'widget_text', 'do_shortcode' );
参考：
ウィジェットでショートコードを利用する方法 | Dolce & Vivace
サイドバーウィジェットでショートコードを呼び出す | 100ウェブ
WordPress のウィジェットでショートコードを実行できるようにするための手順 | virtualiment
改行コードの処理 (wpautop / shortcode_unautop)
ショートコード内に空の p タグが挿入されてしまうのを防ぐには次のコードを function.php に追加する。
remove_filter( 'the_content', 'wpautop' ); add_filter( 'the_content', 'wpautop', 99 ); add_filter( 'the_content', 'shortcode_unautop', 100 );
参考：
WordPress のショートコードが p タグで囲まれてしまうのを最も簡単に除去する方法 | かゆいところに手が届く開発・PC設定メモ
WordPress でショートコードが p タグで囲まれたり改行されてしまうのを防ぐ方法 | Bamboo Works
ショートコードの中にショートコードを入れることは出来るの？ | cbc-wpc
WordPress のショートコードを入れ子で展開できる形式で管理する | 東京節約ブログ
囲み型ショートコードと wpautop | WordPress 私的マニュアル
投稿内容に応じて wpautop を制御する | WordPress 私的マニュアル
WordPress で特定の部分だけ自動整形の P タグを消す | WEBUTUBUTU
WordPress の囲み型ショートコードで p や br が付くのを防ぐ方法 | モノグサにお灸
ショートコード内で改行タグ追加を無効にして停止する方法 | WP 飽きるまで。
WordPress で自動整形を部分的に無効化する方法 | キノコログ
shortcode_unautop() | WordPress Developer Resources [Official]
shortcode_unautop – WordPress/WordPress/wp-includes/formatting.php at 0b75f9557e – GitHub
remove empty <p> tags from wordpress shortcodes via a php functon – Stack Overflow
shortcode_unautop shortcode not functioning – WordPress Development Stack Exchange
How to prevent newline from appearing in shortcode? – WordPress Development Stack Exchange
Is shortcode_unautop() broken? – WordPress Development Stack Exchange
Prevent shortcode from being wrapped in <p> tags – WordPress Development Stack Exchange
ショートコードで改行を追加する
参考：
WordPress で2行以上改行する方法 | teratail
strip_shortcodes
参考：
抜粋文からショートコード タグを消す方法 | デザイナーのタネあかし
WordPress のショートコード (自作コードにも対応) を削除して抜粋文を得る方法 | KuroBox
strip_shortcodes | WordPress 私的マニュアル
strip_shortcodes | WordPress Codex 日本語版
strip_shortcodes() | WordPress Developer Resources [Official]
実装／関数／グローバル変数
関数
- apply_shortcodes
- do_shortcode
グローバル変数
- $shortcode_tags
参考：
apply_shortcodes | WordPress 私的マニュアル
do_shortcode | WordPress 私的マニュアル
$shortcode_tags | WordPress 私的マニュアル
WordPress/WordPress/WordPress/wp-includes/shortcodes.php – GitHub