Title: Block Catalog
Author: 10up
Published: <strong>2022 年 11 月 25 日</strong>
Last modified: 2025 年 4 月 23 日

---

搜尋外掛

![](https://ps.w.org/block-catalog/assets/banner-772x250.png?rev=2983176)

![](https://ps.w.org/block-catalog/assets/icon.svg?rev=2983176)

# Block Catalog

 由 [10up](https://profiles.wordpress.org/10up/) 開發

[下載](https://downloads.wordpress.org/plugin/block-catalog.1.6.2.zip)

[即時預覽](https://tw.wordpress.org/plugins/block-catalog/?preview=1)

 * [詳細資料](https://tw.wordpress.org/plugins/block-catalog/#description)
 * [使用者評論](https://tw.wordpress.org/plugins/block-catalog/#reviews)
 * [開發資訊](https://tw.wordpress.org/plugins/block-catalog/#developers)

 [技術支援](https://wordpress.org/support/plugin/block-catalog/)

## 外掛說明

 * Find which blocks are used across your site.
 * Fully Integrated with the WordPress Admin.
 * Use filters to see Posts that use a specific block.
 * Find Posts that use Reusable Blocks.
 * Use the WP CLI to quickly find blocks from the command line.
 * Use custom WordPress filters to extend the Block Catalog.

[Fork on GitHub](https://github.com/10up/block-catalog)

### Getting Started

 1. On activation, the plugin will prompt you to index your content. You need to do
    this first before you will be able to see the various blocks used on your site.
    You can also go to _WP-Admin > Tools > Block Catalog_ to do this yourself. Alternately,
    you can run the WP CLI command `wp block-catalog index` to index your content from
    the command line.
 2. Once indexed, you will be able to see the different blocks used on your site in
    the Block Catalog Taxonomy.
 3. Navigating to any Block Editor post type will also show you the list of blocks 
    present in a post.
 4. You can also filter the listing to only show Posts that have a specific block.

## 螢幕擷圖

 * [[
 * The Block Catalog indexing page. You need to index your content first.
 * [[
 * The Blocks found by the plugin on your site.
 * [[
 * The Blocks for each post can be seen on the post listing page.
 * [[
 * You can filter the post listing to a specific Block using this dropdown.

## 常見問題集

### 1) Why does the Plugin require indexing?

Block Catalog uses a taxonomy to store the data about blocks used across a site.
The plugin can build this index via the Tools > Block Catalog screen or via the 
WP CLI `wp block-catalog index`. After the initial index, the data is automatically
kept in sync after any content updates.

### 2) Why does the name displayed in the plugin use the blockName attribute instead of the title?

If your blocks are registered on the Backend with the old [register_block_type](https://developer.wordpress.org/reference/functions/register_block_type/)
API, you may be missing the `title` attribute. The newer [register_block_type_from_metadata](https://developer.wordpress.org/reference/functions/register_block_type_from_metadata/)
uses the same `block.json` on the FE and BE which includes the Block title.

When the plugin detects such a missing `title`, it uses the `blockName` suffix instead.
eg:- xyz/custom-block will display as Custom Block.

To address this you need to update your custom block registration. If this is outside
your control, you can also use the `block_catalog_block_title` filter hook to [override the title as seen here](https://gist.github.com/dsawardekar/676d0d4c5d7f688351e199fdc54484d6).

## 使用者評論

![](https://secure.gravatar.com/avatar/bb31e6aa68e822ea668f571d8e3a1cce77b8b002f1dd288bf0364e08eefbbe1c?
s=60&d=retro&r=g)

### 󠀁[Perfectly](https://wordpress.org/support/topic/perfectly-40/)󠁿

 [mixapo](https://profiles.wordpress.org/mixapo/) 2024 年 12 月 10 日

Perfectly! What I was looking for.

 [ 閱讀全部 1 則使用者評論 ](https://wordpress.org/support/plugin/block-catalog/reviews/)

## 參與者及開發者

以下人員參與了開源軟體〈Block Catalog〉的開發相關工作。

參與者

 *   [ 10up ](https://profiles.wordpress.org/10up/)
 *   [ Darshan Sawardekar ](https://profiles.wordpress.org/dsawardekar/)
 *   [ Darin Kotter ](https://profiles.wordpress.org/dkotter/)
 *   [ Jeffrey Paul ](https://profiles.wordpress.org/jeffpaul/)

〈Block Catalog〉外掛目前已有 1 個本地化語言版本。 感謝[全部譯者](https://translate.wordpress.org/projects/wp-plugins/block-catalog/contributors)
為這個外掛做出的貢獻。

[將〈Block Catalog〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/block-catalog)

### 對開發相關資訊感興趣？

任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/block-catalog/)、
查看 [SVN 存放庫](https://plugins.svn.wordpress.org/block-catalog/)，或透過 [RSS](https://plugins.trac.wordpress.org/log/block-catalog/?limit=100&mode=stop_on_copy&format=rss)
訂閱[開發記錄](https://plugins.trac.wordpress.org/log/block-catalog/)。

## 變更記錄

#### 1.6.2 – 2025-02-03

 * **Changed:** Bump WordPress “tested up to” version 6.7 (props [@thrijith](https://github.com/thrijith),
   [@jeffpaul](https://github.com/jeffpaul), [@Sidsector9](https://github.com/Sidsector9)
   via [#74](https://github.com/10up/block-catalog/pull/74), [#75](https://github.com/10up/block-catalog/pull/75)).
 * **Security:** Bump `webpack` from 5.91.0 to 5.94.0 (props [@dependabot](https://github.com/apps/dependabot),
   [@peterwilsoncc](https://github.com/peterwilsoncc) via [#68](https://github.com/10up/block-catalog/pull/68)).
 * **Security:** Bump `serve-static` from 1.15.0 to 1.16.2 and `express` from 4.19.2
   to 4.21.1 (props [@dependabot](https://github.com/apps/dependabot), [@Sidsector9](https://github.com/Sidsector9)
   via [#70](https://github.com/10up/block-catalog/pull/70)).
 * **Security:** Bump `cookie` from 0.6.0 to 0.7.1 (props [@dependabot](https://github.com/apps/dependabot),
   [@Sidsector9](https://github.com/Sidsector9) via [#76](https://github.com/10up/block-catalog/pull/76)).

#### 1.6.1 – 2024-07-09

 * **Changed:** Update [Support Level](https://github.com/10up/block-catalog/blob/develop/README.md#support-level)
   from `Beta` to `Stable` (props [@jeffpaul](https://github.com/jeffpaul), [@dkotter](https://github.com/dkotter)
   via [#56](https://github.com/10up/block-catalog/pull/56)).
 * **Changed:** Bump WordPress “tested up to” version 6.6 (props [@sudip-md](https://github.com/sudip-md),
   [@jeffpaul](https://github.com/jeffpaul) via [#60](https://github.com/10up/block-catalog/pull/60)).
 * **Changed:** Bump WordPress minimum supported version to 6.4 (props [@sudip-md](https://github.com/sudip-md),
   [@jeffpaul](https://github.com/jeffpaul) via [#60](https://github.com/10up/block-catalog/pull/60)).
 * **Security:** Bump `braces` from 3.0.2 to 3.0.3 (props [@dependabot](https://github.com/apps/dependabot),
   [@faisal-alvi](https://github.com/faisal-alvi) via [#58](https://github.com/10up/block-catalog/pull/58)).
 * **Security:** Bump `ws` from 7.5.9 to 7.5.10 (props [@dependabot](https://github.com/apps/dependabot),
   [@faisal-alvi](https://github.com/faisal-alvi) via [#58](https://github.com/10up/block-catalog/pull/58)).

#### 1.6.0 – 2024-05-13

 * **Added:** WP-CLI command, `export`, to generate a CSV of the block catalog (
   props [@dsawardekar](https://github.com/dsawardekar), [@psorensen](https://github.com/psorensen),
   [@Sidsector9](https://github.com/Sidsector9) via [#52](https://github.com/10up/block-catalog/pull/52)).
 * **Added:** Classic Editor block detection (props [@dsawardekar](https://github.com/dsawardekar),
   [@Sidsector9](https://github.com/Sidsector9) via [#53](https://github.com/10up/block-catalog/pull/53)).
 * **Changed:** Bump WordPress “tested up to” version 6.5 (props [@sudip-md](https://github.com/sudip-md),
   [@jeffpaul](https://github.com/jeffpaul) via [#51](https://github.com/10up/block-catalog/pull/51)).
 * **Changed:** Bump WordPress minimum from 5.7 to 6.3 (props [@sudip-md](https://github.com/sudip-md),
   [@jeffpaul](https://github.com/jeffpaul) via [#51](https://github.com/10up/block-catalog/pull/51)).
 * **Changed:** Replaced [lee-dohm/no-response](https://github.com/lee-dohm/no-response)
   with [actions/stale](https://github.com/actions/stale) to help with closing no-
   response/stale issues (props [@jeffpaul](https://github.com/jeffpaul) via [#48](https://github.com/10up/block-catalog/pull/48)).
 * **Security:** Bump `express` from 4.18.2 to 4.19.2 (props [@dependabot](https://github.com/apps/dependabot),
   [@Sidsector9](https://github.com/Sidsector9) via [#50](https://github.com/10up/block-catalog/pull/50)).
 * **Security:** Bump `follow-redirects` from 1.15.5 to 1.15.6 (props [@dependabot](https://github.com/apps/dependabot),
   [@Sidsector9](https://github.com/Sidsector9) via [#50](https://github.com/10up/block-catalog/pull/50)).
 * **Security:** Bump `postcss` from 7.0.39 to 8.4.33 (props [@dependabot](https://github.com/apps/dependabot),
   [@Sidsector9](https://github.com/Sidsector9) via [#50](https://github.com/10up/block-catalog/pull/50)).
 * **Security:** Bump `10up-toolkit` from 5.2.3 to 6.0.1 (props [@dependabot](https://github.com/apps/dependabot),
   [@Sidsector9](https://github.com/Sidsector9) via [#50](https://github.com/10up/block-catalog/pull/50)).
 * **Security:** Bump `webpack-dev-middleware` from 5.3.3 to 5.3.4 (props [@dependabot](https://github.com/apps/dependabot),
   [@Sidsector9](https://github.com/Sidsector9) via [#50](https://github.com/10up/block-catalog/pull/50)).

#### 1.5.4 – 2024-02-29

 * **Added:** Support for the WordPress.org plugin preview (props [@dkotter](https://github.com/dkotter),
   [@jeffpaul](https://github.com/jeffpaul) via [#38](https://github.com/10up/block-catalog/pull/38)).
 * **Changed:** Significantly improved performance of block catalog reset on larger
   WordPress installations (props [@dsawardekar](https://github.com/dsawardekar),
   [@Sidsector9](https://github.com/Sidsector9) via [#41](https://github.com/10up/block-catalog/pull/41)).
 * **Changed:** Clean up NPM dependencies and update the minimum node version to
   20 (props [@Sidsector9](https://github.com/Sidsector9), [@dsawardekar](https://github.com/dsawardekar)
   via [#43](https://github.com/10up/block-catalog/pull/43)).
 * **Security:** Bump `tj-actions/changed-files` from 39 to 41 (props [@dependabot](https://github.com/apps/dependabot),
   [@peterwilsoncc](https://github.com/peterwilsoncc) via [#39](https://github.com/10up/block-catalog/pull/39)).
 * **Security:** Bump `follow-redirects` from 1.15.2 to 1.15.4 (props [@dependabot](https://github.com/apps/dependabot),
   [@Sidsector9](https://github.com/Sidsector9) via [#40](https://github.com/10up/block-catalog/pull/40)).

#### 1.5.3 – 2023-11-23

 * **Fixed:** PHP 8.2 deprecation warnings (props [@dsawardekar](https://github.com/dsawardekar),
   [@ravinderk](https://github.com/ravinderk) via [#34](https://github.com/10up/block-catalog/pull/34)).
 * **Added:** PHPUnit 9.x support (props [@dsawardekar](https://github.com/dsawardekar),
   [@ravinderk](https://github.com/ravinderk) via [#34](https://github.com/10up/block-catalog/pull/34)).
 * **Security:** Bump `sharp` from 0.32.3 to 0.32.6 (props [@dependabot](https://github.com/apps/dependabot),
   [@faisal-alvi](https://github.com/faisal-alvi) via [#32](https://github.com/10up/block-catalog/pull/32)).

#### 1.5.2 – 2023-11-16

 * **Changed:** Bump WordPress “tested up to” version to 6.4 (props [@qasumitbagthariya](https://github.com/qasumitbagthariya),
   [@jeffpaul](https://github.com/jeffpaul) via [#28](https://github.com/10up/block-catalog/pull/28),
   [#29](https://github.com/10up/block-catalog/pull/29)).

#### 1.5.1 – 2023-10-24

**Note that this release changes the name of the base plugin file. As such, you’ll
probably need to reactivate the plugin after updating.**

 * **Added:** Add our standard GitHub Action automations (props [@jeffpaul](https://github.com/jeffpaul),
   [@dsawardekar](https://github.com/dsawardekar), [@dkotter](https://github.com/dkotter)
   via [#10](https://github.com/10up/block-catalog/pull/10), [#20](https://github.com/10up/block-catalog/pull/20),
   [#22](https://github.com/10up/block-catalog/pull/22), [#23](https://github.com/10up/block-catalog/pull/23),
   [#24](https://github.com/10up/block-catalog/pull/24), [#25](https://github.com/10up/block-catalog/pull/25)).
 * **Changed:** Update our plugin image assets (props [Brooke Campbell](https://www.linkedin.com/in/brookecampbelldesign/),
   [@jeffpaul](https://github.com/jeffpaul), [@dsawardekar](https://github.com/dsawardekar),
   [@faisal-alvi](https://github.com/faisal-alvi) via [#11](https://github.com/10up/block-catalog/pull/11),
   [#17](https://github.com/10up/block-catalog/pull/17)).
 * **Changed:** Updated the main plugin file name (props [@dkotter](https://github.com/dkotter),
   [@peterwilsoncc](https://github.com/peterwilsoncc), [@dsawardekar](https://github.com/dsawardekar)
   via [#18](https://github.com/10up/block-catalog/pull/18)).
 * **Security:** Bump `@babel/traverse` from 7.22.8 to 7.23.2 (props [@dependabot](https://github.com/apps/dependabot),
   [@dkotter](https://github.com/dkotter) via [#21](https://github.com/10up/block-catalog/pull/21)).

#### 1.5.0 – 2023-08-11

 * **Added:** `Beta` Support Level (props [@jeffpaul](https://github.com/jeffpaul),
   [@dsawardekar](https://github.com/dsawardekar) via [#3](https://github.com/10up/block-catalog/pull/3)).
 * **Added:** Adds support for multisite via WP CLI (props [@dsawardekar](https://github.com/dsawardekar),
   [@Sidsector9](https://github.com/Sidsector9) via [#9](https://github.com/10up/block-catalog/pull/9)).
 * **Fixed:** Missing name in the `block_catalog_taxonomy_options` hook (props [@dsawardekar](https://github.com/dsawardekar),
   [@fabiankaegy](https://github.com/fabiankaegy) via [#6](https://github.com/10up/block-catalog/pull/6)).

[View historical changelog details here](https://github.com/10up/block-catalog/blob/develop/CHANGELOG.md).

## 社群版外掛

這個外掛由社群人員開發及提供技術支援。 [參與這個外掛專案](https://github.com/10up/block-catalog)

## 中繼資料

 *  版本 **1.6.2**
 *  最後更新 **1 年前**
 *  啟用安裝數 **100+**
 *  WordPress 版本需求 ** 6.5 或更新版本 **
 *  已測試相容的 WordPress 版本 **6.8.5**
 *  PHP 版本需求 ** 7.4 或更新版本 **
 *  語言
 * [English (US)](https://wordpress.org/plugins/block-catalog/) 及 [Japanese](https://ja.wordpress.org/plugins/block-catalog/).
 *  [將這個外掛本地化為你的母語版本](https://translate.wordpress.org/projects/wp-plugins/block-catalog)
 * 標籤:
 * [blocks](https://tw.wordpress.org/plugins/tags/blocks/)[custom blocks](https://tw.wordpress.org/plugins/tags/custom-blocks/)
   [developer](https://tw.wordpress.org/plugins/tags/developer/)[gutenberg](https://tw.wordpress.org/plugins/tags/gutenberg/)
 *  [進階檢視](https://tw.wordpress.org/plugins/block-catalog/advanced/)

## 評分

 5 星，滿分為 5 星

 *  [  1 個 5 星使用者評論     ](https://wordpress.org/support/plugin/block-catalog/reviews/?filter=5)
 *  [  0 個 4 星使用者評論     ](https://wordpress.org/support/plugin/block-catalog/reviews/?filter=4)
 *  [  0 個 3 星使用者評論     ](https://wordpress.org/support/plugin/block-catalog/reviews/?filter=3)
 *  [  0 個 2 星使用者評論     ](https://wordpress.org/support/plugin/block-catalog/reviews/?filter=2)
 *  [  0 個 1 星使用者評論     ](https://wordpress.org/support/plugin/block-catalog/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/block-catalog/reviews/#new-post)

[查看全部使用者評論](https://wordpress.org/support/plugin/block-catalog/reviews/)

## 參與者

 *   [ 10up ](https://profiles.wordpress.org/10up/)
 *   [ Darshan Sawardekar ](https://profiles.wordpress.org/dsawardekar/)
 *   [ Darin Kotter ](https://profiles.wordpress.org/dkotter/)
 *   [ Jeffrey Paul ](https://profiles.wordpress.org/jeffpaul/)

## 技術支援

使用者可在技術支援論壇提出意見反應或使用問題。

 [檢視技術支援論壇](https://wordpress.org/support/plugin/block-catalog/)