Title: Debug Bar Shortcodes Author: Juliette Reinders Folmer Published: 2013年12月22日 Last modified: 2016年4月30日 --- プラグインを検索 ![](https://ps.w.org/debug-bar-shortcodes/assets/banner-772x250.png?rev=826846) このプラグインは **WordPress の最新3回のメジャーリリースに対してテストされていま せん**。もうメンテナンスやサポートがされていないかもしれず、最新バージョンの WordPress で使用した場合は互換性の問題が発生する可能性があります。 ![](https://ps.w.org/debug-bar-shortcodes/assets/icon-256x256.png?rev=981236) # Debug Bar Shortcodes 作者: [Juliette Reinders Folmer](https://profiles.wordpress.org/jrf/) [ダウンロード](https://downloads.wordpress.org/plugin/debug-bar-shortcodes.2.0.3.zip) * [詳細](https://ja.wordpress.org/plugins/debug-bar-shortcodes/#description) * [レビュー](https://ja.wordpress.org/plugins/debug-bar-shortcodes/#reviews) * [インストール](https://ja.wordpress.org/plugins/debug-bar-shortcodes/#installation) * [開発](https://ja.wordpress.org/plugins/debug-bar-shortcodes/#developers) [サポート](https://wordpress.org/support/plugin/debug-bar-shortcodes/) ## 説明 Debug Bar Shortcodes は、現在のリクエスト用に登録されたショートコードを表示する、 新しいパネルを [Debug Bar](https://wordpress.org/plugins/debug-bar/) に追加します。 加えて、以下のようなことも表示されます: * ショートコードによって呼び出される関数/メソッド * ショートコードが、現在の投稿/ページ/投稿タイプで使用されるかどうか、またどのよう に使用されるか (個別の場合のみ) * 説明、どのパラメータを受け取るか、自己閉じ型か否か、など、ショートコードについて 利用可能な追加情報。 _独自のショートコードについて表示される追加情報を制御した いですか ? できます ! 詳しくは [FAQ](https://wordpress.org/plugins/debug-bar-shortcodes/faq/) をご覧ください。_ * ショートコードが使用されているすべてのページ/投稿/その他を検索する このプラグインは [LRH-Shortcode list](https://wordpress.org/plugins/lrh-shortcode-list/) および [Shortcake/Shortcode UI](https://wordpress.org/plugins/shortcode-ui/)プラグ インと互換性があります。これらのプラグインに提供されたショートコードに関する追加 情報は、このプラグインでも反映され、利用できるようになります。 #### ショートコードを理解することが、なぜ、役に立つのですか ? 私が思いつく典型的な使い方は、いくつもあります: * あなたが**_ブログの作者_**の場合: - 投稿/ページで使用できるショートコードを知るためです。 - プラグインを切り替えたり、プラグインを削除した場合、どの投稿/ページで古いショート コードを削除/置換する必要があるかを知ることができます。 * あなたが **_web デザイナー / web マスター_**の場合: - プラグインを切り替えたり、プラグインを削除した場合、どの投稿/ページで古いショート コードを削除/置換する必要があるかを知ることができます。 - テーマファイルで使用できるショートコードを知るためです。 - ウェブサイト固有のショートコードとの、名前の衝突を避けるためです。 * あなたが**_開発者_**の場合: - 他のプラグイン/テーマによって登録されたショートコードとの、名前の衝突を避ける ためです。 - ショートコードが正しく登録されているか、条件分岐が正しく適用されているかを チェックするためです。 #### 重要 このプラグインを使用するには、[Debug Bar](https://wordpress.org/plugins/debug-bar/) プラグインがインストールされ、有効になっている必要があります。 #### 謝辞 * 付加情報機能は、[LRH-Shortcode list](https://wordpress.org/plugins/lrh-shortcode-list/) と [Shortcode reference](https://wordpress.org/plugins/shortcode-reference/) を参考にしています。 * サイト全体を通してのショートコード使用の発見は、[TR All Shortcodes](https://wordpress.org/plugins/tr-all-shortcodes/) に触発されています。 このプラグインが気に入ったら、[評価やレビュー](https://wordpress.org/support/view/plugin-reviews/debug-bar-shortcodes) をお願いします。このプラグインをより良くするためのアイデアやバグを見つけた場合は、 [サポートフォーラム](https://wordpress.org/support/plugin/debug-bar-shortcodes)または [GitHubリポジトリ](https://github.com/jrfnl/Debug-Bar-Shortcodes/issues)で報告し てください。 ## スクリーンショット * [[ * ショートコードを表示する Debug Bar * [[ * Web フロントエンド単数でショートコードを表示する Debug Bar * [[ * Debug Bar Shortcodes – 作者によって提供された場合の、ショートコードの詳細情報 の例 * [[ * Debug Bar Shortcodes – ショートコードのドキュメントから取得した情報に基づく、 ショートコードの詳細情報の例 * [[ * Debug Bar Shortcodes – サイト全体に見られるショートコードの使用例 ## インストール 1. インストールされてない場合は、 Debug Bar (https://wordpress.org/plugins/debug-bar/) をインストールします。 2. このプラグインの .zip ファイルを解凍し、その内容を `/wp-content/plugins/` ディレクトリ にアップロードします。または、WordPress インストール内の Plugin ディレクトリから 直接インストールすることもできます。 3. 「プラグイン」メニューからプラグインを有効化します。 このプラグインを本番サイトで使用する際はご注意ください。このプラグインは開発目的 のために設計されています。 ## FAQ 本番のサイトで使用できますか ? このプラグインは開発目的でのみ使用することを意図していますが、本番サイトで使用し ても問題は発生しません。 ショートコードとは ? > ショートコードは、WordPress 特有のコードで、わずかな労力で気の利いたことができる > ようになります。ショートコードは、ファイルを埋め込んだり、通常は複雑で醜いコード > をたくさん必要とするオブジェクトを、たった1行で作成できます。ショートコード = > ショートカットです。 > [ソース](http://en.support.wordpress.com/shortcodes/) WordPress でショートコードを使用する方法については、以下を参照してください: – [WP Codex 上のショートコード](https://codex.wordpress.org/Shortcode)– [WP Codex 上の Shortcode API](https://codex.wordpress.org/Shortcode_API) 私のショートコードがリストにないのは、なぜ ? 2つの可能性があります: * ショートコードが ShortCode API を使用して[正しく登録されていない](https://codex.wordpress.org/Function_Reference/add_shortcode) 可能性があります。 * あるいは、ショートコードが条件付きでしか登録されておらず、現在のページがその条件 を満たしていないのかもしれません。 ショートコードの数は、リクエストされたページによって異なります。どうして ? 前の回答を参照してください。 ページ *xyz* でショートコード *abc* を使っているのですが、使用されていると表示 されません ! ページ内でショートコードが使用されているかどうかを判断するために、_**投稿内容**_ のみが評価されます。他のエリア (例: ウィジェット) やテーマ経由でショートコードを 使用してページにコンテンツを追加した場合、それらの使用は認識されません。 私が作っているテーマで、これらのショートコードを使うことはできますか ? 一般的には可能です。ただし、使用する前に必ず[ショートコードが登録されているかチェックする](https://codex.wordpress.org/Function_Reference/shortcode_exists) ことをお忘れなく! すべてのページで使えるとは限りませんし、すべての WP インストール で使えるとも限りません。 ``` if ( shortcode_exists( 'shortcode' ) ) { /* Your code here */ // echo do_shortcode( 'some content containing a [shortcode /]' ); } ``` 私は開発者で、このプラグインによって表示される自分のショートコードに関する情報 を充実させたいと思っています。 できる限り簡単で苦痛のないようにしたつもりです。 フィルタを追加するだけで、このプラグインが持つショートコードに関する情報を充実させる ことができます。最も簡単な方法は、ショートコードにのみ適用される `db_shortcodes_info_{ shortcode}` フィルターを使うことです。 ``` add_filter( 'db_shortcodes_info_{your_shortcode}', 'filter_my_shortcode_info' ); function filter_my_shortcode_info( $info ) { // enrich the object return $info; } ``` あなたが受け取り、返すことが期待されている `$info` オブジェクトは、ショートコード に関する現在の既知の情報を含んでいます。 ``` $info is expected to contain (a selection of) the following parameters: stdClass( $name = (string) 'Friendly name for your shortcode', $description = (string) 'Description of your shortcode', $self_closing = (bool) true/bool, // whether the shortcode is self-closing $parameters = array( 'required' => array( (string) 'attribute_name' => (string) 'attribute description', ), 'optional' => array( (string) 'attribute_name' => (string) 'attribute description', ), ), $info_url = '', ) ``` [LHR-Shortcode list](https://wordpress.org/plugins/lrh-shortcode-list/) プラグイン 用の `sim_{shortcode}` フィルタを使用して同様の情報をすでに提供している場合は、余計 なことをする必要はなく、その情報はこのプラグインによってピックアップされます。 同様に、[Shortcake/Shortcode UI](https://wordpress.org/plugins/shortcode-ui/) 機能 プラグインに情報を提供した場合、その情報は利用可能な情報を充実させるために自動的 に使用されます。 ちょっと待って – フィルターの挙動が変わった ?!? プラグインのバージョン1.0では、フィルターに渡される変数 `$info` は配列でした。これ はバージョン2.0で変更されました。 これが後方互換性の破壊であることは承知しています。しかし、かなり広範囲に検索して みましたが、このフィルターを使用しているプラグインは (まだ) 見つかりませんでした。 したがって、この後方互換性の破壊はほとんど影響がなく、安全に実装できると判断しま した。 _既に_フィルターがあるのなら、あなたのプラグインやテーマを見つけられませんでした! でも心配しないでください。コードをアップグレードするのはとても簡単です。 まず最初 に、コード内の `add_filter()` フックと関数のシグネチャを、2つの変数を受け取るよう に変更する必要があります。最初の変数は新しいオブジェクトになりますが、2番目の変数 は1.0で渡されたフォーマットの配列のままなので、情報を充実させるために関数内でそれ を使い続けることができます。 次に、このプラグインが使用するのはオブジェクトのプロパティ だけなので、return で配列をオブジェクトにキャストするだけで、再び機能するようになり ます。 Old code for v1.0: ``` add_filter( 'db_shortcodes_info_{your_shortcode}', 'filter_my_shortcode_info' ); function filter_my_shortcode_info( $info ) { // enrich the array return $info; } ``` Updated code for v2.0: ``` add_filter( 'db_shortcodes_info_{your_shortcode}', 'filter_my_shortcode_info', 10, 2 ); function filter_my_shortcode_info( $info_object, $info ) { // enrich the array return (object) $info; } ``` プラグインが有効にならないのは、なぜ ? プラグインページの一番上にある美しく赤いバーに書いてあることを読みましたか ? そこ に書いてある通り、このプラグインが動作するには Debug Bar プラグインが有効である必要 があります。Debug Bar プラグインが有効でない場合、このプラグインは自動的に無効化 されます。 ## 評価 ![](https://secure.gravatar.com/avatar/1df3263f8c72296a7ed3bde40994b914b4c1eb38285de9e0055ced376c47d028? s=60&d=retro&r=g) ### 󠀁[Works great](https://wordpress.org/support/topic/works-great-5384/)󠁿 [dahousecatz](https://profiles.wordpress.org/dahousecatz/) 2018年11月15日 Still works great with WP 4.9.8. ![](https://secure.gravatar.com/avatar/bbf1db9a75131ceff37a58c8613ef2d4d53efa72cf70b87656118f3b8114f9f9? s=60&d=retro&r=g) ### 󠀁[Great Plugin!](https://wordpress.org/support/topic/great-plugin-10480/)󠁿 [Joel Cañas](https://profiles.wordpress.org/joeladolfo2008/) 2016年9月3日 More info for debugging! [ 3件のレビューをすべて表示 ](https://wordpress.org/support/plugin/debug-bar-shortcodes/reviews/) ## 貢献者と開発者 Debug Bar Shortcodes はオープンソースソフトウェアです。以下の人々がこのプラグイン に貢献しています。 貢献者 * [ Juliette Reinders Folmer ](https://profiles.wordpress.org/jrf/) “Debug Bar Shortcodes” は1ロケールに翻訳されています。 [翻訳者](https://translate.wordpress.org/projects/wp-plugins/debug-bar-shortcodes/contributors) のみなさん、翻訳へのご協力ありがとうございます。 [“Debug Bar Shortcodes” をあなたの言語に翻訳しましょう。](https://translate.wordpress.org/projects/wp-plugins/debug-bar-shortcodes) ### 開発に興味がありますか ? [コードを閲覧](https://plugins.trac.wordpress.org/browser/debug-bar-shortcodes/) するか、[SVN リポジトリ](https://plugins.svn.wordpress.org/debug-bar-shortcodes/) をチェックするか、[開発ログ](https://plugins.trac.wordpress.org/log/debug-bar-shortcodes/) を [RSS](https://plugins.trac.wordpress.org/log/debug-bar-shortcodes/?limit=100&mode=stop_on_copy&format=rss) で購読してみてください。 ## 変更履歴 #### 2.0.3 (2016-04-29) * `must-use` プラグイン・ディレクトリにあるプラグインを使用することで、text-domain のロードを互換性のあるものにします。 * 細かな手入れ。 * Tested & found compatible WP 4.5. #### 2.0.2 (2016-01-10) * WordPress 4.2以降動作しなくなっていた AJAX リクエスト用のスピナーを修正。 #### 2.0.1 (2015-12-26) * Twenty-Sixteen テーマとの組み合わせで、フロントエンドのテーブルレイアウトがおかし かったのを修正。 #### 2.0 (2015-12-14) 重要: プラグイン/テーマの開発者で、`'db_shortcodes_info_{your_shortcode}'` フィルタ を使用していた場合: このフィルタの挙動は、配列渡しからオブジェクト渡しに変わりま した。この変更に対処する方法については、[FAQ](https://wordpress.org/plugins/debug-bar-shortcodes/faq/) を読んでください! * 機能強化: [Shortcake](https://wordpress.org/plugins/shortcode-ui/) から入手可能 なショートコード情報のサポートを追加。 * 機能強化: 少なくとも、同じディレクトリに複数のプラグインが見つかった場合は、プラグ インのURLを検出するようにする。 * バグ修正: コールバックとしてクロージャを持つショートコードの情報が取得されてい なかった。(クロージャに対してリフレクションオブジェクトが取得されていなかった。) * 互換性の修正: WordPress 4.4用のレイアウトを修正するために html をマイナーチェンジ。 * 利便性: テーブルヘッダの揃えを改善。 * 利便性: タイトルだけでなく、行の上にカーソルを置くと、行のアクションが表示される ようになった。 * 利便性: Glotpress / WordPress の翻訳との互換性が向上。 * 細かな手入れ。 * WordPress 4.4との互換性を確認。 #### 1.0.3 (2014-12-18) * 追加: WordPress ネイティブ・ショートコード `playlist` についてのより詳細な情報。 * WordPress 4.1との互換性を確認。 #### 1.0.2 (2014-09-05) * プラグイン [Plugin Dependencies](https://wordpress.org/plugins/plugin-dependencies/) との互換性を修正。 * WordPress 4.0との互換性を確認。 #### 1.0.1 (2014-04-19) * 修正: 投稿コンテンツ内のショートコードの検索を改善。 * 修正: マイナーな HTML エラー。 * 修正: マイナーな PHP エラー。 #### 1.0 (2013-12-22) * 最初のリリース。 ## メタ * バージョン **2.0.3** * 最終更新日 **10年前** * 有効インストール数 **40+** * WordPress バージョン ** 3.6またはそれ以降 ** * 検証済み最新バージョン: **4.4.34** * 言語 * [English (Canada)](https://en-ca.wordpress.org/plugins/debug-bar-shortcodes/)、 [English (US)](https://wordpress.org/plugins/debug-bar-shortcodes/). * [プラグインを翻訳](https://translate.wordpress.org/projects/wp-plugins/debug-bar-shortcodes) * タグ * [debug bar](https://ja.wordpress.org/plugins/tags/debug-bar/)[debugbar](https://ja.wordpress.org/plugins/tags/debugbar/) [shortcodes](https://ja.wordpress.org/plugins/tags/shortcodes/) * [詳細を表示](https://ja.wordpress.org/plugins/debug-bar-shortcodes/advanced/) ## 評価 5つ星中5つ星 * [ 3 5-星レビュー ](https://wordpress.org/support/plugin/debug-bar-shortcodes/reviews/?filter=5) * [ 0 4-星レビュー ](https://wordpress.org/support/plugin/debug-bar-shortcodes/reviews/?filter=4) * [ 0 3-星レビュー ](https://wordpress.org/support/plugin/debug-bar-shortcodes/reviews/?filter=3) * [ 0 2-星レビュー ](https://wordpress.org/support/plugin/debug-bar-shortcodes/reviews/?filter=2) * [ 0 1-星レビュー ](https://wordpress.org/support/plugin/debug-bar-shortcodes/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/debug-bar-shortcodes/reviews/#new-post) [すべてのレビューを見る](https://wordpress.org/support/plugin/debug-bar-shortcodes/reviews/) ## 貢献者 * [ Juliette Reinders Folmer ](https://profiles.wordpress.org/jrf/) ## サポート 意見や質問がありますか ? [サポートフォーラムを表示](https://wordpress.org/support/plugin/debug-bar-shortcodes/) ## 寄付 このプラグインが今後も改善できるよう応援しませんか ? [ このプラグインに寄付 ](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=995SSNDTCVBJG)