Breadcrumb NavXT

説明

Breadcrumb NavXT は人気のあった WordPress プラグイン Breadcrumb Navigation XT の後継で、さらなる改善に向け旧版を抜本的に見直してあります。このプラグインは、訪問者に対し現在地へのパスを表示する「パンくずリスト」ナビゲーションをサイトに追加します。追加するパンくずリストは柔軟なカスタマイズが可能で、どのようなサイトのニーズでも満たすことができます。管理画面では各種オプションを簡単に設定できます。テーマ開発者やパワーユーザー向けに、クラスへの直接アクセス手段も提供されています。

PHP要件

Breadcrumb NavXT 5.2 以降についてはPHP5.3以上。
Breadcrumb NavXT 5.1.1以前についてはPHP5.2以上。

主な特徴

  • RDFaフォーマットの、Schema.org BreadcrumbList 互換なパンくずリストを生成。
  • 設定画面でのカスタマイズによりパンくずリストの様々な拡張が可能。設定画面の各項目は、多くのユースケースに適したデフォルト値がプリセット済み。
  • マルチサイト環境の場合、サイトネットワーク管理者画面からサイトネットワーク全体の設定を行うことができ、設定によっては、サイトネットワーク全体の設定を、サブサイトの個別設定より優先させることも可能
  • サイドバーにパンくずリストを表示するウィジェットを同梱。
  • OOPによる拡張が可能で、カスタマイズ向けに種々のアクションフィルターを提供。
  • WPML 互換( WPML プラグインと互換性があり併用による機能拡張が可能)。
  • Polylang 互換( Polylang プラグインと互換性があり併用による機能拡張が可能)。
  • bbPress 互換( bbPress プラグインと互換性があり併用による機能拡張が可能)。
  • BuddyPress 互換( BuddyPress プラグインと互換性があり併用による機能拡張が可能)。

翻訳

Breadcrumb NavXT は WordPress.org のランゲージパックをサポートするようになりました。 あなたもBreadcrumb NavXT を翻訳してみませんか?。詳しくはBreadcrumb NavXTの WordPress.org 翻訳プロジェクトを御参照ください。

スクリーンショット

  • Breadcrumb NavXT が生成する5種類のパンくずリストを例示するスクリーンショット
  • 設定画面の一般タブのスクリーンショット
  • 設定画面の投稿タイプタブのスクリーンショット
  • 設定画面のタクソノミータブのスクリーンショット
  • 設定画面のその他タブのスクリーンショット
  • ヘルプ画面の、インポート/エクスポート/リセットフォームのスクリーンショット

インストール

WordPress 管理画面の 「外観 > テーマの編集」ないしお好みのテキストエディターから、お使いのテーマの然るべきファイル(通常は header.php )を開き、パンくずリストを表示させたい場所に以下のコードを書いてください。

書いたファイルを保存(ないしアップロード)してください。サイトにパンくずリストが表示されるようになります。パンくずリストをカスタマイズしたい場合は、管理画面の「設定 > Breadcrumb NavXT」からオプションを変更してください。

詳細は Breadcrumb NavXT のドキュメンテーション(英語サイト)をご覧ください。

FAQ

インストール手順

WordPress 管理画面の 「外観 > テーマの編集」ないしお好みのテキストエディターから、お使いのテーマの然るべきファイル(通常は header.php )を開き、パンくずリストを表示させたい場所に以下のコードを書いてください。

書いたファイルを保存(ないしアップロード)してください。サイトにパンくずリストが表示されるようになります。パンくずリストをカスタマイズしたい場合は、管理画面の「設定 > Breadcrumb NavXT」からオプションを変更してください。

詳細は Breadcrumb NavXT のドキュメンテーション(英語サイト)をご覧ください。

評価

Smart and handy!

I now use themes that don’t have breadcrumbs. I find them precious so I was very happy to find this plugin. It works perfectly, it’s simple to use and options are good. Thank you!

Difficult.

If this plug-in was intended for anyone less than an advanced user, it is very difficult to understand how to configure the settings, and the documentation leaves a lot to be desired.

As an experienced Web Developer, it’s possible that I will find this plug-in to be great and useful AFTER several hours of dissecting the interface; but at first glance, it is not intuitive.

For example, why do the “Template” fields include HTML tags and attributes? The tags appear to be the same in every field, e.g., <span property=”itemListElement” typeof=”ListItem”><span property=”name”>. What happens if I remove or change the value for the “property” or “typeof” attributes. In trying to determine if the tags and attributes had any relevance, I stripped the tags and left only the dynamic content such as “Page %htitle%”. The settings appeared to still work well.

As for the documentation, further explanation could be provided in layman’s terms. In particular, the section entitled “Using the Settings Page” is very brief and not well written. For instance, in the following passage, an example of stripped and unstripped title/name tags would be helpful.

    %title% The title for the breadcrumb, typically the page title/name, tags are stripped and it is run through esc_attr().

In summary, my review is not intended to criticize the functionality of the plug-in, rather it’s usability in terms of configuring the settings. As a suggestion, the interface could include a Basic mode for simplicity, and an Advanced mode (or drop-down) for fine-tuned configuration.

110件のレビューをすべて表示

貢献者と開発者

Breadcrumb NavXT はオープンソースソフトウェアです。以下の人々がこのプラグインに貢献しています。

貢献者

“Breadcrumb NavXT” has been translated into 15 locales. 翻訳者のみなさん、翻訳へのご協力ありがとございます。

“Breadcrumb NavXT” をあなたの言語に翻訳しましょう。

開発に興味がありますか ?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

変更履歴

5.7.1

リリース日: 2017年6月30日

  • Bug fix: Fixed erroneous use of $linked that caused a PHP warning in bcn_display_json_ld().
  • Bug fix: Fixed issue where removing a breadcrumb from the trail could cause one or more breadcrumb separators to inappropriately disappear.

5.7.0

リリース日: 2017年4月21日

  • New feature: Added bcn_display_json_ld() function for producing Schema.org BreadcrumbList compliant JSON-LD markup.
  • Bug fix: Fixed issue where the uninstaller caused PHP Errors when ran from WP CLI.
  • Bug fix: Fixed issue where bcn_breadcrumb_trail::find_type() caused a PHP Warnings in certain circumstances.
  • Bug fix: Fixed typo in the administrative interface.

5.6.0

リリース日: 2016年12月23日

  • New feature: Added fourth parameter, $force, to bcn_display(), and bcn_display_list() allowing the internal caching mechanism to be bypassed.
  • New feature: Moved to multiple line text boxes rather than regular single line text inputs for the breadcrumb templates in the settings page to enhance visibility.
  • Bug fix: Fixed issue where general searches had the blog breadcrumb in the breadcrumb trail.
  • Bug fix: Fixed issue where the blog breadcrumb options were erroneously made available when a Posts Page was not set.

5.5.2

リリース日: 2016年9月30日

  • 不具合修正: 設定画面における「ブログを示すパンくず」欄の設定内容がパンくずリストへのブログを示すパンくずの取り込み処理に反映されていなかった問題を修正。

5.5.1

リリース日: 2016年8月13日

  • 不具合修正: bcn_breadcrumb_trail::find_type() で、固定ページを投稿と同列に扱う処理が、固定ページのパンくずリストに対する投稿ルートの誤った取り込みを引き起こしてしまう問題を修正。

5.5.0

リリース日: 2016年8月12日

  • 挙動変更: すべての投稿タイプについて、投稿階層における親投稿を扱う内的機構を、タクソノミータイプの ‘page’ の使用から ‘BCN_POST_PARENT’ の使用へと変更。
  • 挙動変更: すべての投稿タイプについて、投稿階層における日時階層を扱う内的機構を、タクソノミータイプの ‘date’ の使用から ‘BCN_DATE’ の使用へと変更。
  • 挙動変更: bcn_breadcrumb_trail::pick_post_term() のタクソノミーターム階層の選択ロジックを修正。 get_the_terms() で、先頭の階層の最も深い子タームを選択するよう変更。従来は単に先頭の子タームを選択していた。
  • 新機能: 投稿のパンくずリストについて(すべての投稿タイプについて)タクソノミー選択にリファラーの考慮を加味することを可能とした。
  • 新機能: パンくずテンプレートで使える属性に translatelang を追加。
  • 新機能: パンくずテンプレートの img タグで使える属性に srcsetsizes を追加。
  • 新機能: パンくずテンプレートの meta タグに使える属性として itemprop を追加。
  • 不具合修正: $post グローバルを書き換える他のプラグイン・テーマに起因する諸問題を修正。
  • 不具合修正: WPML 拡張で、投稿タイプ「投稿」のルートページをルートとして使わないようなカスタム投稿タイプができてしまいかねない問題を修正。

5.4.0

リリース日: 2016年3月15日

  • 挙動変更: adminKit の新バージョンへ移行。従来 admin クラスにあったファンクションのいくつかは上位側で処理されるように変わる。
  • 新機能: bcn_breadcrumb_trail::post_terms()bcn_post_terms フィルターを追加。単一の投稿に対してフラットなタームが複数関連づけられている場合の処理を制御できる。
  • 新機能: bcn_breadcrumb_trail::maybe_add_post_type_arg()bcn_add_post_type_arg フィルターを追加。post_type 引数がアーカイブの URL に追加されている場合の処理を制御できる。
  • 新機能: bcn_breadcrumb_trail::post_hierarchy()bcn_pick_post_term フィルターを追加。 Breadcrumb NavXT のデフォルトのターム選択挙動をオーバーライドすることが可能。
  • 不具合修正: 設定ページのタイトルに翻訳できていないものがあったのを修正。
  • 不具合修正: bcn_adminbcn_network_admin の些末な差違をクリーンアップ。
  • 不具合修正: 初期インストールなのに「設定がこのプラグインの古いバージョン向けになっており、移行が必要」という旨のメッセージが表示されてしまう問題を修正。
  • 不具合修正: 分割ページパンくずに関する文言をより明瞭な表現に修正。
  • 不具合修正: bcn_breadcrumb_trail::do_archive_by_date() で、日付フォーマット文字列(年を示すYや月を示すFなど)を各言語別に調整できるよう修正。
  • 不具合修正: bcn_breadcrumb_trail::is_builtin() で、投稿タイプの指定内容が実際の投稿タイプと異なる場合に PHP のワーニングが出ることがあるという問題を修正。
  • 不具合修正: WP_Widget が利用できない場合に PHP のエラーが起こることがある問題を修正。

5.3.1

リリース日: 2015年12月14日

  • 不具合修正: WordPress 4.4における設定画面メインコンテンツの配置に関する問題を修正。
  • 不具合修正: アップグレード時に設定値が再構成されないオプション群に起因するエラーを修正。
  • 不具合修正: post_type クエリー変数が配列である場合にbcn_breadcrumb_trail::get_type_string_query_var()が配列を返すことに起因する PHP エラーを修正。

5.3.0

リリース日: 2015年11月12日

  • 挙動変更: CPT向けのルートページデフォルト設定処理を廃止。
  • 挙動変更: CPTルートページが設定されている場合、当該CPTアーカイブページに対するパンくず挿入を回避するよう変更。.
  • 挙動変更: BCN_SETTINGS_* グローバルが定義されていない場合、従来、デフォルト解釈として BCN_SETTINGS_USE_NETWORK が設定されたものとみなしていたが、 BCN_SETTINGS_USE_LOCAL が設定されたものとみなすよう変更。
  • 挙動変更: 同梱のパンくずリストウィジェットにて、(非推奨となった Google Breadcrumbs フォーマットのパンくずリストではなく) RDFA スタイルの、Schema.org BreadcrumbList フォーマットのパンくずリストのサポートを導入。
  • 挙動変更: パンくずテンプレートのデフォルト設定内容を、(非推奨となった Google Breadcrumbs フォーマットでなはく) RDFA スタイルの、 Schema.org BreadcrumbList フォーマットに準拠。
  • 新機能: bcn_widget_display_trail アクションを追加。同梱のパンくずリストウィジェットの機能拡張が可能。
  • 新機能: bcn_widget_display_types アクションを追加。同梱のパンくずリストウィジェットの拡張が可能。
  • 新機能: アンインストーラーのリファクタリングを実施( PHP5.2 でのアンインストールサポートを含む)。
  • 新機能: bcn_breadcrumb の、非推奨機能を除く全機能についてユニットテストを追加。
  • 新機能: アンインストーラーについてユニットテストを追加。
  • 新機能: CPTについて日付ベースの階層化が可能。
  • 新機能: 特定CPTに限定した日付アーカイブのサポートを導入。
  • 新機能: 特定CPTに限定したタクソノミーアーカイブのサポートを導入。
  • 不具合修正: マルチバイトサプリカント関数は、WordPress の版ごとに異なるサブセットを持ち得るため、常に同じセットがインクルードされるとは限らない、という点に起因する問題を修正。.
  • 不具合修正: 投稿タイプのアーカイブでアーカイブパンくずが二重に現れる問題を修正。

5.2.2

リリース日: 2015年6月1日

  • 不具合修正: 現在の項目が、設定画面のパンくずテンプレートではなく組み込みのデフォルトテンプレートを使用している場合に発生する問題を修正。
  • 不具合修正: プラグインに同梱する翻訳のセットについて、翻訳率90%以上を保証すべく見直しを実施。
  • 不具合修正: BCN_SETTINGS_USE_NETWORK が定義されている場合に PHP のワーニングが表示される問題を修正。

5.2.1

リリース日: 2015年5月25日

  • 不具合修正: URLやテンプレートが空欄かどうかのチェックを bcn_breadcrumb に追加。空欄の場合に生じる種々の不具合を回避するため。
  • 不具合修正: “Pretty” パーマリンクサポートの問題に対処すべく、検索パンくずの URL 構築処理を get_search_link() による処理方法に変更。
  • 不具合修正: まだ投稿と関連付けらていないメディア(添付ファイル)に対して誤ったパンくずリストを生成する問題を修正。
  • 不具合修正: フロントページの添付ファイルで PHP のワーニングが発生する問題を修正。
  • 不具合修正: フロントページの添付ファイルでホームページパンくずが重複する問題を修正。
  • 不具合修正: 複数ページに関連付けられている添付ファイルで本来のページと異なるページのパンくずを生成してしまう問題を修正。
  • 不具合修正: プラグインヘッダーのテキストドメイン/ドメインパスに関する問題を修正。

5.2.0

リリース日: 2015年1月9日

  • 非推奨化: 設定画面の「タイトル文字数の上限」によるパンくずタイトル長制限を非推奨とし、 代わりにCSSを使って文字数制限を実現する方法を提唱。
  • 挙動変更: 投稿階層の設定で「親投稿」が設定されている場合、投稿タイプのアーカイブページを、現在のページに基づいてではなく、最上位の親投稿に基づいて生成するよう変更。
  • 挙動変更: 本バージョン以降、 正常動作には PHP5.3 以上が必要。
  • 新機能: bcn_type_archive_post_type フィルター追加。
  • 新機能: 他の特定の設定項目が有効である場合にのみ意味をなす設定項目について、それら依存する他の設定項目が無効である場合、設定内容が連鎖的に無効となるように変更。
  • 新機能: 設定保存時のメッセージをよりわかりやすい内容に変更(設定に成功したか/設定に失敗したか/そもそも保存すべき設定更新が無かったのか、それらをユーザーに対してよりわかりやすく通知するよう変更)。
  • 不具合修正: 投稿階層に関する設定画面に表示されていたあまりにも難解な文言の数々について多少なりともわかりやすい内容に改善(したつもり)。
  • 不具合修正: 全てのタクソノミー設定が、5.1で追加されたtax_接頭辞を持っている場合、投稿フォーマットに対するデフォルトテンプレートが失われてしまう、という問題を修正。
  • 不具合修正: bbPressとの互換性に関する数多の問題を修正。

5.1.1

リリース日: 2014年7月29日

  • 不具合修正: 「現在の項目にリンク」が有効である場合に、添付ファイルとその親記事が同じリンクを持ってしまう不具合を修正。
  • 不具合修正: ウィジェットタイトルと(pre)テキストフィルターについて、デフォルトの WordPress ウィジェットと同等のパラメーターを渡せるよう修正。
  • 不具合修正: 投稿数ゼロの投稿者の投稿者ページで PHP ワーニングが出る問題を修正。
  • 不具合修正: $post グローバルが WP_Post型で無い場合の悪影響を軽減(WP_DEBUGが有効でない限り、何事も無かったかのように処理を終了するよう修正)。

5.1.0

リリース日: 2014年6月9日

  • 挙動変更: bcn_breadcrumb_trail::do_post() は、今後、正常な状態の WP_Post オブジェクトを渡されることを前提する。
  • 挙動変更: breadcrumb_navxt::version を、当該プラグインのバージョンを示す、オブジェクトのインスタンスを介さずにアクセス可能な定数に変更。
  • 新機能: Google RDFa Breadcrumbs microformat をデフォルトでサポート。
  • 新機能: bcn_opts_update_prebk フィルターを追加。
  • 不具合修正: タブ移動で HTML5 オプションを有効化。
  • 不具合修正: 設定ファイルのインポートでバージョン文字列を正しくパースできない問題を修正。
  • 不具合修正: ‘typeof’ を正しい HTML タグ属性として認識できるよう修正。
  • 不具合修正: 名前の衝突を避けるため、全てのタクソノミーに ‘tax_’ プレフィクスを追加。
  • 不具合修正: bcn_breadcrumb_trail::do_root() で、投稿およびタクソノミーターム要素に、他の箇所の処理と同じようにIDを追加。
  • 不具合修正: bcn_breadcrumb_trail::do_author() が、ある種の状況で、誤ったユーザーを返すことがある問題を修正。
  • 不具合修正: 設定画面の一つのタブで二回保存を行った後に次ページをロードすると、現在のタブではなく一般タブが開かれてしまう問題を修正。
  • 不具合修正: bcn_breadcrumb_template フィルターを bcn_breadcrumb::set_template() へ再追加( 4.4 から 5.0 へ上げる際のレグレッションの修正)。
  • 不具合修正: 同梱のパンくずリストウィジェットで、デフォルト設定に対するチェックを行っていなかったため、ある種の状況でフロントエンドに PHP のワーニングが出ていた問題を修正。
  • 不具合修正: WP_POST::has_archive が文字列のケースについて正しく処理できていなかったため、一部のプラグインの生成したCPTの処理で問題が生じていた件を修正。
  • 不具合修正: CPTのデフォルトタクソノミーが非パブリックなタクソノミーになり得る問題を修正。
  • 不具合修正: 設定画面の添付ファイル関連項目群に「添付ファイル」というタイトルを追加。
  • 不具合修正: 同梱のパンくずリストウィジェットで、タイトルと pre テキストをフィルターするよう修正。

5.0.1

リリース日: 2013年12月31日

  • 挙動変更: マルチサイト環境で、ネットワーク設定と各サイト別の設定との間で、一方が他方を上書きる可能性がある場合にはユーザーへ通知するよう挙動を変更。
  • 不具合修正: タブのスタイルを WordPress 3.8 のルック・アンド・フィールにマッチするものに更新。.
  • 不具合修正: bcn_breadcrumb_trail::display_list() がクラス属性のインスタンスを複数生成する問題を修正。
  • 不具合修正: アンインストーラーに関するいくつかの問題を修正。

5.0.0

リリース日: 2013年11月20日

  • 挙動変更: bcn_breadcrumb_trail::trailbcn_breadcrumb_trail::breadcrumbs へ移動。
  • 挙動変更: マルチサイト環境のネットワーク設定を各サイト別の設定より優先させるよう変更。
  • 新機能: bcn_breadcrumb_trail_object フィルターを追加。
  • 新機能: bcn_li_attributes フィルターを追加。
  • 新機能: bcn_breadcrumb_types フィルターを追加。
  • 新機能: ネットワーク設定画面を追加。
  • 新機能: xmlns:vproperty を正当なタグ属性とみなすよう変更。
  • 不具合修正: 検索結果の現在項目を示すパンくずのリンクが、必要な場合に正しくHTTPSリンクとなるよう修正。