説明
Breadcrumb NavXT は人気のあった WordPress プラグイン Breadcrumb Navigation XT の後継で、さらなる改善に向け旧版を抜本的に見直してあります。このプラグインは、訪問者に対し現在地へのパスを表示する「パンくずリスト」ナビゲーションをサイトに追加します。追加するパンくずリストは柔軟なカスタマイズが可能で、どのようなサイトのニーズでも満たすことができます。管理画面では各種オプションを簡単に設定できます。テーマ開発者やパワーユーザー向けに、クラスへの直接アクセス手段も提供されています。
PHP要件
Breadcrumb NavXT 7.0 以降では PHP7.0 が必要です
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 翻訳プロジェクトを御参照ください。
スクリーンショット
ブロック
このプラグインは1個のブロックを提供します。
- Breadcrumb Trail Displays a breadcrumb trail
インストール
Breadcrumb NavX は WordPress の管理画面からインストールできます。プラグインをインストールして有効化した後、パンくずリストを表示するには、付属のウィジェットを使用するか、テーマ (または子テーマ) でパンくずリストを呼び出します。パンくずリストの呼び出しについて詳しくは、Calling the Breadcrumb Trail の記事をご覧ください。
パンくずリストをカスタマイズするには、管理インターフェースのオプションのデフォルト値を編集できます。これは、管理パネルの「設定」>「Breadcrumb NavXT」にあります。
詳細は Breadcrumb NavXT’s Documentation >をご覧ください。
評価
貢献者と開発者
変更履歴
7.4.1
リリース日: 2025年01月09日
- バグ修正: 7.4.0で導入された変更により、レガシー・ウィジェットが利用できない課題を修正。
7.4.0
リリース日: 2024年12月30日
- 新機能:
bcn_admin_post_root_argsフィルターを追加。 - バグ修正: 「Breadcrumb Trail」ブロック内の breadcrumb キャッシュを無視するオプションにより、ホームページ上で breadcrumb trail が生成されなかった課題を修正。
- バグ修正: ループ内で生成される breadcrumb trails が、トップページで ホーム breadcrumb を不適切に欠落させていた課題を修正。
- バグ修正: breadcrumb-navxt テキスト・ドメインのロードが早すぎる課題を修正 (WordPress 6.7対応を改善)。
- バグ修正:
get_post()からの予期せぬリターンに対する、bcn_breadcrumb_trail::post_hierarchy()の回復力を改善。 - バグ修正: 「Breadcrumb Trail」ブロックの翻訳文の誤字を修正。
7.3.1
リリース日: 2024年2月9日
- バグ修正:
bcn_display*()関数内で、$force パラメータがbcn_breadcrumb_trail::fill()に渡されなかった課題を修正。 - バグ修正:
adminKit内に存在する、不適切なテキスト・ドメインを修正。 - バグ修正:
$forceパラメータが設定されていない場合、ループ内で breadcrumb trail をコールすると、ホームページ breadcrumb が間違ったテンプレートを使用することになる課題を修正。
7.3.0
リリース日: 2024年2月9日
- 挙動の変更:
bcn_display_json_ld()は、エスケープされていない Unicode 文字を返すようになった。 - 挙動の変更:
bcn_display*()関数内の$forceパラメーターがbcn_breadcrumb_trail::fill()に渡されるようになり、親ページ/リソースの代わりに、現在のループアイテムのループ内で trail を生成できるようになった。 - 新機能: 「Breadcrumb Trail」ブロックを、「Breadcrumb NavXT」ウィジェットと機能互換性を持たせるように、再実装。
- 新機能: 「Breadcrumb Trail」ブロックは、ブロックエディター内での基本的なスタイル設定に対応。
- バグ修正: $outer_template の引数が
breadcrumb_navxt::display()内で欠落するエラーを修正。 - バグ修正: 真偽値の設定が正しくエクスポート/インポートされない課題を修正。
- バグ修正: サードパーティーのコードが WP API を壊すと、
bcn_breadcrumb_trail::maybe_add_post_type_arg()で PHP エラーが発生する課題を修正。 - バグ修正: 作者アーカイブの適切なクエリー・オブジェクト・タイプのチェックを追加。
7.2.0
リリース日: 2023年2月9日
- 挙動の変更: デフォルト以外の値のみをデータベースに保存するように変更されたことに伴い、設定リセットはオプション項目を空白の配列に設定。
- 新機能:
bcn_display_separatorフィルターを追加。 - 新機能: ネットワーク全体の設定がローカル設定を上書きしている場合、各設定ごとにその旨を表示する機能を追加。
- バグ修正: PHP 8.1との互換性を改善。
- バグ修正: WordPress 投稿タイプ配列に、予期せぬエントリーがあった場合に発生する PHP エラーを修正。
- バグ修正: ネットワーク設定ページに、設定ヘルプメニューが表示されるようになった。
- バグ修正: ネットワーク設定ページのインポート/エクスポート/リセットフォームで、「ファイルが見つかりません」エラーが発生する原因を修正。
7.1.0
リリース日: 2022年7月17日
- 挙動の変更: 7.0で変更された設定に対応するため、BCN_SETTINGS_FAVOR_* 定数の動作が変更された。
- 挙動の変更: 追加されるのが遅すぎた CPT が検出された場合、設定ページに警告が表示されるようになった。
- 新機能: bcn_breadcrumb_trail::display_loop() の先頭に実行される、bcn_before_loop フィルターを追加。
- 新機能: JSON 形式の設定のインポートとエクスポートを追加 (従来の XML 設定のインポート/エクスポート・フォーマットの後継)。
- バグ修正: 有効タームを知らないターム・アーカイブが引き起こす、PHP エラーを修正。
- バグ修正: レガシー XML 設定のインポーターおよびエクスポーターにおいて、名前空間の導入に起因する PHP エラーを修正。
- バグ修正: 不適切なデフォルトのオートロード値が使用されないように、オプションのオートロード値を明示的に設定。
7.0.2
リリース日: 2022年1月4日
- 挙動の変更:
Hhome_template、Hhome_template_unlinked、hseparator、hseparator_higher_dimの値をbcn_settings_init経由でオーバーライドできるようにする。 - バグ修正: 設定ページにアクセスしようとすると、「申し訳ありませんが、このページへのアクセスは許可されていません。」メッセージが表示される課題を修正。
7.0.1
リリース日: 2021年12月27日
- 挙動の変更:
bcn_settings_initフィルターを、デフォルト設定値を確立する前に移動。このフィルターは、設定のデフォルト値を変更できなくなった。 - 挙動の変更: CPT を追加するプラグインの大半をカバーする意図で、デフォルトの設定を優先度9000に変更。
- バグ修正: PHP 5.6との互換性の課題を修正。
- バグ修正: page_ 設定の一部の戻り値に起因する、PHP エラーを修正。
- バグ修正:
adminKit::settings_to_optsに渡される配列に、設定項目がない場合に発生する PHP エラーを修正。 - バグ修正:
bcn_allowed_htmlが、(bcn_allowed_htmlをmtekk_adminkit_allowed_htmlにマッピングした) 管理インターフェイス要素をカバーしない課題を修正。
7.0.0
リリース日: 2021年12月17日
- 挙動の変更:
bcn_breadcrumb_trailオブジェクト内では、ターム ID とタクソノミーを渡す代わりに、WP_Term オブジェクトが渡される。 - 挙動の変更: 投稿タイプ引数に、親投稿タイプを使用するようになった。
- 新機能: adminKit 3.0に移行
- 新機能: コア
bcn_breadcrumb_trail objectが多次元トレイルに対応。 - 新機能:
bcn_opts_update_to_saveフィルターを追加。 - バグ修正: PHP 8で PHP の非推奨メッセージが表示される、REST コントローラのパラメータ順序の課題を修正。
- バグ修正: WordPress 5.5以降との互換性向上のため、REST コントローラーのエンドポイント登録を更新。
- バグ修正: WordPress 5.8で「ウィジェット」設定が正しく保存されない、互換性の課題を修正。
- バグ修正: trail を逆順で出力する際の、bcn_display 内のポジションカウント・パラメータに関する課題を修正。
6.6.0
Release date: October, 31st 2020
- Behavior change: Moved to using the post type of the parent post for the type archive rather than that of the current item.
- Bug fix: Fixed error thrown when a site does not have an
administratorrole.
6.5.0
リリース日: 2020年6月12日
- Behavior change: Moved to using the taxonomy of the term rather than passed in taxonomy in various functions. As a consequence, this allows
bcn_pick_post_termto override the taxonomy selection. - Behavior change: Default template for unlinked breadcrumbs now includes breadcrumbList markup.
- New feature: Added new filter
bcn_breadcrumb_linked. - New feature: Introduced new WordPress capability:
bnc_manage_options. - Bug fix: Fixed XML settings exporter so that it no longer creates malformed files that cannot be imported when settings contain special HTML entities.
6.4.0
リリース日: 2019年12月31日
- Behavior change: Attachment post type settings moved to Media, additional post type options made available.
- Behavior change: Privately published parent posts are now, by default, skipped over in breadcrumb trails.
- Behavior change: On single post breadcrumb trails, the hierarchical term code path is now used in cases where only a single term from a non-hierarchical taxonomy is present for the current post.
- New feature: Allow
%link%tag in unlinked breadcrumb templates. - 新機能:
bcn_show_post_privateフィルターを追加。 - New feature: Added
bcn_show_type_term_archivefilter.
6.3.0
Release date: May, 3rd 2019
- New feature: Added Gutenberg block for displaying breadcrumb trails.
- 新機能:
bcn_display_attribute_arrayフィルターを追加。 - New feature: Added
bcn-aria-currenttemplate tag to facilitate WAI-ARIA Breadcrumb support. - Bug Fix: Updated settings page to follow WP core standards for header structure.
- Bug Fix: Updated checkbox in adminKit to eliminate multiple labels to follow WCAG 2.0.
- Bug Fix: Fixed PHP error in circumstances of
bcn_breadcrumb_trail::fill()falling back on treating an unknown item as a taxonomy.
6.2.1
Release date: October, 26th 2018
- Behavior change: Added
spanelement wrapping the breadcrumb title in the default unlinked breadcrumb template. - Bug fix: Fixed issue that caused PHP warnings and “the following settings were not saved” messages for hierarchical CPTs.
6.2.0
Release date: September, 24th 2018
- Behavior change: Cleaned up translations for default templates, simplifying and clarifying the translatable content.
- Behavior change: Default unlinked breadcrumb templates no longer contain Schema.org BreadcrumbList markup.
- Behavior change: Breadcrumb NavXT REST API endpoints are no longer enabled by default.
- New feature: Added
bcn_register_rest_endpointfilter. - New feature: Added
bcn_breadcrumb_assembled_json_ld_arrayfilter. - New feature: Added support for following the post parent hierarchy first then falling back to a secondary hierarchy.
- Bug fix: Fixed issue where on loading the settings page immediately after migrating settings causes PHP warnings on CPT and custom taxonomy settings.
- Bug fix: Fixed issue that caused the settings reset option under the help drop down to not work.
6.1.0
Release date: June, 1st 2018
- Behavior change: Links to generate support requests migrated to the WordPress.org forums.
- New feature: Added support for Schema.org BreadcrumbList (microdata format) in the included widget.
- New feature: Added new Root Page support for author archives.
- New feature: Added REST API endpoint for posts, terms, and author archives.
- Bug fix: Corrected label for the Schema.org BreadcrumbList (RDFa format) option in the included widget.
- Bug fix: Fixed issue where a PHP warning would be thrown due to
get_term()returning something other than an instance ofWP_Term.
6.0.4
Release date: January, 26th 2018
- Behavior change: Added auto migration of post type hierarchy settings to
bcn_display*()functions. - Bug fix: Fixed issue where a PHP notice would be generated on the page for posts when the blog breadcrumb display option is set to false.
- Bug fix: Fixed issue where a PHP notice would be generated on archive pages where attachments were included in the
wp_queryresults.
6.0.3
リリース日: 2018年1月1日
- Bug fix: Fixed issue where an improper breadcrumb would be generated in the trail for pages under some circumstances.
- Bug fix: Fixed issue where the post and page roots were not updating to track user changes in Settings > Reading.
6.0.2
Release date: December, 30th 2017
- Behavior change: Added warning alerting that
bcn_breadcrumb::typemust be an array. - Bug fix: Changed Breadcrumb Separator and Paged Template from an input field to a textbox to reduce confusion caused by HTML entities.
- Bug fix: Fixed issue where the parents of a page may not show up in the breadcrumb trail.
- Bug fix: Fixed issue where the
$reverseparameter forbcn_displayandbcn_display_listdid not work properly. - Bug fix: Fixed issue where the
bcn_display_listfunction did not include thelielements.
6.0.1
Release date: December, 28th 2017
- Behavior change: Removed unused Blog Template and Blog Template (Unlinked) from settings page.
- Bug fix: Fixed issue where changes to the hierarchy type for any post type would not save.
- Bug fix: Fixed issue where the blog display setting was ignored.
6.0.0
Release date: December, 26th 2017
- Behavior change:
bcn_breadcrumb_trail::display_list()deprecated in favor of using the$templateparameter inbcn_breadcrumb_trail::display(). - Behavior change:
bcn_breadcrumb_trail::do_attachment()deprecated in favor of callingbcn_breadcrumb_trail::do_post(). - Behavior change:
bcn_breadcrumb_trail::do_front_page()deprecated in favor of callingbcn_breadcrumb_trail::do_home(). - Behavior change:
bcn_li_attributesfilter was deprecated in favor ofbcn_display_attributes. - Behavior change:
bcn_breadcrumb_trail::do_archive_by_date()deprecated in favor of calling bcn_breadcrumb_trail::do_day(),bcn_breadcrumb_trail::do_month(), and/orbcn_breadcrumb_trail::do_year()`. - Behavior change:
bcn_breadcrumb_trail::find_type()deprecated and removed from bcn_breadcrumb_trail. - Behavior change: Breadcrumb for 404 error pages changed to be a child of the front page.
- New feature: Added support for various HTML tags in the widget’s pretext field.
- New feature: Added
bcn_default_hierarchy_displayfilter. - New feature: Added
bcn_default_hierarchy_typefilter. - New feature: Added
$posttype_nameas the third parameter tobcn_show_tax_private. - Bug fix: Fixed UI/UX issue in the settings screen where enabling/disabling settings groups for the Home, Blog, and Mainsite breadcrumb settings did not work.
- Bug fix: Fixed UI/UX issue in the settings screen where not including the paged breadcrumb still allowed the paged breadcrumb template to be edited.
- Bug fix: Removed use of
create_functionin registering the widget as it was deprecated in PHP 7.2.






