WordPressショートコードの属性とは？書き方と変更してよい値の見分け方

ショートコードの属性とは、タグ名の後ろへ付ける「設定名＝値」です。 たとえば [gallery ids="12,34" columns="2"] の ids と columns が設定名、引用符内が値です。変更してよいのは、WordPress本体やプラグインの説明に候補が示されている値だけです。

一行を3つに分けて読む

                        
                            [gallery ids="12,34" columns="2" size="medium"]
                        
                    

部分	役割	この例
タグ名	呼び出す機能	gallery
属性名	変えたい項目	ids 、 columns 、 size
値	具体的な指定	12,34 、 2 、 medium

空白は属性同士の区切りです。値に空白を含む可能性があるため、初心者は値を半角の二重引用符で囲みます。属性名の大文字・小文字や許容値は製品の説明どおりにします。

変更してよい値を判断する

1. ショートコードを発行した公式画面または公式マニュアルを開く
2. 変更したい見た目や動作を言葉にする
3. 該当する属性名と許容値を探す
4. 元の一行を別メモへ保存する
5. 一度に一属性だけ変更する
6. プレビューで結果を比較する

たとえば列数を変えたいなら columns だけを変更します。 id や ids は、表示対象を特定する番号である場合が多く、見た目を変える目的で触りません。

自己完結型と囲み型を取り違えない

[gallery ids="12,34"] のように一つのタグで終わる形は自己完結型です。一方、 [sample_box color="blue"]ここに文章[/sample_box] のように開始タグと終了タグで文章を囲む形もあります。 sample_box は形を説明する架空例です。囲み型では、末尾の終了タグまで一組として残します。

終了タグを消すと、後ろの文章まで意図しない範囲として扱われることがあります。属性を直す目的なら、囲まれた本文と終了タグには触れません。発行元が自己完結型を案内しているのに、見よう見まねで終了タグを足すこともしません。

変更前後を一行ずつ比較する

確認	ショートコード	結果
変更前	[gallery ids="12,34" columns="2"]	2列で表示
変更後	[gallery ids="12,34" columns="3"]	3列で表示
戻す時	[gallery ids="12,34" columns="2"]	元の2列へ戻る

この比較では columns の値だけが変わり、画像IDは同じです。プレビューで別の画像が出たなら、列数ではなく ids まで変えていないかを確認します。目的外の変化が一つでもあれば公開せず、保存した変更前の一行へ戻してください。

よくある書式ミス

• columns＝"2" のように全角イコールを使う
• columns=“2” のように曲がった引用符へ変わる
• 属性間の空白を消して "2"size と続ける
• 説明にない属性を別製品の記事から追加する
• 開始タグだけ変え、終了タグとの名前を揃えない

属性変更の成功条件

• 目的の一項目だけが変わった
• 角括弧の文字が公開ページに残らない
• PCとスマートフォンの両方で読める
• フォームやボタンなど本来の操作が動く
• 元の値へ戻せるメモがある

新規サイトを小さく始めるなら

属性編集はサーバー契約と無関係で、既存サイトの乗り換えは不要です。これから練習用を含む新規WordPressを作る人だけ、低価格帯の開始条件を確認してください。

広告・PRを含みます。すでにWordPressを運営中なら、ショートコードのためだけにサーバーを乗り換える必要はありません。新しくサイトを始める人だけ、公式ページで最新料金と条件を確認してください。

よくある質問

属性の順番は変えてよいですか？

多くのショートコードでは名前付き属性の順番は結果へ影響しませんが、初心者は公式例の順を保つと比較しやすく安全です。

値の引用符は必須ですか？

空白のない値では省略できる場合もありますが、公式例どおり引用符を付けると境界が明確です。

知らない属性を追加するとどうなりますか？

無視される場合もあれば、製品独自の処理になる場合もあります。説明にない属性は追加しません。

属性を左から読む練習

[gallery ids="12,34" columns="2" size="medium"] を例に、最初の gallery が機能名、その後ろが属性です。属性は空白で区切られ、イコールの左が設定名、右の引用符内が値です。文章として読まず、組ごとに区切ると変更場所が見えます。

1. ids="12,34" は表示対象
2. columns="2" は列数
3. size="medium" は画像サイズ

列数だけを変えたいなら、 columns の値以外は残します。画像IDまで変えると、列数の確認ではなく別画像の表示確認になってしまいます。

値の種類を見分ける

値の種類	例	確認方法
ID	id="27"	管理画面の対象番号と一致
件数	count="6"	0や上限の扱いを公式説明で確認
選択肢	order="date"	許可された英単語だけを使う
真偽	title="true"	true/falseか1/0かを製品別に確認
複数値	ids="12,34"	区切りがカンマか空白か確認

同じ意味でも製品により書式が違います。真偽値を yes で受け取る製品もあれば、 true や 1 だけを受け取る製品もあります。推測で日本語を入れず、公式例の候補から選びます。

引用符と空白を壊さず編集する

値を囲む引用符は半角の二重引用符を基本にします。スマートフォンの入力補助や文書ソフトは、引用符を曲がった記号へ置き換えることがあります。ショートコードは装飾文字を文章の引用符としてではなく、値の境界として読むため、見た目が似ていても同じではありません。

状態	例	判断
正しい	columns="2" size="medium"	属性間に半角空白
空白なし	columns="2"size="medium"	二つの属性を分けられない
全角記号	columns＝"2"	イコールを認識できない
曲がった引用符	columns=“2”	値の境界として不適切

一属性ずつ検証する実例

2列を3列へ変える場合、変更前をメモへ残し、 columns="2" だけを columns="3" へ変えます。プレビューで画像が3列になり、画像の種類と順番が変わっていなければ目的どおりです。スマートフォンで小さすぎるなら、CSSを足す前に2へ戻します。

画像サイズを変える場合も同じです。 size="medium" だけを公式にある large などへ変更し、読み込み画像、ぼやけ、ページ幅を確認します。列数とサイズを同時に変えると、どちらが崩れの原因か分かりません。

囲み型属性を安全に直す

[sample_box color="blue"]本文[/sample_box] では、開始タグの属性、囲まれた本文、終了タグの三つがあります。色だけを変えるなら blue だけを変更し、本文と終了タグは残します。終了タグ名が開始タグと違うと、後続文章まで巻き込む可能性があります。

囲み型か自己完結型かは、発行元の例で判断します。独自判断で終了タグを追加したり、不要だと思って削除したりしません。変更後は該当部分だけでなく、その後の見出しや文章の表示も確認します。

属性編集の検査表

• 変更目的を一文で書いた
• 該当する属性名を公式説明で確認した
• 元の一行を保存した
• 一つの値だけ変更した
• 対象IDや本文を変えていない
• PC・スマートフォンで比較した
• 本来の操作が変わっていない
• 問題時に元の一行へ戻せた

説明にない値を試さなければならない時点で、初心者向けの単純な属性変更を超えています。公開サイトで実験を続けず、製品公式のサポート範囲を確認してください。

まとめ

属性は「設定名＝値」の組で、ショートコードの表示や対象を調整します。目的に合う属性を公式説明で確認し、元の一行を保存してから一項目ずつ変更します。PC・スマートフォンと本来の操作まで確認できたら完了です。

次に読むと理解しやすい記事

• 次に読む WordPressショートコードとは？初心者向けに書き方・貼る場所・表示例を解説
• 次に読む WordPressのショートコードがそのまま表示される原因は？7つの確認手順
• 次に読む WordPressブロックエディターでショートコードを入れる方法｜段落・HTMLとの違い
• 次に読む プラグイン削除後にショートコードが残った時の直し方｜安全な探し方と置き換え