WordPressのウィジェットでショートコードを使う方法add_filter
2014/07/06
WordPressのウィジェットでショートコードを実行する
ショートコードとは?
投稿ページや固定ページで PHPの実行結果を編集したい場合には add_shortcode関数を利用したショートコードを使用します。
そのショートコードの詳細な使い方については「WordPress投稿にPHPを記述するショートコードの使い方add_shortcode」に詳しく書いていますのでそちらをご覧ください。
2014.06.07 追記
ウィジェットの設定に関しては、「WordPressのサイドバー(サイドナビ)はウィジェットで編集」に書いていますので、併せて参照ください。
ウィジェットでショートコードを使えるようにする方法
上記の使い方の通り「functions.php」に 関数とショートコードを呼び出す add_shortcodeを記述すれば、投稿ページや固定ページでは PHPの処理を実行した結果が編集されますので、ウィジェットでも処理されるはず、と思っていたのですが、ウィジェットでは動かないのです。
実は、ショートコードをウィジェットで動かすためには、それ用の add_filterという記述をする必要があったのです。
それは、下記の 1行を functions.phpに追記することです。
————————————
1 |
add_filter('widget_text', 'do_shortcode' ); |
————————————
add_filterを書いておけばいい、それが分かってしまえば実に簡単です。
上記の add_filterの 1行を記述する場所は functions.phpの中であればどこでも構いませんが、分からなくならないように、ショートコードの関数を記述する数行上くらいに書いておくといいでしょう。
ちなみに、functions.phpが置いてある場所は、下記のファイルになります。
1 |
/{WordPressがインストールされている場所}/wp-content/themes/{テーマ名}/functions.php |
詳しくは、「WordPressの functions.phpがある場所」にも記事を書いています。
ウィジェットでショートコードを使えるようにする方法・その2
ウィジェットにショートコードを記述した場合、ショートコードが処理されず、ショートコードのコードそのものが表示されてしまうのは、ショートコードのパース処理が通らないことでプレーンテキストとして見られてしまうことに原因があります。
そのため、下記のように、ショートコードを実行する関数を通すことで情報を取得し、echoで表示させる、という方法もあります。
1 |
<?php echo( do_shortcode( '[shortcode1]' ) ); ?> |
※「shortcode1」は、「WordPress投稿にPHPを記述するショートコードの使い方add_shortcode」で作成したショートコードの関数です。
こちらの方法は、テンプレートでショートコードを表示させる際に利用する処理と同じですね。
GoogleAdwords
GoogleAdwords
この記事が参考になったと思いましたらソーシャルメディアで共有していただけると嬉しいです!
関連記事
-
-
ショートコードで簡単解決!カスタムフィールドでソート、抽出条件設定方法
ショートコードを使って固定ページや投稿に特定のカテゴリ一覧を編集する処理に、ソート条件、抽出条件も設定できる処理を作成。カスタムフィールドも条件に利用可。
-
-
ロリポップでWordPress+Basic認証で不具合発生!回避方法解説
ロリポップサーバでWordPressを使いBasic認証を設定する際には注意しないとWordPressが動かなくなる場合も!その回避方法を解説します。
-
-
カスタムフィールドの検索処理をget_posts()関数のmeta_queryで作成しそれを解説
カスタムフィールドを条件検索・抽出する機能開発の解説。サンプルソースをコピペすればOK。詳細解説もあるのでカスタマイズもできる!
-
-
WordPressで月極駐車場検索サイトを構築し無料公開・使ったプラグインの紹介も
月極駐車場を検索するシステムをWordPressで構築。そのアナウンスと構築するために利用したプラグインの紹介。構築にどれくらいの期間がかかるのかの紹介。
-
-
BackWPupでバックアップ・リストア(復元)の具体的手順
BackWPupその9。バックアップファイルからのリストア(復元)の手順です。
-
-
WP Mail SMTPはPHP5.6、7.0系ではメール送信時にエラーが発生。その対処方法。
PHPのバージョンを5.6(7系含む)にアップデートしたらプラグイン WP Mail SMTPを利用してSMTPサーバ経由して送信していたメールが送信できなくなった。その原因と対処方法を詳細解説。
-
-
WordPressのコメントスパム対策 3つのプラグイン
対策なしではコメントスパムがやってきます。その対策方針としてプラグインを提示しながら解説します。いずれかの対策は必須です。
-
-
Throws SPAM Awayでコメントスパム対策を完璧に。自動削除で運用の手間ゼロ
コメントスパム対策の決定版ともいうべきプラグイン。簡単な設定で自動的にスパムコメントを削除してくれるので煩わしい作業はゼロに。細かな設定も可能。
-
-
シンタックスハイライトの5システム比較のまとめ・WordPressでも使える
シンタックスハイライト5種の比較検討のまとめ記事。WordPressで使う目的だがプラグインの比較検討ではないのでどのサイトでも導入可能。
-
-
wp_mail()関数でWordPressのスパム対策済のメールフォーム作成
WordPressでメール送信フォームを作成するための関数「wp_mail()」の使い方の解説。CC、BCC、添付ファイルも HTMLメールも設定可能。
Comment
初めまして
江村と申します。
記事を拝見した中で質問がございます。
私もウィジェットにショートコードを表示したいと考えています。
add_filter(‘widget_text’, ‘do_shortcode’ );
をfunctions.phpに記述し、
ウェルカートのカートに入れるのショートコード
[button_to_cart item=”h-001″ sku=”h-001-01″ value=””]
をウィジェットに表示したいので、テキストに記述しましたが、
プレーンテキストとして認識されました。
ですので、
function shortcode1Func() {
return “カート”;
}
add_shortcode((‘widget_text’, ‘do_shortcode’ );
と記述し、
ウィジェットのテキストに
[shortcode1]
を記述しましたが、反映されませんでした。
何か間違っている所はありますか?
ご多忙とは存じますが、宜しくお願いします。
江村さん、コメントありがとうございます。
長期休暇中のため、返信が遅くなりました。
ウェルカートのショートコードに関しては検証していませんが、サンプルで作成された方に関しては、以下のようになります。
function shortcode1Func() {
return "カート";
}
add_shortcode('shortcode1', 'shortcode1Func');
add_filter('widget_text', 'do_shortcode' );
これでショートコードとして「[shortcode1]」を編集すると、そこに「カート」と文字が編集されます。
「add_filter...」は、「add_shortcode...」の代わりになるものではなく、ショートコードを処理する箇所が本文中だけではなく、ウィジェットのエリアでも処理しますよ、というフィルターを追加する記述になります。
ですので、「add_shortcode...」の本来のショートコードの処理はすべて同じように記述します。