WordPressで独自のショートコードをプラグインレスで設定

WordPress™の投稿本文内に対して埋め込み挿入を行いたいものがあるときに、
投稿本文内では動作しない場合はよくあります。

ビジュアルエディタに戻した際にタグが変更されてしまうものもあれば、
PHPコードのようにエスケープされ実行されないものもあります。

そうした本文内に対して埋め込みを行うことが困難な要素を、
埋め込んで表示したい場合には独自のショートコードを設定すると簡単に設置することができます。

そうしたfunctions.phpでショートコードを独自に作成する方法をご紹介します。

はじめに

functions.phpを編集すればプラグインなどでちょうどいいものが見当たらない場合でも、
自分で実現したい機能を自在に導入することができます。

functions.phpの編集を行うこと自体はテーマの編集から行うことができて、
好きに編集をすることができますが、
導入しているテーマファイルの編集を行った場合には、
テーマのアップデートによって編集内容が失われてしまいます。

functions.phpを編集するに当たっては面倒でも子テーマを利用して、
編集用のfunctions.phpを用意してから編集することをお勧めします。
WordPressのfunctions.php編集には子テーマを利用

functions.phpへのショートコード定義

functions.phpに対してショートコードを定義する際のもっとも簡単な例は以下のような感じです。
子テーマディレクトリに対して配置したfunctions.phpを編集します。

functions.phpの設置

functions.phpに対しては以下のように記述しています。

これによって、ショートコード[my-shortcode]を投稿本文に挿入することで、
「my-shortcodeによって出力されています」と出力されるものです。

実際にショートコードを投稿本文内に挿入すると以下のように表示されます。

ショートコードによる出力

このようにして、投稿エリアに対して実行したいPHPコードをショートコードで定義し、
投稿エリアの好きな部分に対して挿入することができます。

応用例

こうしたショートコードの埋め込み方法は以下のように自在に応用することができます。

複数行HTML出力

たとえば、ショートコードを指定して直接HTMLを出力する場合でも、
行数の多いHTMLをreturnで記述するのは非常に面倒です。
そんな場合には以下でご紹介するような記述を行うと、簡単にHTMLを出力することができます。

WordPressの独自ショートコードを設定し複数行HTMLを出力

こうしたHTMLの出力ではWordPressの本文に埋め込みがうまくいかない場合が多い、
iframeタグを含むような埋め込みでは非常に便利です。

JavaScript出力

HTMLの出力例と処理方法は同じですが、
内容を変更すればJavaScriptでも簡単に出力を行うことができます。

WordPressの独自ショートコードを設定し複数行JavaScriptを出力

パラメータ指定による外部ファイル出力

また、ショートコードにパラメータを指定することによって、
出力を行うソースファイルを切り替えて、出力ソースを都度変更することも可能です。

WordPressの独自ショートコードによって埋め込み外部ファイルを指定する

さいごに

今回は１行の簡単なPHPコードをショートコードにて出力を行いましたが、
PHPで実行できるソースであればどのようなものでも、ショートコード化することができ非常に便利です。

当然ながらショートコードですので、
IME辞書などに登録して呼び出して効率的に入力するようにすると便利です。

参考

ショートコード API – WordPress Codex 日本語版

WordPressはWordPress Foundation の登録商標（第５０４９９６５号）です。
WordPressロゴ、アイコンその他のマーク等はWordPress Foundation の商標であり、
WordPress Foundation の著作物です。
WordPress.comはWordPress Foundation が管理運営を行うドメインならびにサービスの名称です。

*本ページ内に記載されされた各社ブランド、サービス名、商標、登録商標については、
各社ブランドのロゴや商標等に関する帰属についてをご確認ください

最後までお読みいただきありがとうございました。

お勧めさせて頂きたい投稿です

• 【巧妙な仕組】Google+へAndroidの写真が勝手にアップロードされてしまう流れは設定ミスではない

• JetPackサイト統計データが消えた場合に復活する手順(してもらう)

• 【待望】WALLET ポイントがauID(au電話番号)間で相互にやりとりできるようになりました

• 禁断の機能がau公式解禁！WALLETポイントの現金化がついに開放。

• 何もしないと、auポイントが2014/05月分以降は携帯利用料から付与されなくなります

• au WALLET™カードはauを解約してもプリペイドとして使い続けられるが、有効期限には注意

• じぶん銀行が動いた！コンビニATM利用が無料・他行振込無料（回数制限なし）で使える

• 【旬】「白すぎる」と賛否両論？姫路城見るなら今秋がおすすめ！その理由は？｜castlehimeji.com

• Google+の投稿が勝手に自動でブログになっていくPluCialが便利



アイキャッチ画像に利用させて頂いております、各社ブランドのロゴやシンボルに関しては、
各社ブランドのロゴや商標等に関する帰属についてをご確認頂けますようお願い致します。

AdMax Promotion

ブログ記事のご紹介

すべて展開 | すべて省略

Rakuten Promotion

ページ

すべて展開 | すべて省略