説明

サイト全体で使用されているブロックを検索できます。
WordPress の管理画面に完全に統合されています。
絞り込みを使用して、特定のブロックを使用している投稿を表示できます。
再利用ブロックを使用している投稿を検索できます。
WP CLIを使用して、コマンドラインからブロックをすばやく検索できます。
カスタム WordPress フィルターを使用して Blog Catalog を拡張できます。

GitHubでForkする

はじめに

プラグインを有効化すると、コンテンツのインデックス作成を促すメッセージが表示されます。
サイトで使用されている様々なブロックを表示するには、まずこれを行う必要があります。
管理画面 > ツール > Block Catalog から手動でインデックスを作成することもできます。
または、コマンドラインから wp block-catalog index という WP CLI コマンドを実行して、コンテンツのインデックスを作成することもできます。
インデックスが完了すると、Block Catalog タクソノミーでサイトで使用されている様々なブロックを確認できるようになります。
ブロックエディターの投稿タイプに移動すると、投稿内に存在するブロックのリストも表示されます。
特定のブロックを含む投稿のみが表示されるように一覧を絞り込むこともできます。

スクリーンショット

Block Catalog のインデックス作成ページです。最初にコンテンツをインデックスする必要があります。
プラグインがあなたのサイトで見つけたブロックです。
各投稿のブロックは、投稿一覧ページで確認できます。
このドロップダウンを使用すると、投稿リストを特定のブロックでフィルタリングできます。

FAQ

1) なぜプラグインはインデックスを必要とするのですか?

Block Catalog は、サイト全体で使用されているブロックに関するデータを保存するためにタクソノミーを使用します。このインデックスは、ツール > Block Catalog の画面、または WP CLI wp block-catalog index 経由で構築できます。初期インデックス作成後は、コンテンツの更新があるたびにデータは自動的に同期されます。

2) プラグインに表示される名前が、title ではなく blockName 属性を使用するのはなぜですか？

もしあなたのブロックが、古い register_block_type API を使ってバックエンドで登録されている場合、title 属性が欠落している可能性があります。
新しい register_block_type_from_metadata は、ブロックのタイトルを含む block.json をフロントエンドとバックエンドで共有して使用します。

プラグインが title の欠落を検出した場合、代わりに blockName のサフィックスを使用します。例えば、xyz/custom-block は「カスタムブロック」と表示されます。

この問題に対処するには、カスタムブロックの登録を更新する必要があります。
もしそれが管理できない範囲である場合は、block_catalog_block_title フィルターフックを使用して、こちらにあるようにタイトルを上書きすることもできます。

評価

mixapo 2024年12月10日

Perfectly! What I was looking for.

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

貢献者と開発者

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

“Block Catalog” は1ロケールに翻訳されています。翻訳者のみなさん、翻訳へのご協力ありがとうございます。

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

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

コードを閲覧するか、SVN リポジトリをチェックするか、開発ログを RSS で購読してみてください。

変更履歴

1.6.2 – 2025-02-03

変更: WordPress の検証済みバージョンを 6.7 に更新 (@thrijith, @jeffpaul, @Sidsector9 による貢献、#74, #75 経由)。
セキュリティ: webpack を 5.91.0 から 5.94.0 に更新 (@dependabot, @peterwilsoncc による貢献、#68 経由)。
セキュリティ: serve-static を 1.15.0 から 1.16.2 に、express を 4.19.2 から 4.21.1 に更新 (@dependabot, @Sidsector9 による貢献、#70 経由)。
セキュリティ: cookie を 0.6.0 から 0.7.1 に更新 (@dependabot, @Sidsector9 による貢献、#76 経由)。

1.6.1 – 2024-07-09

変更: サポートレベルを Beta から Stable に更新 (@jeffpaul, @dkotter による貢献、#56 経由)。
変更: WordPress の検証済みバージョンを 6.6 に更新 (@sudip-md, @jeffpaul による貢献、#60 経由)。
変更: WordPress の最小サポートバージョンを 6.4 に更新 (@sudip-md, @jeffpaul による貢献、#60 経由)。
セキュリティ: braces を 3.0.2 から 3.0.3 に更新 (@dependabot, @faisal-alvi による貢献、#58 経由)。
セキュリティ: ws を 7.5.9 から 7.5.10 に更新 (@dependabot, @faisal-alvi による貢献、#58 経由)。

1.6.0 – 2024-05-13

追加: Block Catalog の CSV を生成する WP-CLI コマンド export (@dsawardekar, @psorensen, @Sidsector9 による貢献、#52 経由)。
追加: クラシックエディターブロック検出 (@dsawardekar, @Sidsector9 による貢献、#53 経由)。
変更: WordPress の検証済みバージョンを 6.5 に更新 (@sudip-md, @jeffpaul による貢献、#51 経由)。
変更: WordPress の最小バージョンを 5.7 から 6.3 に更新 (@sudip-md, @jeffpaul による貢献、#51 経由)。
変更: 応答がない、または古くなった issue のクローズを支援するため、lee-dohm/no-response を actions/stale に置き換え (@jeffpaul による貢献、#48 経由)。
セキュリティ: express を 4.18.2 から 4.19.2 に更新 (@dependabot, @Sidsector9 による貢献、#50 経由)。
セキュリティ: follow-redirects を 1.15.5 から 1.15.6 に更新 (@dependabot, @Sidsector9 による貢献、#50 経由)。
セキュリティ: postcss を 7.0.39 から 8.4.33 に更新 (@dependabot, @Sidsector9 による貢献、#50 経由)。
セキュリティ: 10up-toolkit を 5.2.3 から 6.0.1 に更新 (@dependabot, @Sidsector9 による貢献、#50 経由)。
セキュリティ: webpack-dev-middleware を 5.3.3 から 5.3.4 に更新 (@dependabot, @Sidsector9 による貢献、#50 経由)。

1.5.4 – 2024-02-29

追加: WordPress.org プラグインプレビューのサポート (@dkotter, @jeffpaul による貢献、#38 経由)。
変更: 大規模な WordPress インストールでの Block Catalog のリセットパフォーマンスを大幅に向上 (@dsawardekar, @Sidsector9 による貢献、#41 経由)。
変更: NPM 依存関係を整理し、最小 Node バージョンを 20 に更新 (@Sidsector9, @dsawardekar による貢献、#43 経由)。
セキュリティ: tj-actions/changed-files を 39 から 41 に更新 (@dependabot, @peterwilsoncc による貢献、#39 経由)。
セキュリティ: follow-redirects を 1.15.2 から 1.15.4 に更新 (@dependabot, @Sidsector9 による貢献、#40 経由)。

1.5.3 – 2023-11-23

修正: PHP 8.2 の非推奨警告 (@dsawardekar, @ravinderk による貢献、#34 経由)。
追加: PHPUnit 9.x サポート (@dsawardekar, @ravinderk による貢献、#34 経由)。
セキュリティ: sharp を 0.32.3 から 0.32.6 に更新 (@dependabot, @faisal-alvi による貢献、#32 経由)。

1.5.2 – 2023-11-16

変更: WordPress の検証済みバージョンを 6.4 に更新 (@qasumitbagthariya, @jeffpaul による貢献、#28, #29 経由)。

1.5.1 – 2023-10-24

このリリースではベースプラグインファイル名が変更されていますのでご注意ください。そのため、更新後にプラグインを再有効化する必要があるかもしれません。

追加: 標準的な GitHub Action による自動化を追加 (@jeffpaul, @dsawardekar, @dkotter による貢献、#10, #20, #22, #23, #24, #25 経由)。
変更: プラグインの画像アセットを更新 (Brooke Campbell, @jeffpaul, @dsawardekar, @faisal-alvi による貢献、#11, #17 経由)。
変更: メインのプラグインファイル名を更新 (@dkotter, @peterwilsoncc, @dsawardekar による貢献、#18 経由)。
セキュリティ: @babel/traverse を 7.22.8 から 7.23.2 に更新 (@dependabot, @dkotter による貢献、#21 経由)。

1.5.0 – 2023-08-11

追加: ベータ サポートレベル(感謝 @jeffpaul、@dsawardekar による貢献、#3経由)。
追加: WP CLI 経由でのマルチサイトのサポートを追加 (@dsawardekar, @Sidsector9 による貢献、#9 経由)。
修正: block_catalog_taxonomy_options フックでの名前の欠落 (@dsawardekar, @fabiankaegy による貢献、#6 経由)。

過去の変更履歴の詳細はこちら。

説明